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

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

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

注意:根據預設,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

Additional Information

對於 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刪除檔案:

Affected Products

Data Domain

Products

Data Domain
Article Properties
Article Number: 000020437
Article Type: How To
Last Modified: 10 Nov 2025
Version:  7
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.