Web Agent log rotation file names

Products

• CA Single Sign On Agents (SiteMinder)
• CA Single Sign On Federation (SiteMinder)
• CA Single Sign On Secure Proxy Server (SiteMinder)
• SITEMINDER

Issue/Introduction

When the Web Agent is configured to perform log rotation (also referred to as log rollover or log archiving), sometimes the rotated log file names get a numeral appended while at other times a time/date stamp is appended.    What are the criteria that determine which format is appended to the rotated file names?

Environment

All Supported Web Agents, all Platforms.

Cause

The difference is based on whether the log rotates due to size or due to a web server restart.

Resolution

If the log file is rotated due to its size, the rotated file name will be appended with the date/time stamp.  If the log is rotated due to a web server restart, the rotated file name will have a simple numeral appended.

Additional Information

Setting LogAppend=yes in the Agent Configuration Object effectively disables automatic log rotation, even if a value is set for LogFileSize.  Logs must be manually rotated when LogAppend=yes.

This information applies to both the Web Agent error log as well as the Web Agent trace log.  The Log* ACO parameters control error logging while the Trace* ACO parameters control trace logging.  For example, the parameter that controls the size at which trace logs will be rotated is TraceFIleSize.