base DNs, filter strings, and attributes returned can help administrators optimize the directory for its users. These lists are optional because they are computation intensive: specify only the command-line options required (see “Options”).

Some information that is extracted by the logconv.pl script is available only in logs from current releases of Directory Server; the corresponding values will be zero when analyzing logs from older versions. In addition, some information will only be present in the logs if verbose logging is enabled in the Directory Server. For more information, see “nsslapd-accesslog-level (Access log level)”.

The following issues will affect the output and performance of this tool:

•Some data extracted from logs depend on connection and operation numbers that are reset and no longer unique after a server restarts. Therefore, to obtain the most accurate counts, the logs to be analyzed should not span the restart of the Directory Server.

•Due to changes in access log format in current releases of Directory Server that affected operation numbers, the tool will be more accurate logs from current versions when processing large amounts of access logs.

•For performance reasons, it is not recommended to run more than one gigabyte of access logs through the script at any one time.

Syntax

logconv.pl [ -SstartTimestamp ] [ -EendTimestamp ] [ -dmgrDN ] [ -XipAddress ] [ -v ] [ -h ] [ -ssize_limit ] [ -V ] [-efcibaltnxgjuyp ] [ accessLog ]

Options Table 7-26 “logconv.pl options” describes the logconv.pl command-line options.

Table 7-26 logconv.pl options

Option

Description

-dmgrDN

Specifies the distinguished name (DN) of the Directory Manger in the logs being analyzed.

 

This allows the tool to collect statistics for this special user. The mgrDN parameter should

 

be given in double quotes ("") for the shell. When this parameter is omitted, the logconv.pl

 

script will use the default manager DN of the Directory Server, "cn=Directory Manager".

 

 

-EendTimestamp

Specifies the end timestamp; the timestamp must follow the exact format as specified in the

 

access log.

 

 

-h

Displays the usage help text that briefly describes all options.

 

 

-snumber

Specifies the number of items in each of the list options below. The default is 20 when this

 

parameter is omitted. For example, -s 10 -iwill list the ten client machines that access

 

the Directory Server most often. This parameter will apply to all lists that are enabled, and

 

it will have no effect if none are displayed.

 

 

-SstartTimestamp

Specifies the start timestamp; the timestamp must follow the exact format as specified in

 

the access log.

 

 

-v

Displays the version number of the logconv.pl script.

 

 

-V

Enables verbose output. With this option, logconv.pl will compute and display all the

 

optional lists described in Table 7-27 “logconv.pl options to display occurrences”

 

 

-XipAddress

Specifies the IP address of a client to exclude from the statistics. This client will not appear

 

in lists of IP addresses (the i flag), and the connection codes it generates will not be tallied

 

in the total connections (default statistic) nor in the connection code details (the c flag). For

 

example, an administrator may want the server to ignore the effect of a load balancer that

 

connects to the Directory Server at regular intervals. This option may be repeated to exclude

 

multiple IP addresses.

 

 

accessLog

The name of a file that contains the access log of the Directory Server. Wildcards can be

 

used in the file name. It is also possible to specify multiple file names. However, the statistics

 

are computed over the set of all logs, so all logs should pertain to the same Directory Server.

 

The tool ignores any file with the name access.rotationinfo.

 

 

232 Command-line scripts