enable catalog's EEM SDK logging level

Document ID : KB000012823
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

In some diagnosing occasions , you may need to get more logging messages from catalog's EEM SDK  

Question:

how to configure catalog's EEM SDK logging level and where the catalog EEM's SDK log file is located ?

Environment:
catalog 12.7 , 12.8 , 12.9 , 14.1
Answer:

1)  catalog's  EEM SDK log configuration file is eiam.log4j.config   at %USM_HOME%\bin\safex\ on catalog server 

2)  do the following to increase catalog's EEM SDK logging level from default INFO level to TRACE level :

       A.  open %USM_HOME%\bin\safex\eiam.log4j.config 

       B.  update the following section :

         change :

<root>

<priority value="INFO" />

<appender-ref ref="SDK" />

<!-- <appender-ref ref="Console" /> -->

</root>

</log4j:configuration>

 

       To :

 

<root>

<priority value="TRACE" />

<appender-ref ref="SDK" />

<!-- <appender-ref ref="Console" /> -->

</root>

</log4j:configuration>

       

       C.   save it 

 

3)   You may need to increase the catalog EEM SDK log size  so that the EEM SDK log file can have  the logging messages which covers longer time span  as needed :

       A.  open %USM_HOME%\bin\safex\eiam.log4j.config 

       B.  update the following section :

   Change :

 <appender name="SDK" class="com.ca.eiam.log4j.RollingFileAppender">

<!-- The active sdk log file -->

<param name="file" value="eiam.javasdk.log" />

<param name="append" value="true" />

<param name="BufferedIO" value="false"/>

<param name="maxFileSize" value="10000KB" />

<param name="maxBackupIndex" value="1" />

<layout class="com.ca.eiam.log4j.PatternLayout">

<!-- The log message pattern -->

<param name="ConversionPattern" value="%5p %d{ISO8601} [%t] [%c] %m%n"/>

</layout>

</appender>

 

   To :

      <appender name="SDK" class="com.ca.eiam.log4j.RollingFileAppender">

                                <!-- The active sdk log file -->

                                <param name="file" value="eiam.javasdk.log" />

                                <param name="append" value="true" />

                                <param name="BufferedIO" value="false"/>

                                <param name="maxFileSize" value="100000KB" />

                                <param name="maxBackupIndex" value="1" />

                                <layout class="com.ca.eiam.log4j.PatternLayout">

                                                <!-- The log message pattern -->

                                                <param name="ConversionPattern" value="%5p %d{ISO8601} [%t] [%c] %m%n"/>

                                </layout>

                </appender>

 

          C.  Save it 

 

Note :  you don't have to restart catalog server for the change to take effect .  The change is immediate .    The catalog's EEM SDK log file eiam.javasdk.log is located at %USM_HOME%\view\bin\ folder