Data Domain:啟用 DD Boost API 記錄 |Precert 記錄

摘要: 本知識文章說明如何在針對 Boost 和 BoostFS 相關問題進行故障診斷時,啟用 DD Boost 附掛程式記錄。這稱為 precert 記錄。

本文章適用於 本文章不適用於 本文無關於任何特定產品。 本文未識別所有產品版本。

說明

注意:根據預設,DD Boost 附掛程式不會記錄詳細的 API 活動。啟用 precert 紀錄,使用 ddboost_precert.ini 檔案,可讓您進行更深入的診斷。不正確的檔放置、缺少許可權或配置錯誤可能會阻止日誌生成。

啟用 API 層級 (precert) 記錄的原因:

  • DD Boost 或 BoostFS 作業失敗或發生異常行為。
  • 工程或支援部門會要求詳細的 API 層級記錄以進行分析。
  • 儘管預期會有提升活動,但不會產生任何記錄。

一般注意事項:

  • 僅在工程部門或支援部門明確要求時,啟用預先認證記錄。
  • 密切監視磁碟空間;日誌可以快速增長。
  • 確保正確的許可權和檔位置。
  • 移除 .ini 檔以禁用日誌記錄。
  • 必須取消掛接並重新掛接 BoostFS,變更才會生效。

依作業系統區分的檔案位置

作業系統 ddboost_precert.ini 位置 ddboost_precert.log 位置
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
UNIX /ddboost_precert.ini /DDLog/ddboost_precert.log
Windows C:\ddboost_precert.ini C:\DDLog\ddboost_precert.log

適用於 7.0 之前的 BOOST/BoostFS 版本

建立名為 ddboost_precert.ini 在適當的位置 (請參閱上表)。這允許記錄到預設路徑。


適用於 BOOST/BoostFS 7.0 版及更新版本

建立已配置的 ddboost_precert.ini 包含以下內容的檔案:

precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
  • 此配置會建立四個記錄檔,每個記錄檔各 512MB(共 2GB)。
  • num_log_fileslog_file_size 根據需要。
  • 如果磁碟空間有限,可以將日誌重定向到其他位置。

Linux BOOSTFS 用戶端安裝

  1. 建立 /DDLog 目錄:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. 建立 /ddboost_precert.ini 使用上述配置。

  3. 確定 BoostFS 已取消掛接並重新掛接:

    • mount -o log-level=debug <mount_point>

Windows BOOSTFS 用戶端設定

  1. 建立 C:\ddboost_precert.ini 內容如下:
    • precert_enabled=true
      num_log_files=3
      log_file_size=500
      log_file_name=ddboost_precert.log
      log_file_dir=C:\DDLog
      ddcl_logs_include=true
      ddcl_logs_sev=4
  2. 建立 C:\DDLog 並分配完全讀/寫許可權。

  3. 在啟用偵錯記錄的情況下取消掛接再重新掛接 BoostFS。


清除與停用記錄

  1. 刪除 ddboost_precert.ini 檔案中所定義。
  2. 刪除 DDLog 目錄及其內容。
  3. 重新掛接 BoostFS 以套用變更。
  4. 從下列來源收集 BoostFS 記錄: /opt/emc/boostfs/log

其他資訊

對於 7.0 之前的 BOOST/BoostFS 版本,可在下表所示位置建立名為「ddboost_precert.ini」的空白檔案,以啟用預先憑證記錄。這樣做會導致 DD Boost SDK API 將此記錄啟用至下表所示的預設位置和檔案名稱:

此工具僅應在工程或支援團隊要求時啟用,並且由於生成的日誌量,應小心謹慎,以便儘快禁用此日誌記錄。

 

作業系統 檔案位置 ddboost_precert.ini 檔案位置 ddboost_precert.log
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
UNIX /ddboost_precert.ini /DDLog/ddboost_precert.log
Windows C:\ddboost_precert.ini [1] C:\DDLog\ddboost_precert.log


針對 BOOST 和 BoostFS 7.0 及更新版本,「ddboost_precert.ini」檔案需要在與上述相同的位置建立,但不能為空白,需要使用下列內容進行初始化,否則不會導致建立
記錄:precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4



使用上述設置,它將創建4個檔,每個檔512MB,因此總共僅佔用2GB磁碟空間。

如果 4 個 512MB 的檔案未涵蓋故障診斷所需的時間範圍,請使用參數「num_log_files」和「log_file_size」調整檔案數量及其大小。

顯示組態後,系統會在與表格中的相同位置建立記錄,但如果作業系統根分割區不夠大,可以選擇在不同位置建立記錄。

便條:此資料夾需要與 ddboost_precert.ini 檔案位於相同的路徑中(等待更瞭解的人確認,如果這是真的,則無法將日誌寫入通常較小的根以外的某個分區) 


當 .ini 檔案存在時 (對於 7.0 或更新版本,具有適當的內容),/DDLog 資料夾中會產生名為 ddboost_precert.log 的紀錄檔 (如果是配置的路徑)。

由於 所有 API 呼叫都會記錄至檔案,因此ddboost_precert.log可能會快速成長,因此請注意用戶端位置上可用於記錄的空間量,因為這可能會導致分割區填滿,進而導致停機時間,並給客戶帶來不便。

若要停止記錄,移除檔案ddboost_precert.ini 會使已設定檔案的記錄立即停止。
 
ddboost_precert.ini 檔的任何更改都需要卸載 BOOSTFS,然後重新掛載才能使更改生效。
對於使用 ddboost 的其他備份軟體,如果沒有建立紀錄檔來偵測ddboost_precert.ini檔案是否存在,則可能需要重新啟動服務
 
[1]ddboost_precert.ini 檔案必須放在安裝目錄的根目錄下。  它可以被命名為:D:\ 等。  如果將檔案放在其他磁碟機中,且未建立任何記錄檔,請嘗試執行 C:\。

=====================================================================================================

在 Linux BoostFS 伺服器

1 啟用預先認證記錄的步驟。建立目錄 DDLog 作為 /DDLog

2。在 / 路徑上建立包含以下內容
 
的檔案ddboost_precert.iniprecert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

 
3.將以上內容儲存在檔案中 - ddboost_precert.ini

4。確保 /DDLog 目錄具有寫入許可權。提供 /DDLog 目錄內的所有檔案。

a. 變更 DDLog 和 ddboost_precert.ini
的權限 b. 執行「sudo chmod 777 DDLog/ddboost_precert.ini」

5。收集除錯層級的 BoostFS 記錄。

一個。使用選項「-o log-level=debug」
取消掛接再重新掛接 BoostFS 掛接點 b。您也可以更新 /opt/emc/boostfs/etc 目錄內 boostfs.conf 檔案中的記錄層級。您仍然需要取消掛接 BoostFS 磁碟機。
c.在 BoostFS 掛載點上執行備份操作。
d.請提供目錄中的所有檔案 - /opt/emc/boostfs/log


======================================================================================================

啟用 Windows BoostFS 伺服器

1 上的 precert 記錄。在 C: 下建立ddboost_precert.ini:  內容如下的磁碟機:

precert_enabled=true
num_log_files=3
log_file_size=500
log_file_name=ddboost_precert.log
log_file_dir=C:\DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

2.在 C: 磁碟機下建立名稱為 DDLog 的資料夾。將會在此資料夾下建立 precert 記錄檔。請提供 DDLog 目錄的所有讀取/寫入權限,以便建立和附加記錄檔。


便條:
上述組態會建立最多 3 個預先認證記錄檔,每個檔案約 500MB。
不同的值可以用於num_log_files,並根據需要log_file_size。 但是 3 個每個 500MB 的檔應該足以達到目的。
如果用戶端系統上無法提供 1.5 GB 的可用空間,則 log_file_size 的值可減減為 200。
在啟用 precert 記錄之前,請確保用戶端系統上有足夠的可用磁碟空間。

3.使用選項「-o log-level=debug」


取消掛接再重新掛接 BoostFS 掛接點清理活動和停用 precert 記錄

在問題發生後收集預先認證記錄後,請透過下列步驟停用預先認證記錄。  重新掛接 BoostFS SU 前必須完成此動作。
1.從 C: 刪除 DDLog 資料夾及其內容
2.從 C ddboost_precert.ini刪除檔案:



=====================================================================================================使用 ddboost 備份應用程式啟用 Linux 伺服器上的 precert 記錄。

在 Linux DDBOOST 伺服器上啟用 DDBoost Precert 登入的程序:

建立目錄 /DDLog

2。使用下列命令,授予 /DDLog 目錄的所有使用者所有權限:

       $ chmod 777 /DDLog

3.建立包含以下內容的檔案 /ddboost_precert.ini:

       precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

4.Precert 記錄會在 /DDLog 目錄內產生。
=======================================================================================


使用 ddboost 備份應用程式,啟用 Windows Server 上的 precert 記錄。  

1.在 C: 下建立ddboost_precert.ini:  內容如下的磁碟機:

precert_enabled=true
num_log_files=3
log_file_size=500
log_file_name=ddboost_precert.log
log_file_dir=C:\DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

2.在 C: 磁碟機下建立名稱為 DDLog 的資料夾。將會在此資料夾下建立 precert 記錄檔。請提供 DDLog 目錄的所有讀取/寫入權限,以便建立和附加記錄檔。


便條:
上述組態會建立最多 3 個預先認證記錄檔,每個檔案約 500MB。
不同的值可以用於num_log_files,並根據需要log_file_size。 但是 3 個每個 500MB 的檔應該足以達到目的。
如果用戶端系統上無法提供 1.5 GB 的可用空間,則 log_file_size 的值可減減為 200。
在啟用 precert 記錄之前,請確保用戶端系統上有足夠的可用磁碟空間。
 

清理活動和停用 precert 記錄

在問題發生後收集預先憑證記錄後,請透過下列步驟停用預先憑證記錄。
1.從 C: 刪除 DDLog 資料夾及其內容
2.從 C ddboost_precert.ini刪除檔案:

受影響的產品

Data Domain

產品

Data Domain
文章屬性
文章編號: 000020437
文章類型: How To
上次修改時間: 10 11月 2025
版本:  7
向其他 Dell 使用者尋求您問題的答案
支援服務
檢查您的裝置是否在支援服務的涵蓋範圍內。