Sun Java System Directory Server Enterprise Edition 6.1 Administration Guide

Configuring Directory Proxy Server Logs

Directory Proxy Server error logs and access logs can be configured by using the dpconf command or DSCC. For information about how to configure the logs by using DSCC, see the Directory Proxy Server online help. This section describes how to configure Directory Proxy Server logs by using the dpconf command.

You can retrieve a complete list of the configuration options along with the allowed values and default values by running these commands:

$ dpconf help-properties error-log
$ dpconf help-properties access-log

ProcedureTo Configure Directory Proxy Server Access and Error Logs

This procedure configures the Directory Proxy Server access log. To configure the Directory Proxy Server error log, perform the same procedure but replace access with error.

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

  1. View the properties of the access log.

    $ dpconf get-access-log-prop -h host -p port

    The default properties of an access log are as follows:

    default-log-level                :  info
    enable-log-rotation				  :  true
    log-buffer-size                  :  9.8k
    log-file-name                    :  logs/access
    log-file-perm                    :  600
    log-level-client-connections     :  -
    log-level-client-disconnections  :  -
    log-level-client-operations      :  -
    log-level-connection-handlers    :  -
    log-level-data-sources           :  -
    log-level-data-sources-detailed  :  -
    log-min-size						  :  100M
    log-rotation-frequency           :  1h
    log-rotation-policy              :  size
    log-rotation-size                :  100M
    log-rotation-start-day           :  1
    log-rotation-start-time          :  0000
    log-search-filters               :  false
    max-age                          :  unlimited
    max-log-files                    :  10
    max-size                         :  unlimited
    min-free-disk-space-size         :  1M
  2. Change one or more of the properties that are listed in Step 1.

    $ dpconf set-access-log-prop -h host -p port property:value \
     [property:value ...]

    For example, to set the default log level for all message categories to warning, set the value of the default-log-level property to warning.

    $ dpconf set-access-log-prop -h host1 -p 1389 default-log-level:warning

    To disable all logs, irrespective of the log level for each message category, set the value of the default-log-level property to none.

    $ dpconf set-access-log-prop -h host1 -p 1389 default-log-level:none

    To reset a specific log level to the default log level, set that log level property to inherited. For example, to reset the log level for client connections, run the following command:

    $ dpconf set-access-log-prop -h host1 -p 1389 log-level-client-connections:inherited

    For information about properties that can be set by the set-access-log-prop subcommand, type:

    $ dpconf help-properties access-log