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


CAUTION! The log4j.properties file paths specified below are those used by default in the installation.



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