idslogmgmt

Edit online

Use the idslogmgmt command to limit the log file size.

Description

An administrator can use the idslogmgmt command to limit the size of log files. The idslogmgmt command activates every 15 minutes, checks the log files sizes, and moves log files that exceed the maximum log size threshold to an archive file. The number of archived logs can also be limited. The configuration settings are in the ibmslapd.conf file in most cases, except for administrative tools and the idslogmgmt log settings. You can also configure the log management settings by using Web Administration Tool. To use the idslogmgmt command, IBM® Security Verify Directory Integrator must be installed.

You must run the idslogmgmt command by using a system startup script or manually run the command. To run the command, type the following command at a command prompt.
idslogmgmt

To specify the settings for the administrative tools log, idsadm.log, you can set the following environment variables.

  • To set the threshold size, use the IDSADM_SIZE_THRESHOLD variable. The default threshold size is 10 MB. For example: IDSADM_SIZE_THRESHOLD=10.
  • To set the maximum number of archive files, use the IDSADM_ARCHIVES variable. The default value for the maximum number of archive files is 3. For example: IDSADM_ARCHIVES=3.
The archived log files are in the following directories and have the file name timestamp_idsadm.log.
  • UNIX™ path: /var/idsldap/V10.0.2
  • Windows™ path: DS_install_directory\var

To specify the settings for the idslogmgmt tool log, idslogmgmt.log, you can set the following environment variables.

  • To set the threshold size, use the IDSLMG_SIZE_THRESHOLD variable. The default threshold size is 10 MB. For example: IDSLMG_SIZE_THRESHOLD=10.
  • To set the maximum number of archive files, use the IDSLMG_ARCHIVES variable. The default value for the maximum number of archive files is 3. For example: IDSLMG_ARCHIVES=3.
The archived log files are in the following directories and have the file name timestamp_idslogmgmt.log.
  • UNIX path: /var/idsldap/V10.0.2
  • Windows path: DS_install_directory\var

In addition to the main log file, idslogmgmt.log, the other log file that is produced by the IBM Security Verify Directory Integrator tool is ibmdi.log. If the directories are not created, then the additional logs are placed in the current working directory. The ibmdi.log file is overwritten each time the idslogmgmt command is run. As a result, the size of this log file remains small.

Synopsis

The syntax for the idslogmgmt command.

idslogmgmt [–I instancename [-k]] [-t threshold_size  
-a archives -p archive_path] [-?]

Options

The idslogmgmt command takes the following parameters.
-a archives
Specifies the maximum number of archived log files for IBM Security Verify Directory Instance Administration Tool.
-I instance_name
Specifies the instance name for which the command manages the logs. If you specify the -I parameter, then the -t, -a, and -p parameters must not be specified with it.
-k
Stops the Log Management feature for the directory server instance. You must use the -k parameter with the -I parameter.
-p archive_path
Specifies the path where the archived log files of IBM Security Verify Directory Instance Administration Tool is stored.
-t threshold_size
Specifies the threshold size for the log file of IBM Security Verify Directory Instance Administration Tool to trigger archiving.
-?
Specifies to show the help for the command.