CA Embedded Entitlements Manager - Enable elevated logging

book

Article ID: 107028

calendar_today

Updated On:

Products

EMBEDDED ENTITLEMENTS MGR

Issue/Introduction

This is a quick document on how to increase the logging levels for CA Embedded Entitlements Manager server side logs.

Environment

Embedded Entitlements Manager 12.x releases
ETEIAM

Resolution

Stop the igateway service/process.
Open server.xml located here : /EmbeddedEntitlementsManager/config/logger
At the bottom of the file starting approximately on line 118, change <level value="info"/> to <level value="debug"/> for the following loggers
eiam.server.ipoz
eiam.server
eiam.server.performance
eiam.server.ldap --- this is for use when EEM is connected to an external directory server.
If you make a copy of this file before making changes, move the copy outside of the EEM install folder structer. If you leave it in place it will cause problems.
Restart the igateway service/process, and recreate the issue

Once the issue is replicated and the logs (/EmbeddedEntitlementsManager/logs) are collected, restore the debug values to info. If you made a copy of the original, just restore that original file and restart the igateway service/process again. 

A stop and restart of igateway is not required specifically for implementing the debug levels - this is a dynamic change. 
The stop and restart are only required when we are clearing logs to get a fresh set of logs.
So in a production environment where it is not possible to stop and restart, the debug levels will still get updated appropriately.

Additional Information

Never change the root priority level at the end of the file, this overwrites all of the logging and enables everything which will cause massive performance problems. 

Always leave it as:

  <root>
    <priority value="error"/>
    <appender-ref ref="stdout" />
  </root>

Never change the section for 'caldap' directly unless specifically advised by support for very short periods of time.
It should always be left as the following:

  <!-- caldap logger only uses debug and trace level -->
  <!-- changes to caldap logging requires restart of the server -->
  <logger name="caldap" additivity="false">
    <!-- <level value="debug"/> -->
    <appender-ref ref="caldap" />
  </logger>