Data Domain：啟用 DD Boost API 紀錄 - Precert 記錄
Summary: 本文說明如何在針對 Boost 和 BoostFS 相關問題進行故障診斷時，啟用 Data Domain Boost （DD Boost） 附掛程式記錄。這稱為 precert 記錄。
Instructions
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_files和log_file_size根據需要。 - 如果磁碟空間有限，可以將日誌重定向到其他位置。
Linux BOOSTFS 用戶端設定
- 靈活創造
/DDLog目錄。
mkdir /DDLog
chmod 777 /DDLog- 靈活創造
/ddboost_precert.ini使用上述配置。
- 確保 BoostFS 已取消掛接並重新掛接：
mount -o log-level=debug <mount_point>
Windows BOOSTFS 用戶端設定
- 靈活創造
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
- 靈活創造
C:\DDLog並分配完全讀/寫許可權。 - 取消掛接並重新掛接 已啟用除錯記錄的 BoostFS。
清除與停用記錄
- 刪除
ddboost_precert.ini檔案。 - 刪除
DDLog目錄及其內容。 - 重新掛接 BoostFS 以套用變更。
- 從下列來源收集 BoostFS 記錄：
/opt/emc/boostfs/log。
Additional Information
常見問答集 (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 技術支援部門，以進行進一步分析。