配置目录代理服务器日志轮转

默认情况下，在日志文件大小达到 100 MB 时轮转日志文件。默认情况下会保留十个日志文件，超过十个之后，轮转过程将开始覆盖最早的日志文件。本部分介绍如何配置目录代理服务器日志以执行计划的轮转、如何手动轮转日志，以及如何禁用日志轮转。要查看示例配置，请参见日志轮转的示例配置。

配置访问日志和错误日志的定期轮转

此过程用于配置目录代理服务器访问日志。要配置目录代理服务器错误日志，请执行相同的过程，但要将 access 替换为 error。

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. （可选的）查看访问日志的属性。

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

2. （可选的）查看访问日志属性的有效值。

   $ dpconf help-properties access-log

3. 要在日志达到特定大小时轮转日志，请设置以下属性：

   $ dpconf set-access-log-prop -h host -p port \ log-rotation-policy:size log-rotation-size:maximum file size

   如果未指定最大文件大小的单位， 则使用默认单位字节。当日志文件达到定义的大小时，将会轮转日志。文件大小至少为 1 MB，且不能超过 2 GB。

   有关如何按大小轮转日志的示例，请参见根据日志大小轮转日志。

4. 要定期轮转日志，而不考虑日志大小，请设置以下属性：

   $ dpconf set-access-log-prop -h host -p port \ log-rotation-frequency:interval in months, weeks, hours, or minutes \ log-rotation-policy:periodic \ log-rotation-start-day:day in week (1-7) or day in the month (1-31) \ log-rotation-start-time:time of day (hhmm)

   如果将日志配置为在每月的 31 号轮转，但当月少于 31 天，则日志将在下个月的第一天轮转。

   有关如何定期轮转日志的示例，请参见根据时间轮转日志。

5. 要在日志文件足够大时定期轮转日志，请设置 log-rotation-frequency 和 log-min-size 属性。

   $ dpconf set-access-log-prop -h host -p port \ log-rotation-frequency:interval in months, weeks, hours, or minutes \ log-rotation-policy:periodic log-min-size:minimum file size log-rotation-start-day:day in week (1-7) or day in the month (1-31) \ log-rotation-start-time:time of day (hhmm)

   log-min-size 属性表示日志的最小大小。只有日志文件大于指定大小时，才会在计划的时间执行轮转。

   如果将日志配置为在每月的 31 号轮转，但当月少于 31 天，则日志将在下个月的第一天轮转。

   有关如何在文件足够大时定期轮转日志的示例，请参见根据时间和日志大小轮转日志。

手动轮转访问日志文件和错误日志文件

此过程用于轮转目录代理服务器访问日志。要轮转目录代理服务器错误日志，请执行相同的过程，但要将 access 替换为 error。

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. 轮转访问日志。

   $ dpconf rotate-log-now -h host -p port access

禁用访问日志轮转和错误日志轮转

此过程用于禁用目录代理服务器访问日志轮转。要禁用目录代理服务器错误日志轮转，请执行相同的过程，但要将 access 替换为 error。

1. 禁用日志文件轮转。

   $ dpconf set-access-log-prop -h host -p port enable-log-rotation:false

日志轮转的示例配置

有关如何按日志大小和/或时间配置日志轮转的示例。

根据日志大小轮转日志

本部分中的示例说明如何只根据日志大小配置日志轮转。此配置将在日志大小达到 10 MB 时轮转日志，而不考虑上次轮转日志的时间。

$ dpconf set-access-log-prop -h host1 -p 1389 log-rotation-policy:size \
  log-rotation-size:10M

根据时间轮转日志

本部分中的示例说明如何根据上次轮转日志的时间来配置日志轮转，而不考虑日志大小。

• 此配置将在今天 3:00 轮转日志，然后每 8 小时轮转一次，而不考虑日志文件的大小。

  $ dpconf set-access-log-prop -h host1 -p 1389 log-rotation-frequency:8h \ log-rotation-policy:periodic log-rotation-start-time:0300

• 此配置将在每天的 3:00、13:00 和 23:00 轮转日志，而不考虑日志文件的大小。由于 log-rotation-start-time 参数的优先级高于 log-rotation-frequency 参数，因此先在 23:00 轮转日志，然后在间隔 4 小时后再轮转一次。而不是在 23:00 轮转后间隔 10 小时再轮转。

  $ dpconf set-access-log-prop -h host1 -p 1389 log-rotation-frequency:10h \ log-rotation-policy:periodic log-rotation-start-time:0300

• 此配置将在星期一中午轮转日志，然后在每周的同一时间进行轮转，而不考虑日志文件的大小。

  $ dpconf set-access-log-prop -h host1 -p 1389 log-rotation-frequency:1w \ log-rotation-policy:periodic log-rotation-start-day:2 log-rotation-start-time:1200

• 此配置将在星期一中午轮转日志，然后每 3 天轮转一次，而不考虑日志文件的大小。

  $ dpconf set-access-log-prop -h host1 -p 1389 log-rotation-frequency:3d \ log-rotation-policy:periodic log-rotation-start-day:2 log-rotation-start-time:1200

  日志将在以下时间轮转：星期一、星期四、星期日、星期三，依此类推。请注意，log-rotation-start-day 参数仅应用于第一周。日志不会在第二周的星期一轮转。

• 此配置将在当月的 22 号中午轮转日志，然后在每月的同一时间进行轮转，而不考虑日志大小。

  $ dpconf set-access-log-prop -h host1 -p 1389 log-rotation-frequency:1m \ log-rotation-policy:periodic log-rotation-start-day:22 \ log-rotation-start-time:1200

如果将 log-rotation-start-day 设置为 31，而当月仅有 30 天，则日志将在下个月的第一天轮转。如果将 log-rotation-start-day 设置为 31，而当月仅有 28 天（二月），则日志将在下个月的 3 号轮转。

根据时间和日志大小轮转日志

此示例说明如何按指定的时间间隔配置日志轮转（当日志文件足够大时）。

此配置将在每天的 3:00、11:00 和 19:00 轮转日志（当日志文件大小超过 1 MB 时）。如果日志文件大小未超过 1 MB，则不会轮转日志文件。

$ dpconf set-access-log-prop -h host1 -p 1389 log-rotation-frequency:8h \
 log-rotation-policy:periodic log-min-size:1M log-rotation-start-time:0300