How do I enable IBM Content Manager API (CM connector) logging in IBM Content Navigator (ICN)?

Answer

Content Manager API (CM connector) logging in ICN is controlled by the following files:
1. ..navigator.war/WEB-INF/classes/connectors/cmblogconfig.properties
2. ..navigator.war/WEB-INF/classes/ibmcmconfig.roperties

The trace level and detail is controlled by parameters in the cmblogconfig.properties file. To enable logging set the following in it:

- Section 1:
DKLogManagerFactory = com.ibm.mm.sdk.logtool.DKLogManagerFactory_Log4J

- Section 3.2-2
log4j.appender.apiAppender.Append=true
log4j.appender.apiAppender.File=<path>${user.name}.dklog.log
log4j.appender.apiAppender.MaxFileSize=5MB <or other size>
log4j.appender.apiAppender.MaxBackupIndex=5 <or other number>

- Section 3.4-1
DKAPIJavaLogLevel=DEBUG


The API log files (dklog.log files) will be always be located in a cmlog directory, whose location is controlled by the value of IBMCMBASELOGPATH parameter in the ibmcmconfig.properties file mentioned above.

If IBMCMBASELOGPATH is commented out, then the the dklog.log files will be created in a cmlog folder in the directory where the ibmcmconfig.properties is located.

If IBMCMBASELOGPATH is provided with a path value (say F:\\), then the dklog.log files will be created in a cmlog folder in the specified path (F:\\).

In addition, the ibmcmconfig.properties file must also have IBMCMLOGRELATIVEPATH=TRUE.