How to set up the mart server to generate log files.

Description: How to set up the mart server to generate log files (application.log files).

Solution:

1. If using a 32-bit OS version of the mart server, go to C:\Program Files (x86)\erwin\ERwin Mart Server r9\Tomcat\webapps\MartServer\WEB-INF folder and locate the file log4j.xml.

If using a 64-bit OS version of the mart server, go to C:\Program Files\erwin\Mart Server r9\Tomcat64\webapps\MartServer\WEB-INF folder and locate the file log4j.xml.

2. The parameter Priority value specifies the level of logging. You can have that set as “Off”, “Info” , “Error”, or “debug” as below:

Priority value
Specifies the level of logging. The priority value parameter can take the following values:

Off
Specifies that no log is generated.

Info
Specifies that a log is generated for every event.

Error
Specifies that a log is generated when an error occurs.

NOTE: please set the Priority Value as INFO to get the maximum amount of data in the log files.

NOTE 2:  In 2020 R2 version of mart server and later versions the file name to be changed is no longer log4j.xml but is now log4j2.xml

3.  The parameter File Name specifies the path to the application.log file:

To make viewing the log file simpler, please change the directory of the Application.log file by modifying that to instead be:

param name = "File" value = "c:/logs/application.log" 

That directory c:/logs/application.log must also be created on that drive.  

• If your file value = "${user.home}/AppData/Local/CA/ERwin Mart Server/logs/application.log" that will not work.  Please change the value ${user.home} to be an actual directory path as in the example.

4.     Save the file.

5.     Restart the MartServer service.

Figure 1.  Example of an edited log4j.xml file.

NOTES: 

• There can be multiple application.log files that are produced.  The maximum size of the log file is 1 MB.  If the file exceeds the maximum size, another log file is created in the same location. When multiple log files are generated, the file names include the serial number of the file in ascending order.  Please zip up all the files and attach them to your support case.

• Sometimes data is also logged into a file called MartServerUpgrade.log that is kept in the directory C:\Users\username\AppData\Local\ERwin Mart Server\logs.  So it is beneficial to check that file for messages also.  Please attach the file MartServerUpgrade.log to your case also. 

• If the log files are not generating, try the following:

1.     Edit the log4j.xml file and change Priority value from error to info.  

2.     Change the file location from the default directory to c:\logs

3.     Specify an Administrator user on the service

4.     Restart the mart server

Figure 2.  Example of setting a very privileged user account to the mart server service.

More Information:

• CA ERwin Mart Administrator Generate Log Files on the Mart Server Online Help
• Introduction to logging in Tomcat7