Avamar: Služba avtar selže, když skript po spuštění vrátí nenulový ukončovací kód

Summary: Zálohování selže při použití uživatelem definovaného spouštěcího skriptu, protože skript vrátí ukončovací kód 1. Služba avtar považuje jakýkoli nenulový kód za chybu (například "Informace o službě avtar: Vraťte se z režimu run-at-start, ukončovací kód 1"). Opravte skript tak, aby ukončoval 0, abyste problém vyřešili. ...

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

Selhání zálohování při použití skriptu spuštěného při spuštění

Zálohování se nedokončí, pokud je pro službu avtar nakonfigurován vlastní skript spuštění při spuštění.

  • Protokoly Avtar indikují, že byl vrácen ze skriptu spuštění při spuštění s nenulovým ukončovacím kódem.
  • Úlohy zálohování jsou označeny jako neúspěšné.
  • Zakázání skriptu run-at-start umožňuje úspěšné zálohování.
avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

Cause

Chybný ukončovací kód ze spouštěcího skriptu

Zálohování se nezdaří, protože vlastní skript spuštění při spuštění vrátí jiný ukončovací kód než . V prostředích Linux/UNIX je jediná hodnota, která značí úspěch. Služba Avtar interpretuje jakoukoli nenulovou hodnotu jako selhání skriptu, což způsobí přerušení procesu zálohování.

  • Skript vrátil ukončovací kód. který avtar zaznamenané jako chyba.
  • Software Avamar považuje tento nenulový ukončovací kód za selhání a zastaví operaci zálohování.

Příslušná položka protokolu:

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

Resolution

Oprava chyb spouštěcího skriptu avtar

Řešení krok za krokem

Když přizpůsobený skript při spuštění vrátí nenulový ukončovací kód, služba avtar považuje zálohu za neúspěšnou. Postupujte podle těchto kroků a ujistěte se, že se skript vrátí o úspěchu.

  • Vyhledejte skript nakonfigurovaný pro fázi spuštění služby avtar (například /opt/avamar/etc/run_at_start.d/custom_script.sh ).
  • Otevřete skript v editoru a ověřte logiku, která určuje úspěch nebo neúspěch.
  • Na konci skriptu přidejte nebo upravte příkaz exit tak, aby úspěšné spuštění skončilo exit 0 .
  • Zajistěte, aby všechny chybové cesty používaly také vhodné nenulové kódy pouze v případě, že dojde ke skutečnému selhání.
  • Uložte změny a nastavte oprávnění ke spouštění, pokud ještě nejsou nastavena.

Příklad správného ukončení skriptu:

#!/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

 

Místní ověření skriptu

Spusťte skript ručně a potvrďte, že se ukončí pomocí .

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

 

Restartujte službu avtar a spusťte zálohování.

Po potvrzení se skript vrátí 0, restartujte službu AVTAR a spusťte úlohu zálohování, abyste ověřili normální provoz.

# Restart avtar service
$ systemctl restart avtar

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

 

Potvrďte řešení.

Zkontrolujte, zda se v protokolu avtar nezobrazuje chybová zpráva. "Exiting avtar with run‑at‑start script failure 1." Úspěšná položka protokolu vypadá takto:

[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

 

VAROVÁNÍ: Neignorujte nenulové ukončovací kódy; Poukazují na skutečné chyby, které je třeba vyřešit, než budete pokračovat.
VAROVÁNÍ: Nesprávná úprava skriptu spuštění při spuštění může způsobit selhání zálohování pro všechny klienty, kteří používají tuto zásadu. Nejprve otestujte změny v neprodukčním prostředí.
POZNÁMKA: Pokud se vám nedaří skript upravit nebo problém přetrvává i po použití výše uvedených kroků, požádejte o další pomoc podporu společnosti 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.