Avamar: Avtar mislukt wanneer run-at-start-script de afsluitcode non-zero retourneert

Summary: Back-ups mislukken wanneer een door de gebruiker gedefinieerd run-at-start-script wordt gebruikt, omdat het script afsluitcode 1 retourneert. avtar behandelt elke niet-nulcode als een fout (zoals: "avtar Info: Terug van run-at-start, afsluitcode 1"). Corrigeer het script naar afsluiten 0 om op te lossen. ...

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

Back-upfouten bij gebruik van een run-at-start-script

Back-ups worden niet voltooid wanneer een aangepast run-at-start-script is geconfigureerd voor avtar.

  • Avtar-logboeken geven aan dat het is teruggekeerd uit het run-at-start-script met een niet-nul-afsluitcode.
  • Back-uptaken zijn gemarkeerd als mislukt.
  • Als u het run-at-start-script uitschakelt, kan de back-up slagen.
avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

Cause

Onjuiste afsluitcode van Run-at-Start-script

De back-up mislukt omdat het aangepaste script Uitvoeren bij start een andere afsluitcode retourneert dan . In Linux/UNIX-omgevingen, is de enige waarde die succes aangeeft. Avtar interpreteert elke waarde die niet gelijk is aan nul als een scriptfout, waardoor het back-upproces wordt afgebroken.

  • Het script heeft de afsluitcode geretourneerd welke avtar Geregistreerd als een fout.
  • Avamar behandelt deze niet-nul-afsluitcode als een fout en stopt de back-upbewerking.

Relevante logboekvermelding:

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

Resolution

Run-at-start scriptfouten van avtar corrigeren

Stap-voor-stap oplossing

Wanneer een aangepast run-at-start-script een afsluitcode retourneert die niet nul is, behandelt avtar de back-up als mislukt. Volg deze stappen om ervoor te zorgen dat het script terugkeert op succes.

  • Zoek het script dat is geconfigureerd voor de avtar run-at-start-fase (zoals: /opt/avamar/etc/run_at_start.d/custom_script.sh ).
  • Open het script in een editor en controleer de logica die het succes of falen bepaalt.
  • Voeg aan het einde van het script de afsluitinstructie toe of wijzig deze zodat een succesvolle uitvoering eindigt op exit 0 .
  • Zorg ervoor dat eventuele foutpaden ook alleen de juiste niet-nulpuntscodes gebruiken wanneer er een echte fout optreedt.
  • Sla de wijzigingen op en stel uitvoerbare machtigingen in als ze nog niet zijn ingesteld.

Voorbeeld van een correcte beëindiging van het script:

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

 

Het script lokaal valideren

Voer het script handmatig uit en controleer of het wordt afgesloten met .

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

 

Start avtar opnieuw en activeer een back-up.

Na bevestiging dat het script terugkeert 0, start de avtar-service opnieuw op en start een back-uptaak om de normale werking te controleren.

# Restart avtar service
$ systemctl restart avtar

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

 

Bevestig de oplossing.

Controleer het avtar-logboek op afwezigheid van de foutmelding "Exiting avtar with run‑at‑start script failure 1." Een geslaagde logboekvermelding ziet er als volgt uit:

[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

 

LET OP: Negeer niet-nul-uitgangscodes niet; Ze duiden op echte fouten die moeten worden aangepakt voordat verder kan worden gegaan.
LET OP: Als u het run-at-start-script onjuist wijzigt, kan dit back-upfouten veroorzaken voor alle clients die dat beleid gebruiken. Test eerst wijzigingen in een niet-productieomgeving.
OPMERKING: Als u het script niet kunt wijzigen of als het probleem zich blijft voordoen na het uitvoeren van de bovenstaande stappen, neem dan contact op met Dell Support voor aanvullende hulp.

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.