HP-UX Directory Server 8.1 configuration, command, and file reference

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 [ -S startTimestamp ] [ -E endTimestamp ] [ -d mgrDN ] [ -X ipAddress ] [ -v
] [ -h ] [ -s size_limit ] [ -V ] [-efcibaltnxgjuyp ] [ accessLog ]
Options Table 7-26 “logconv.pl options” describes the logconv.pl command-line options.
Table 7-26 logconv.pl options
DescriptionOption
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".
-d mgrDN
Specifies the end timestamp; the timestamp must follow the exact format as specified in the
access log.
-E endTimestamp
Displays the usage help text that briefly describes all options.-h
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 -i will 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.
-s number
Specifies the start timestamp; the timestamp must follow the exact format as specified in
the access log.
-S startTimestamp
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”
-V
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.
-X ipAddress
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.
accessLog
232 Command-line scripts