Data Domain:啟用 DD Boost API 記錄 |Precert 記錄
Summary: 本知識文章說明如何在針對 Boost 和 BoostFS 相關問題進行故障診斷時,啟用 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 /DDLogchmod 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
對於 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 的其他備份軟體,如果沒有建立紀錄檔來偵測ddboost_precert.ini檔案是否存在,則可能需要重新啟動服務
=====================================================================================================
在 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刪除檔案: