KB Article #180123
How to enable DEBUG/TRACE mode for various AIS components (InterPlay, Datastore, Designer, Administration, Reporting, Repository)
For each AIS components, trace level is set on log4j.properties.
The log levels available are: FATAL/ERROR/WARN/INFO/DEBUG/TRACE/ALL
Before modifying log4j.properties, it is recommended to make a backup of it
To confirm log4j.properties path, you need to verify the context xml file of each component, which contain the parameter Log4jFilePath.
The context files of Apache Tomcat can be found in: <install_dir>/AIS/Tools/apache-tomcat/contexts
DESIGNER
- Log4jFilePath location: [install_dir]/AIS/Tools/apache-tomcat/contexts/designer-web.xml
- Log file: <install_dir>/AIS/Tools/apache-tomcat/logs/designer.log
Steps
1. edit the Designer log4j config file (<install_dir>/AIS/Designer/log4j.properties)
- log4j.rootLogger=DEBUG, R
- log4j.category.com.axway.interplay= DEBUG, R
- log4j.category.com.axway.interplay.api= DEBUG, R
- log4j.category.com.axway.interplay.spi.exit= DEBUG, R
2. restart Tomcat
INTERPLAY
- Log4jFilePath location: <install_dir>/AIS/Tools/apache-tomcat/contexts/interplay-web.xml
- Log file: <install_dir>/AIS/Tools/apache-tomcat/logs/interplay.log
Steps
1. edit the Interplay log4j config file <install_dir>/InterPlay/log4j.properties
- log4j.rootLogger= DEBUG, R
- log4j.category.com.axway.interplay= DEBUG, R, D
- log4j.appender.R.Threshold=DEBUG
2. restart Tomcat
DATASTORE CLIENT
- Log4jFilePath location: <install_dir>/AIS/Tools/apache-tomcat/contexts/dsclient-web.xml
- Log file: <install_dir>/AIS/Tools/apache-tomcat/logs/datastoreClient.log
Steps
1. edit the DatastoreClient log4j config file: <install_dir>/Datastore/DatastoreClient/configuration/log4j.properties
- log4j.rootLogger= trace, R
- log4j.logger.com.axway.ds = trace
- log4j.logger.com.axway.ais.dsclient = debug
2. restart Tomcat
DATASTORE AISCLIENT-TOOLS CONSOLE
Log of AISClient Tools (<install_dir>/Datastore/DatastoreClient/extra/aisclient-tools/startConsole.sh)
- Not a web application, no context file
- log file:<install_dir>/Datastore/DatastoreClient/extra/aisclient-tools/log/client-tools.log
Steps
1. edit the aisclient-tools log4j config file <install_dir>/Datastore/DatastoreClient/extra/aisclient-tools/configuration/log4j.properties
- log4j.rootLogger=DEBUG, R, stdout
- log4j.logger.com.axway.ais=DEBUG
2. reinitialize the aisclient-tools console (enter 'exit', if already in progress, and execute startConsole again)
DATASTORE RUNTIME
Log of Datastore Runtime (<install_dir>/Datastore/DatastoreRuntime/dstools.sh)
- Not a web application, no context file
- Log file:<install_dir>/Datastore/DatastoreRuntime/log/datastore.log
Steps
1. edit the dstools log4j config file <install_dir>/Datastore/DatastoreRuntime/configuration/log4j.properties
- log4j.rootLogger=DEBUG, R
- log4j.logger.com.axway.ds = DEBUG
2. restart Tomcat
ADMINISTRATION
- Log4jFilePath location: <install_dir>/AIS/Tools/apache-tomcat/contexts/aisadmin-web.xml
- Log file: <install_dir>/AIS/Tools/apache-tomcat/logs/admin-ui.log
Steps
1. edit the Administration log4j config file <install_dir>/AIS/Administration/log4j.properties
- log4j.rootLogger=DEBUG, R
- log4j.logger.com.axway.ais.adminui=DEBUG
2. restart Tomcat
REPORT
- Log4jFilePath location: <install_dir>/AIS/Tools/apache-tomcat/contexts/report-web.xml
- log file: <install_dir>/AIS/Tools/apache-tomcat/logs/reporting.log
Steps
1. edit the Report log4j config file <install_dir>/AIS/Report/log4j.properties:
- log4j.rootLogger=TRACE, R
- log4j.category.com.axway.ais=TRACE
2. restart Tomcat
REPOSITORY
Log of Repository (<install_dir>/AIS/Repository/startConsole.sh)
- Not a web application, no context file
- Log file: <install_dir>/AIS/Repository/log/config-api.log
Steps
1. edit Repository log4j config file <install_dir>/AIS/Repository/configuration/log4j.properties :
- log4j.rootLogger=DEBUG, R, stdout
- log4j.logger.com.axway.ais=DEBUG
2. reinitialize the Repository console (enter 'exit', if already in progress, and execute startConsole again)
TOMCAT SERVER
- Log file: <install_dir>/AIS/Tools/apache-tomcat/logs/catalina.out
Steps
1. edit catalina logging config file <install_dir>/AIS/Tools/apache-tomcat/conf/logging.properties and add the lines:
- org.apache.catalina.level=finest
- org.apache.catalina.loader.level=INFO
2. restart Tomcat