Avamar:開始時に実行スクリプトがゼロ以外の終了コードを返したときにavtarが失敗する

Summary: ユーザー定義の開始時に実行スクリプトを使用すると、スクリプトが終了コード1を返すため、バックアップが失敗します。avtarは、ゼロ以外のコード(「avtar Info: Back from run-at-start, exit code 1")です。解決するには、スクリプトを exit 0 に修正します。

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.

Symptoms

run-at-startスクリプトを使用するとバックアップが失敗する

カスタムの開始時実行スクリプトがavtar用に構成されている場合、バックアップが完了しません。

  • Avtarログは、ゼロ以外の終了コードでrun-at-startスクリプトから返されたことを示しています。
  • バックアップ ジョブは失敗としてマークされます。
  • run-at-startスクリプトを無効にすると、バックアップは正常に実行されます。
avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

Cause

Run-at-Start スクリプトからの不適切な終了コード

カスタム開始時実行スクリプトが次の終了コード以外のコードを返すため、バックアップが失敗します。 の詳細を確認してください。Linux/UNIX環境では、 は、成功を示す唯一の値です。Avtarはゼロ以外の値をスクリプト障害と解釈して、バックアップ プロセスを中止します。

  • スクリプトが終了コードを返しました どっち avtar エラーとしてログに記録されます。
  • Avamarは、このゼロ以外の終了コードを障害として処理し、バックアップ オペレーションを停止します。

関連するログ エントリー:

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

Resolution

avtar run-at-startスクリプトの失敗の修正

詳細な解決方法

カスタマイズされたrun-at-startスクリプトがゼロ以外の終了コードを返すと、avtarはバックアップを失敗として扱います。次の手順に従って、スクリプトが戻ることを確認します 成功時。

  • avtar run-at-startフェーズ用に構成されたスクリプト( /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

 

スクリプトをローカルで検証する

スクリプトを手動で実行し、次を使用して終了することを確認します。 の詳細を確認してください。

$ /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

 

警告:0 以外の終了コードを無視しません。これらは、続行する前に対処する必要がある真のエラーを示しています。
警告:開始時に実行スクリプトを誤って変更すると、そのポリシーを使用するすべてのクライアントのバックアップが失敗する可能性があります。最初に非運用環境で変更をテストします。
メモ: 上記の手順を適用してもスクリプトを変更できない場合、または問題が解決しない場合は、Dellサポートにお問い合わせください。

Affected Products

Avamar

Products

Avamar Client, Avamar Client for Linux, UNIX, MacOSX
Article Properties
Article Number: 000210566
Article Type: Solution
Last Modified: 23 Oct 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.