Sun Java System Communications Express 6.3 Administration Guide

Log Files

The log information generated by the various system components on their operation can be extremely useful when trying to isolate or troubleshoot a problem.

Table 5–1 Logging Information Maintained by Various Modules in Communications Express

Module/Log Control File 

Parameter 

Default Value 

Description 

Configuration 

   

Logs are maintained in a time-stamped file at /opt/SUNWuwc/install/uwc-config_TIME-STAMP.log

Communications Express 

uwc-deployed-path/WEB-INF/config/uwclogging.properties

uwc.logging.enable

no

Enables or disables logging. 

To enable logging change the property value of uwc.logging.enable to “yes.” For example, uwc.logging.enable=yes

Communications Express 

uwc-deployed-path/WEB-INF/config/uwclogging.properties

uwc.log.file

uwc-deployed-path/logs/uwc.log

For example: 

/var/opt/SUNWuwc/logs/uwc.log

Specifies the location of the log file. 

Change the location of the log file, if required. 

Ensure Web Server can write to this file. 

Communications Express 

uwc-deployed-path/WEB-INF/config/uwclogging.properties

uwc.log.level

INFO

Specifies the log level for the application. 

Change the log level for the application to the desired level. 

The log level values available are: 

WARNING, INFO, and FINE, SEVERE, and FINEST. 

Address Book 

uwc-deployed-path/WEB-INF/config/uwcconfig.properties

log.file

/tmp/trace.log

Specifies the location of the log file. 

Change the location of the log file, if required. 

Ensure Web Server can write into this file. 

Address Book 

uwc-deployed-path/WEB-INF/config/uwcconfig.properties

uwc.log.level

3

Specifies the log level for the application. 

To disable logging for this module, set the value to 0. 

Mail 

   

Refer to Chapter 20, Logging and Log Analysis, of Sun Java System Messaging Server Administration Guide 

Log Rotation

Communications Express creates a single log file whose size is unbounded. You can specify a maximum file size after which a new log file will be created.

ProcedureTo Enable Log Rotation

  1. Set uwc.log.maxsize in megabytes in uwclogging.properties file to specify the maximum log file size.

    The value that uwc.log.maxsize takes is an integer. Communications Express will create a new log file when the current file reaches this size. Default value is none, which means that the log file size is unbounded.

  2. Specify a maximum count of files to keep on the file system.

    Set uwc.log.maxfiles in uwclogging.propertiesfile to specify maximum number of log files to retain when rollover is enabled. The default value is 5. The log file names created would be uwc.log.0, uwc.log.1, uwc.log.2, and so on. After all the log files are exhausted, Communications Express over write the previously created log files starting with uwc.log.0.