1. Security Guide
  2. Security Features
  3. Configuring and Using ACSLS Audit Logs
  4. ACSLS Log Directory

ACSLS Log Directory

The ACSLS log directory is controlled by the LOG_PATH static variable. The default is the $ACS_HOME/log directory. This directory includes these logs:

acsss_event.log

This records messages for significant ACSLS system events, library events, and errors.

When the acsss_event.log reaches a threshold size defined by the LOG_SIZE dynamic variable, it is copied to the event0.log and cleared. During the copy process, the retained event logs are copied into higher numbered retained logs and the highest numbered retained log is overlaid. For example: the event8.log is copied over the event9.log, the event7.log is copied over the event8.log, …, the event0.log is copied over the event1.log, the acsss_event.log is copied over the event0.log, and the acsss_event.log is cleared. This is controlled by the following variables:
  • EVENT_FILE_NUMBER specifies the number of event logs to retain.
  • LOG_SIZE specifies the threshold size at which the event log is copied to a retained event log and truncated.

Use the greplog utility to filter the acsss_event log to include or to exclude messages containing specific keywords. See greplog in the “Utilities” Chapter in the ACSLS Administrator’s Guide for more details.

Configuration Logs

There are two logs that record details when ACSLS updates the library configuration stored in the ACSLS database. Configuration changes from both acsss_config and Dynamic Config (the config utility) are recorded here.
  • acsss_config.log

    Records the details of all configurations or re-configurations of the library(s) that ACSLS supports. The last configuration change is appended to the record of previous configurations.

  • acsss_config_event.log

    Records events during the configuration or re-configuration process.

rpTrail.log

Records the response to all requests to ACSLS from ACSAPI clients or cmd_proc, and all requests to the GUI or the SCSI Client interface to logical libraries except for database queries. The information logged includes the requestor, the request, and the request’s time stamp.

rpTrail.log is managed by the following variables:
  • LM_RP_TRAIL enables this audit trail of ACSLS events. The default is TRUE.
  • RP_TRAIL_LOG_SIZE specifies the threshold size at which the rpTrail.log is compressed and archived.
  • RP_TRAIL_FILE_NUM specifies the number of archived rpTrail logs to retain.
  • RP_TRAIL_DIAG specifies whether the rpTrail messages should include additional diagnostic information. The default is FALSE.

Library Volume Statistics

Records all events affecting volumes (cartridges) in a tape library, including whenever a volume is mounted, dismounted, moved, entered, ejected, or found by audit or Cartridge Recovery. If Library Volume Statistics is enabled, this information is recorded in the acsss_stats.log.

Library Volume Statistics is managed by the following variables:
  • LIB_VOL_STATS enables this Library Volume Statistics. The default is OFF.
  • VOL_STATS_FILE_NUM specifies the number of archived acsss_stats.log files to retain.
  • VOL_STATS_FILE_SIZE specifies the threshold size at which the acsss_stats.log is archived.