Avamar: Avtar misslyckas när run-at-start-skriptet returnerar slutkod som inte är noll

Summary: Säkerhetskopieringar misslyckas när ett användardefinierat kör-vid-start-skript används eftersom skriptet returnerar slutkod 1. avtar behandlar all kod som inte är noll som ett fel (t.ex. "avtar Info: Tillbaka från run-at-start, slutkod 1"). Korrigera skriptet så att 0 avslutas för att lösa problemet. ...

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

Säkerhetskopieringsfel när du använder ett kör-vid-start-skript

Säkerhetskopieringar slutförs inte när ett anpassat kör-vid-start-skript har konfigurerats för avtar.

  • Avtar-loggar anger att det returnerades från run-at-start-skriptet med en slutkod som inte är noll.
  • Säkerhetskopieringsjobb markeras som misslyckade.
  • Om du inaktiverar kör-vid-start-skriptet kan säkerhetskopieringen lyckas.
avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

Cause

Felaktig slutkod från Run-at-Start-skript

Säkerhetskopieringen misslyckas eftersom det anpassade kör-vid-start-skriptet returnerar en annan slutkod än . I Linux/UNIX-miljöer, är det enda värdet som anger framgång. Avtar tolkar alla värden som inte är noll som ett skriptfel, vilket gör att säkerhetskopieringsprocessen avbryts.

  • Skriptet returnerade slutkoden vilken avtar loggas som ett fel.
  • Avamar behandlar den här slutkoden som inte är noll som ett fel och stoppar säkerhetskopieringen.

Relevant loggpost:

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

Resolution

Korrigera avtar run-at-start-skriptfel

Steg-för-steg-lösning

När ett anpassat run-at-start-skript returnerar en slutkod som inte är noll behandlar avtar säkerhetskopieringen som misslyckad. Följ dessa steg för att se till att skriptet returneras på framgång.

  • Leta upp skriptet som konfigurerats för avtar-körning-vid-start-fasen (till exempel /opt/avamar/etc/run_at_start.d/custom_script.sh ).
  • Öppna skriptet i ett redigeringsprogram och kontrollera logiken som avgör om det lyckas eller misslyckas.
  • I slutet av skriptet lägger du till eller ändrar exit-instruktionen så att en lyckad körning slutar med exit 0 .
  • Se till att alla felsökvägar även använder lämpliga koder som inte är noll endast när ett verkligt fel inträffar.
  • Spara ändringarna och ange körbara behörigheter om de inte redan är inställda.

Exempel på en korrekt skriptavslutning:

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

 

Verifiera skriptet lokalt

Kör skriptet manuellt och bekräfta att det avslutas med .

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

 

Starta om avtar och starta en säkerhetskopiering.

När du har bekräftat att skriptet returneras 0, starta om Avtar-tjänsten och starta ett säkerhetskopieringsjobb för att verifiera normal drift.

# Restart avtar service
$ systemctl restart avtar

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

 

Bekräfta lösningen.

Kontrollera att det inte finns något felmeddelande i avtar-loggen "Exiting avtar with run‑at‑start script failure 1." En lyckad loggpost ser ut ungefär så här:

[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

 

VIKTIGT! Ignorera inte slutkoder som inte är noll. De indikerar verkliga fel som måste åtgärdas innan du fortsätter.
VIKTIGT! Om du ändrar run-at-start-skriptet felaktigt kan det orsaka säkerhetskopieringsfel för alla klienter som använder den principen. Testa ändringar i en icke-produktionsmiljö först.
Obs! Om du inte kan ändra skriptet eller om problemet kvarstår efter att du har tillämpat stegen ovan kontaktar du Dells support för ytterligare hjälp.

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.