Backing up Distributed Server Option log files

If you restart the AR System server or reactivate Distributed Server Option logging after deactivating it, each Distributed Server Option server and pool log file is emptied and restarted. By default, a .bak extension is added to the previous log file name to create a backup log file.

The Distributed Server Option Java server does not support appending to the existing log file.

Creating indexed backups of Distributed Server Option Java log files

By default, the maximum size of Java-based Distributed Server Option server and pool log files is 10 MB. To change the maximum, specify a value for one of the following AR System server configuration options:

  • Maximum Log-File Size on the AR System Administrator: Server Information form's Log Files tab.
  • Max-Log-File-Size in the AR System server configuration file

When a Distributed Server Option Java server or pool log file reaches the maximum size, Distributed Server Option backs it up by appending an index number to it and starting a new log file.

For example, the first time the ardist.log file reaches the maximum size, Distributed Server Option changes its file name to ardist.log.1 and then creates an empty ardist.log file. When that version of the ardist.log file reaches the maximum size, Distributed Server Option renames it ardist.log.2, and so on.

To specify the number of indexed backup files to save, use the following option in the AR System server configuration file:

DSO-Log-Max-Backup-Index

For more information, see Configuration-settings-C-D.

When a backup file is created after this maximum is reached, the oldest indexed backup file is deleted.

For example, if you set this option to 3, the following actions occur when a fourth indexed backup is saved:

  • ardist.log.1 (the oldest indexed backup file) is deleted.
  • ardist.log.2 is changed to ardist.log.1.
  • ardist.log.3 is changed to ardist.log.2.
  • The fourth backup is saved as ardist.log.3.

If you do not specify a value for DSO-Log-Max-Backup-Index, 5 indexed backups are saved for each Distributed Server Option Java log file.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*