依預設,記錄檔會在其大小達到 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 線上說明。
此程序會停用目錄代理伺服器存取記錄的自動重建。若要停用目錄代理伺服器錯誤記錄的自動重建,請執行相同的程序,但以 error 取代 access。
如何依記錄大小和/或時間配置記錄自動重建的範例。
本節中的範例顯示如何僅依據記錄大小來配置記錄自動重建。不論上次自動重建記錄的時間為何,此配置會在記錄到達 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 |