Avamar：當「在開始執行」指令檔傳回非零值的結束代碼時，avtar 會失敗

使用開始執行指令檔時的備份失敗

為 avtar 設定自訂的開始執行指令檔時，備份不會完成。

• Avtar 記錄顯示它從開始執行指令檔傳回，並帶有非零的結束代碼。
• 備份工作標示為失敗。
• 停用啟動時執行指令檔可讓備份成功。

avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

從開始執行指令檔的不正確結束代碼

備份失敗，因為自訂的開始執行指令檔傳回的結束代碼 0 。在 Linux/UNIX 環境中， 0 是唯一指示成功的值。Avtar 會將任何非零值解譯為指令檔失敗，導致備份程序中止。

• 指令檔傳回結束代碼 1 何 avtar 記錄為錯誤。
• Avamar 將此非零值結束代碼視為失敗，並停止備份操作。

相關記錄項目：

avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

修正 avtar 開始執行指令檔失敗

逐步解決方案

當自訂的開始執行指令檔傳回非零值的結束代碼時，avtar 會將備份視為失敗。請遵循這些步驟以確保指令檔傳回 0 關於成功。

• 找到為 avtar 在開始執行階段設定的指令檔 （例如， /opt/avamar/etc/run_at_start.d/custom_script.sh ) 的資料儲存應用程式和系統中執行。
• 在編輯器中打開腳本並驗證確定成功或失敗的邏輯。
• 在文稿結束時，添加或修改 exit 語句，以便成功執行以 exit 0 。
• 請確定只有在發生真正的故障時，錯誤路徑也會使用適當的非零代碼。
• 儲存變更並設定可執行權限 （如果尚未設定）。

正確指令檔終止的範例：

#!/bin/bash
# Your custom logic here

if [ $? -eq 0 ]; then
    echo "Custom script completed successfully"
    exit 0
else
    echo "Custom script encountered an error"
    exit 1
fi

在本地驗證文稿

手動執行指令檔，並確認其結束 0 。

$ /opt/avamar/etc/run_at_start.d/custom_script.sh
Custom script completed successfully
$ echo $?
0

重新啟動 avtar 並觸發備份。

確認指令檔傳回後 0，請重新啟動 avtar 服務並開始備份工作，以驗證正常運作。

# Restart avtar service
$ systemctl restart avtar

# Initiate a test backup (replace and as needed)
$ avtar -c -p -b

確認解決方案。

檢查 avtar 記錄是否沒有錯誤訊息 "Exiting avtar with run‑at‑start script failure 1." 成功的紀錄項目類似於以下內容：

[2025-10-09 12:34:56] INFO avtar Info : Back from run-at-start, exit code 0
[2025-10-09 12:35:10] INFO Backup completed successfully