AADS Logging Options

The Host Integrator AADS can log errors and can issue warnings and informational messages as it runs. Messages are divided into two separate message stores: one for recording events that occur within the Authentication Service and a second for events that occur within the Directory Service.

To view the directory log, select the Directory Log under the Directory Services item in the navigation tree, then click the View Log button above the navigation tree. To view the authentication log, select the Authentication Log under the Directory Services item in the navigation tree, then click the View Log button above the navigation tree. Logging information is displayed in the Host Integrator Log Viewer.

To configure Logging Options for either AADS log:

  1. Log on to the Administrative WebStation using an Administrator profile and switch to configure mode.

  2. In the navigation tree under Directory Services, select either the Directory Log or Authentication Log item. The Logging Options panel is displayed for the selected message store.

  3. Configure the options in this panel, and then click Submit or Save. Logging options are described next.

About Logging Options

The options in this panel specify the type of logging that is performed, the location of log files, and time and space limits for log files.

Default Logging Level

The Default Logging Level item specifies which events are inserted into the log files. These messages are also sent to the operating system log if system logging is enabled (see below).

Log Directory

The Log Directory option specifies the directory in which log messages stored. For the directory log, the default is <installation directory>\VHI\etc\aads\dslog (Windows) or <installation directory>/vhi/etc/aads/dslog (UNIX). For the authentication log, the default is <installation directory>\VHI\etc\aads\aalog (Windows) or <installation directory>/vhi/etc/aads/aalog (UNIX). Using this setting an administrator can specify a different local directory where new messages will be stored. The directory you specify must already exist. Any existing messages are transferred to the newly specified location.

System Logging

When System Logging is enabled, Host Integrator sends logging messages to both the Host Integrator log files and the operating system log, which is the Event Log on Windows systems and the syslog daemon on UNIX systems. Host Integrator will also send a message to the System Log when it detects a logging system failure, regardless of this setting.

Note: Host Integrator does not manage the size of the operating system log. When System Logging is enabled, you must take steps to limit the size of your system log.

Log Space Threshold Settings

The Log Space Threshold is the total amount of disk space in MB that can be used to store log records. The default is 100 MB and the range of values is 1 - 100000 MB.

In addition to the space required to store messages, the logging system requires administrative storage space. For proper function of the logging system, ensure that the actual free disk space in the configured logging directory is at least twice the value of the Log Space Threshold setting.

Log Time Threshold Settings

The Log Time Threshold controls the expiration date for all log records. The default is 30 days, and the range of values is 1 - 100000 days. Messages older than the specified threshold will be purged automatically.

Note: The space and time thresholds work together to automatically control the number of messages in the log. Depending on the environment and their configured values, either the time or space constraints may be more restrictive.