idslogmgmt

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® 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/V11.0.1
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/V11.0.1
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 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.

When configuring idslogmgmt, set the IDS_LDAP_TDI_HOME environment variable to the directory where IBM® Verify Directory Integrator is installed.

For example, if IBM Verify Directory Integrator is installed in /opt/IBM/VDI/V11, set the environment variable as export IDS_LDAP_TDI_HOME=/opt/IBM/VDI/V11 and replace /opt/IBM/VDI/V11 with the actual installation directory.

Note: If IDS_LDAP_TDI_HOME is not explicitly set, the wrapper scripts can use a default location. If that does not match the actual installation path, idslogmgmt will fail.

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 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 Verify Directory Instance Administration Tool is stored.
-t threshold_size: Specifies the threshold size for the log file of IBM Verify Directory Instance Administration Tool to trigger archiving.
-?: Specifies to show the help for the command.