Table 7.26. logconv.pl options – Red Hat 8.1 User Manual

Page 227

Advertising
background image

Table 7.26. logconv.pl Options

Option

Description

-d mgrDN

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, logconv.pl will use the
default manager DN of the Directory Server,
"cn=Directory Manager".

-E endTimestamp

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.

-s number

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 startTimestamp

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 of the
optional lists described in

Table 7.27, “logconv.pl

Options to Display Occurrences”

-X ipAddress

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 filename. It is also possible to specify multiple
filenames. 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.

Table 7.27, “logconv.pl Options to Display Occurrences”

describes the options that enable the optional

lists of occurrences. Specify only those required; specifying a large number of options can produce
excessive output and affect execution speed. These parameters can be specified in any number and in
any order, but they must all be given together as a single option on the command line, such as -
abcefg
.

The lists are always output in the order in which they appear in the following table, regardless of the
order in which they are given on the command line.

Red Hat Directory Server 8.1 Configuration and Command Reference

227

Advertising