Modifying log4j configuration file settings

The ACL Analytics Exchange applications that are hosted by the Geronimo application server use a standard logging mechanism called Apache log4j. The configuration settings for each of these application logs can be modified individually. The most common reason to modify the configuration settings is to increase the amount of information written to the log to assist with troubleshooting application errors. The level of logging information can be modified by adjusting the values of the log4j.appender.<logfile_value>.Threshold properties in the file. You can also adjust other values such as the maximum size of the log file, and the location where the log file is created. The following table lists the ACL Analytics Exchange log4j property files that you can configure.

Log configuration file Description

axAdmin-log4j.properties

Specifies the log settings for the AX Server Configuration web application. This configuration file is only found on the AX Server.

The default log file name is axAdmin.log. The default maximum size of the log file is 5MB (5120KB) and the 10 most recent log files will be archived. The default threshold is INFO.

axCore-log4j.properties

Specifies the log settings for AX Server and AX Engine Node.

The default log file name is axCore.log. The default maximum size of the log file is 5MB (5120KB) and the 10 most recent log files will be archived. The default threshold is INFO.

axException-log4j.properties

Specifies the log settings for the AX Exception web application. This configuration file is only found on the server where AX Exception is installed.

axExceptionAdmin-log4j.properties

Specifies the log settings for the AX Exception Administration web application. This configuration file is only found on the server where AX Exception is installed.

axGateway-log4j.properties

Specifies the log settings for AX Web Client. This configuration file is only found on the AX Server.

The default log file name is axGateway.log. The default maximum size of the log file is 5MB (5120KB) and the 10 most recent log files will be archived. The default threshold is INFO.

cas-log4j.properties

Specifies the log settings for AX Server authentication. This configuration file is only found on the AX Server.

The default log file name is cas.log. The default maximum size of the log file is 10MB and the 10 most recent log files will be archived. The default threshold is INFO.

server-log4j.properties

Specifies the log settings for the Geronimo application server.

The default log file name is geronimo.log. The default maximum size of the log file is 10MB and the 10 most recent log files will be archived. The default threshold is INFO.

To modify log4j configuration properties:

  1. Open Windows Explorer and navigate to the geronimo/var/config subfolder for all log 4j files except server-log4j properties. For server-log4j.properties, navigate to the geronimo/var/log subfolder.
  2. Open the property file for the log you want to modify the configuration for in a text editor.
  3. Make any necessary modifications, and then save and close the file.
  4. Stop and restart the ACL Analytics Exchange Geronimo service.


(C) 2015 ACL Services Ltd. All Rights Reserved.