Avamar: Avtar mislykkes, når Run-at-Start-scriptet returnerer en afslutningskode, der ikke er nul

Summary: Sikkerhedskopieringer mislykkes, når der bruges et brugerdefineret run-at-start-script, fordi scriptet returnerer afslutningskode 1. avtar behandler enhver kode, der ikke er nul, som en fejl (f.eks. "avtar Info: Tilbage fra run-at-start, afslutningskode 1"). Ret scriptet til at afslutte 0 for at løse 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

Sikkerhedskopieringsfejl ved brug af et run-at-start-script

Sikkerhedskopieringer fuldføres ikke, når et brugerdefineret run-at-start-script er konfigureret til avtar.

  • Avtar-logfiler angiver, at den er returneret fra run-at-start-scriptet med en udgangskode, der ikke er nul.
  • Sikkerhedskopieringsjob markeres som mislykkede.
  • Deaktivering af run-at-start-scriptet gør det muligt for sikkerhedskopieringen at lykkes.
avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

Cause

Forkert afslutningskode fra Run-at-Start-script

Sikkerhedskopieringen mislykkes, fordi det brugerdefinerede run-at-start-script returnerer en anden afslutningskode end . I Linux/UNIX-miljøer er den eneste værdi, der angiver succes. Avtar fortolker enhver værdi, der ikke er nul, som en scriptfejl, hvilket får sikkerhedskopieringsprocessen til at mislykkes.

  • Scriptet returnerede afslutningskode som avtar logget som en fejl.
  • Avamar behandler denne udgangskode, der ikke er nul, som en fejl og stopper sikkerhedskopieringen.

Relevant logbog:

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

Resolution

Rettelse af scriptfejl i avtar run-at-start

Trinvis opløsning

Når et tilpasset run-at-start-script returnerer en udgangskode, der ikke er nul, behandler avtar sikkerhedskopieringen som mislykket. Følg disse trin for at sikre, at scriptet vender tilbage på succes.

  • Find scriptet, der er konfigureret til avtar-kørselsfasen ved start (f.eks. /opt/avamar/etc/run_at_start.d/custom_script.sh ).
  • Åbn scriptet i en editor, og bekræft den logik, der afgør, om det lykkes eller mislykkes.
  • I slutningen af scriptet skal du tilføje eller ændre afslutningssætningen, så en vellykket udførelse slutter med exit 0 .
  • Sørg for, at eventuelle fejlstier også kun bruger passende ikke-nulkoder, når der opstår en ægte fejl.
  • Gem ændringerne, og angiv eksekverbare tilladelser, hvis de ikke allerede er angivet.

Eksempel på en korrekt scriptafslutning:

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

 

Godkend scriptet lokalt

Kør scriptet manuelt, og bekræft, at det afsluttes med .

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

 

Genstart avtar, og udløs en sikkerhedskopi.

Efter bekræftelse af scriptet vender tilbage 0, genstarte AVTAR-tjenesten og starte et sikkerhedskopieringsjob for at kontrollere normal drift.

# Restart avtar service
$ systemctl restart avtar

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

 

Bekræft løsningen.

Kontroller avtar-loggen for fraværet af fejlmeddelelsen "Exiting avtar with run‑at‑start script failure 1." En fuldført logpost ligner følgende:

[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

 

FORSIGTIG: Ignorer ikke udgangskoder, der ikke er nul; De angiver ægte fejl, der skal løses, før du fortsætter.
FORSIGTIG: Hvis run-at-start-scriptet ændres forkert, kan det medføre sikkerhedskopieringsfejl for alle klienter, der bruger denne politik. Test ændringer i et ikke-produktionsmiljø først.
BEMÆRK: Hvis du ikke kan ændre scriptet, eller problemet fortsætter, når du har udført ovenstående trin, skal du kontakte Dell Support for at få yderligere assistance.

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.