Extensive Log4J documentation is available at http://logging.apache.org/log4j/docs/index.html. As an initial default configuration do the following:
Create a file called log4j.properties with the following content:
log4j.rootLogger=OFF, R log4j.appender.R=org.apache.log4j.RollingFileAppender log4j.appender.R.layout=org.apache.log4j.PatternLayout log4j.logger.rsa.pso.kms=ALL, R log4j.logger.com.rsa.kms=ALL, R # Log file name - Enter full path log4j.appender.R.File=c:\\kms.log # Keep 10 files max of 10MB each maximum log4j.appender.R.MaxFileSize=10MB log4j.appender.R.MaxBackupIndex=10 # Standard logging format, normally, this will be enough log4j.appender.R.layout.ConversionPattern=[%d][%p] %m%n # Show file and line number (extremely slow) #log4j.appender.R.layout.ConversionPattern=[%d][%p] %m (%l)%n # Show thread info, file and line number(extremely slow) #log4j.appender.R.layout.ConversionPattern=[%d][%p][%t] %m (%l)%n |
Note that in this example the log file is created in c:\, ensure that any file path used exists. If you are running KMS on Unix, change the path accordingly.
Under Tomcat:
- Place log4j.properties in the <Tomcat install folder>/common/classes
- If the Jakarta-Tomcat server is currently running then it must be stopped and restarted to pick up the change.
Under Weblogic:
If Key Manager Server is deployed in your own WebLogic domain, enable logging as follows (assume that Key Manager Server configuration files are located in the directory /opt/kms/conf/):
- Copy log4j.properties to /opt/kms/conf/
- Update your Weblogic startup script to export LOG4J_CONFIG_FILE so that WebLogic knows where to find the log4j configuration file. For example, set the following in the environment:
export LOG4J_CONFIG_FILE="/opt/kms/conf/log4j.properties"
Or, add the following to JAVA_OPTIONS
JAVA_OPTIONS="-Dlog4j.configuration=file:/opt/kms/conf/log4j.properties" - If you use WebLogic Node Manager to start your WebLogic Server instance, modify the startup script before running startManagedWebLogic.sh.
- If you use WebLogic Console to start your WebLogic Server instance, add the following under Domain -> Environment -> Servers -> <YourServer> -> Server Start -> Arguments:
-Dlog4j.configuration=file:/opt/kms/conf/log4j.properties