Data Domain:啟用 DD Boost API 紀錄 - Precert 記錄

Résumé: 本文說明如何在針對 Boost 和 BoostFS 相關問題進行故障診斷時,啟用 Data Domain Boost (DD Boost) 附掛程式記錄。這稱為 precert 記錄。

Cet article concerne Cet article ne concerne pas Cet article n’est associé à aucun produit spécifique. Toutes les versions du produit ne sont pas identifiées dans cet 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

  1. 靈活創造 /ddboost_precert.ini 使用上述配置。

 

  1. 確保 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
  1. 靈活創造 C:\DDLog 並分配完全讀/寫許可權。
  2. 取消掛接並重新掛接 已啟用除錯記錄的 BoostFS。

清除與停用記錄

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

Informations supplémentaires

常見問答集 (FAQ)

    問題: 什麼是 DD Boost Precert 記錄?DD Boost Precert Logging 是一種診斷記錄功能,可記錄 DD Boost 用戶端和 Data Domain 系統之間的 DD Boost API 交易。
    答: 它通常用於故障排除性能問題、故障、延遲和通信問題。

    問題: Precert 紀錄會擷取什麼?Precert 紀錄記錄會擷取 DD Boost API 活動,包括讀取作業、寫入作業、備份活動、還原活動、DD Boost 程式庫互動、API 呼叫時間資訊,以及用戶端延遲指示器。
    答: 它提供 DD Boost API 行為的詳細可見度,以便進行故障診斷和效能分析。

    問題: 為什麼沒有產生任何預先認證記錄?確認ddboost_precert.ini檔案存在、位於作業系統根目錄、記錄目錄存在、記錄目錄可寫入,以及已開始新的備份或還原操作。
    答: 缺少組態、位置不正確、權限問題,或缺少新的 DD Boost 活動,都是最常見的原因。

    問題: 啟用預先憑證記錄是否會立即產生記錄?此組態僅啟用記錄功能。
    答: 否,只有在收到新的 DD Boost API 要求時,才會產生記錄檔。

    問題: 為什麼我目前正在執行的備份不會產生 precert 記錄?Precert 記錄僅會擷取在偵測到組態後啟動的應用程式發展介面活動。
    答: 現有的備份或還原工作會繼續,不會產生預先認證記錄。

    問題: 我是否需要重新啟動備份或還原工作?如果啟用日誌記錄時作業已在運行,請啟動新操作。
    答: 是,需要新的備份或還原工作才能產生 precert 記錄。

    問題: 預先認證記錄無法運作的最常見原因是什麼?常見原因包括 ddboost_precert.ini 不在根層級,被意外命名 ddboost_precert.ini.txt、缺少日誌目錄或許可權不足。
    答: 組態與檔案系統問題是最常見的原因。

    問題: ddboost_precert.ini檔應放在何處? 

    Linux: /ddboost_precert.ini. Windows: C:\ddboost_precert.ini.

    答: 檔案必須位於作業系統根目錄中。

    問題: ddboost_precert.ini檔可以存儲在另一個資料夾中嗎?DD Boost 附掛程式僅會檢查作業系統的根目錄。
    答: 否,檔案必須儲存在根目錄。

    問題: 如何驗證檔案實際上不是

    ddboost_precert.ini.txt

    開啟檔案總管,啟用副檔名,並驗證檔案名。
    答: 確保檔案已命名 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    問題: 為什麼 DDLog 啟用紀錄記錄後目錄為空?可能原因包括沒有新的 DD Boost 活動、權限問題,或是未偵測到組態檔案。
    答: 執行新的備份、還原或 DDPCONNCHK 測試以生成活動。

    問題: 什麼是 DDPCONNCHK 為什麼它有用? DDPCONNCHK 是 DD Boost 連線驗證工具。
    答: 它可以產生 DD Boost API 活動,並快速確認預先認證紀錄記錄正常運作。

    問題: 可以 DDPCONNCHK 用來測試我的配置?工程師經常運行 DDPCONNCHK 啟用記錄之後。
    答: 是的,這是在重現問題之前驗證是否正在生成日誌的常用方法。

    問題: 為什麼我的 precert 記錄增長如此迅速?Precert 紀錄記錄會記錄每次 DD Boost API 呼叫。
    答: 大型備份環境可能會在短時間內生成大量日誌卷。

    問題: 我應該分配多少磁碟空間?一個常見的建議是 

    num_log_files=3 and log_file_size=500.

    答: 這在輪換之前提供大約 1.5 GB 的日誌存儲。

    問題: precert 記錄是否可填入檔案系統?如果不進行監控,日誌記錄可能會佔用大量磁碟空間。
    答: 是的,完整的文件系統可能會導致備份失敗、中斷和服務中斷。

    問題: num_log_files的目的是什麼?此參數控制保留的輪換日誌檔數。
    答: 例如, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2

    問題: log_file_size的目的是什麼?此參數定義每個日誌檔的最大大小(以 MB 為單位)。
    答: 例如,log_file_size=500 允許每個檔在旋轉前增長到 500 MB。

    問題: 什麼母鹿s ddcl_logs_include=true 正確做法:此應用程式可在 precert 記錄中啟用 DD Boost 用戶端程式庫記錄資訊。
    答: 建議的設定為 ddcl_logs_include=true.

    問題: 功能 ddcl_logs_sev=4 方法此參數控制日誌記錄嚴重性。
    答: 嚴重性級別 4 提供詳細的故障排除和調試資訊。

    問題: 我需要嗎 BoostFS 除了 precert 記錄之外,還有除錯記錄嗎?並非總是需要額外的日誌記錄。
    答: 對於 BoostFS-specific 問題,同時啟用兩者通常可提供更完整的診斷畫面。

    問題: 對於 BoostFS,我需要卸載並重新裝載嗎?取消掛接再重新掛接會重新初始化 BoostFS 活動。
    答: 在許多情況下,是的,這有助於啟動新的 DD Boost 活動。

    問題: 正確的 BoostFS 調試日誌記錄語法是什麼?正確的語法是 -o log-level=debug
    答: 請勿使用 --o log-level=debug 因為只有一個破折號是有效的。

    問題: 為什麼重新掛接 BoostFS 突然使 precert 記錄出現?重新掛接會為 BoostFS 建立新的初始化週期。
    答: 當新的 DD Boost API 活動發生且外掛程式偵測到組態檔案時,即會開始記錄。

    問題: 重新啟動應用程式是否等同於重新掛接 BoostFS?任何建立新 DD Boost API 活動的動作都可能會觸發記錄。
    答: 通常是的,範例包括 重新開機 RMAN、備份軟體或正在執行 DDPCONNCHK

    問題: 可以 RMAN 是否在不取消掛接 BoostFS 的情況下產生 precert 記錄? RMAN 可直接啟動新的 DD Boost API 要求。
    答: 是,開始新的 RMAN 操作通常就足夠了。

    問題: 我該如何停用預先認證記錄?刪除ddboost_precert.ini或將其重新命名為 ddboost_precert.ini.disabled。
    答: 紀錄記錄僅在確切的檔案名 ddboost_precert.ini 現有

    問題: 移除 ini 檔案後,我是否需要將主機重新開機?附掛程式會在未來的作業中檢查組態檔案。
    答: 否,不需要重新開機。

    問題: 應在 Linux 上使用哪些權限?權限範例包括: 

    mkdir /DDLog, chmod 777 /DDLog, and chmod 777 /ddboost_precert.ini.

    答: DD Boost 程序必須能夠讀取組態檔案,並寫入記錄目錄。

    問題: BoostFS 記錄預設會儲存在何處? 

    Linux: /opt/emc/boostfs/log. Windows: C:\BoostFS\Log.

    答: 這些位置與 DD Boost precert 記錄是分開的。

    問題: BoostFS 記錄和預先認證記錄是一回事嗎?BoostFS 記錄檔包含掛接活動、檔案系統作業和應用程式事件。
    答: 否,precert 記錄包含 DD Boost API 交易、磁帶庫通訊和 I/O 計時資料。

    問題: 我應該向支持人員提供哪些日誌?視問題而定,收集ddboost_precert.log、輪替的 precert 記錄、BoostFS 記錄、 DDPCONNCHK 輸出、應用程式記錄和請求的支援包。
    答: 提供所有相關記錄有助於加速故障診斷。

    問題: 如果在遵循此知識文章後仍未產生記錄,該怎麼辦?收集證據,例如ddboost_precert.ini位置、日誌目錄清單、 DDPCONNCHK 輸出、BoostFS 掛接命令和權限資訊。
    答: 將收集到的資訊提交給 Dell 技術支援部門,以進行進一步分析。

    Produits concernés

    Data Domain

    Produits

    Data Domain
    Propriétés de l’article
    Numéro d’article: 000020437
    Type d’article: How To
    Dernière modification: 21 août 2026
    Version:  9
    Trouvez des réponses à vos questions auprès d’autres utilisateurs Dell
    Services de support
    Vérifiez si votre appareil est couvert par les services de support.