Sun Java System Directory Server Enterprise Edition 6.0 管理指南

配置目錄代理伺服器記錄自動重建

依預設，當記錄檔大小到達 100 MB 時自動重建記錄檔。依預設保留十個記錄檔，超過十個之後，自動重建程序會從最舊的記錄檔開始覆寫。本節說明如何配置目錄代理伺服器記錄以排程自動重建、如何手動自動重建記錄，以及如何停用記錄自動重建。如需配置範例，請參閱記錄自動重建的配置範例。

配置定期自動重建存取與錯誤記錄

本程序配置目錄代理伺服器存取記錄。若要配置目錄代理伺服器錯誤記錄，請執行相同的程序，但以 error 取代 access。

您可以使用 DSCC 執行此作業。如需有關資訊，請參閱目錄服務控制中心介面與 DSCC 線上說明。

(可選擇) 檢視存取記錄的特性。

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

(可選擇) 檢視存取記錄特性的有效值。
```
$ dpconf help-properties access-log
```

若要在記錄到達特定大小時自動重建記錄，請設定下列特性：
$ dpconf set-access-log-prop -h host -p port \ log-rotation-policy:size log-rotation-size:maximum file size
如果未指定最大檔案大小的單位，則使用位元組做為預設單位。當記錄檔到達定義的大小時，即自動重建記錄。檔案大小必須最小為 1 MB，最大不超過 2 GB。

如需有關如何依大小自動重建記錄的範例，請參閱基於記錄大小自動重建記錄。

若要定期自動重建記錄，不論記錄大小為何，都設定下列特性：

$ 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 天，則在次月的第一天自動重建記錄。

如需有關如何定期自動重建記錄的範例，請參閱基於時間自動重建記錄。

若要在記錄檔足夠大時定期自動重建記錄，請設定 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 天，則在次月的第一天自動重建記錄。

如需有關如何在檔案大小足夠大時定期自動重建記錄的範例，請參閱基於時間和記錄大小自動重建記錄。

手動自動重建存取與錯誤記錄檔

本程序自動重建目錄代理伺服器存取記錄。若要自動重建目錄代理伺服器錯誤記錄，請執行相同的程序，但以 error 取代 access。

您可以使用 DSCC 執行此作業。如需有關資訊，請參閱目錄服務控制中心介面與 DSCC 線上說明。

自動重建存取記錄。

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

停用存取與錯誤記錄自動重建

本程序停用目錄代理伺服器存取記錄的自動重建。若要停用目錄代理伺服器錯誤記錄的自動重建，請執行相同的程序，但以 error 取代 access。

停用記錄檔自動重建。

$ 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

此配置在星期一中午自動重建記錄，接著每三天自動重建一次，而不論記錄檔大小為何。
$ 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