Wednesday, September 10, 2008

How can I change the log level in CTS?

How can I change the log level in CTS?
ID: esg44235
Product(s): Document Transformation Services, Media Transformation Services
SOLUTION
By default CTS is set to INFO Level in order to improve the performance.
Please refer to support note 25327 for different levels of logging.
Steps to change the log level:
1. Stop all of the CTS services.
2. Go to log4j.properties file under following folder [DFC HOME]\config which is generally C:\documentum\config
3. To get debug information for CTS framework, update the following CTS appenders to DEBUG from INFO:
FROM:

log4j.category.com.documentum.cts.services=INFO, CTSServicesAppender

log4j.category.com.documentum.impl=INFO, CTSServicesAppender

log4j.category.com.documentum.cts.util=INFO, CTSServicesAppender

log4j.category.com.documentum.cts.util.CTSInstanceInfoUtils=INFO, CTSInstanceInfoAppender

TO:

log4j.category.com.documentum.cts.services=DEBUG, CTSServicesAppender

log4j.category.com.documentum.impl= DEBUG, CTSServicesAppender
log4j.category.com.documentum.cts.util=DEBUG, CTSServicesAppender
log4j.category.com.documentum.cts.util.CTSInstanceInfoUtils=DEBUG, CTSInstanceInfoAppender

4. To troubleshoot Plug-in specific issues you will need to add DEBUG to the plugin appender that you would like to trace. Each Plug-In has their own appender so you will need to set this for each one that you are troubleshooting.
Here are some example plug-ins and their coresponding appenders.

ALTERCAST (MTS)

log4j.category.com.documentum.mp.altercast= DEBUG, AltercastAppender

IMAGE1

log4j.category.com.documentum.cts.plugin.irw=DEBUG, IMAGE1Appender

PDF (DTS5.3 SP4 and abobe)

log4j.category.com.documentum.cts.plugin.advancedpdf=DEBUG, PDFAPPENDER

ADVANCED PDF (RPTS)

log4j.category.com.documentum.cts.plugin.advancedpdf=DEBUG, AdvancedPDFAppender

ACROBAT (DTS 5.3 -5.3 SP2)

log4j.category.com.documentum.cts.plugin.acrobat=INFO, ACROBATAppender

WORD (DTS 5.3)

log4j.category.com.documentum.cts.plugin.word=DEBUG, WORDAppender

PDF Generator (DTS 5.3 SP3 and DTS Legacy)

log4j.category.com.documentum.cts.plugin.pdfgen=DEBUG, PDFGenAppender

AAES (ADTS)

log4j.category.com.documentum.cts.plugin.aaes=DEBUG, AAESAppender

5. By switching on separate logging in log4j.properties file by setting "separatelogging" to true, CTS will create a separate log file per repository. This is only needed for a multiple repository configuration.

com.documentum.separatelogging.enabled=true.

6. Start the CTS service.

The logs will now have a higher degree of verbosity which will assist in troubleshooting.

7. Logs will be created in two places.

a. \logs - This is the default location for logs. If seperate logging is enabled, only non- repository specific information will go here. Like plug-ins loading.

b. \docbases\\config\logs - If seperate logging is enabled, docbase specific logging will be placed here.

NOTE: Log4j is a open source framework for controlling logging. It is a mechansim for controlling verbosity, logging file creation, and log output format. Please refer to the following support note for more information:

http://solutions.emc.com/nsepn/webapps/stqv768481dmts46655278/emcsolutionview.asp"id=esg77976

No comments: