Avamar: Avtar mislykkes når kjør-på-start-skriptet returnerer avslutningskode som ikke er null

Summary: Sikkerhetskopieringer mislykkes når et brukerdefinert kjøre-at-start-skript brukes fordi skriptet returnerer avslutningskode 1. avtar behandler alle ikke-null kode som en feil (for eksempel "avtar Info: Tilbake fra run-at-start, utgangskode 1"). Korriger skriptet for å avslutte 0 for å 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

Feil ved sikkerhetskopiering ved bruk av et kjøre-at-start-skript

Sikkerhetskopieringer fullføres ikke når et egendefinert kjør-på-start-skript er konfigurert for avtar.

  • Avtar-logger indikerer at den returneres fra run-at-start-skriptet med en avslutningskode som ikke er null.
  • Sikkerhetskopieringsjobber merkes som mislykkede.
  • Deaktivering av run-at-start-skriptet gjør at sikkerhetskopieringen kan lykkes.
avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

Cause

Feil avslutningskode fra Run-at-Start-skript

Sikkerhetskopieringen mislykkes fordi det egendefinerte oppstartsskriptet returnerer en annen avslutningskode enn . I Linux-/UNIX-miljøer, er den eneste verdien som indikerer suksess. Avtar tolker alle verdier som ikke er null, som en skriptfeil, noe som fører til at sikkerhetskopieringsprosessen avbrytes.

  • Skriptet returnerte avslutningskode hvilken avtar logget som en feil.
  • Avamar behandler denne avslutningskoden som ikke er null, som en feil og stopper sikkerhetskopieringen.

Relevant loggoppføring:

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

Resolution

Korrigering av avtar run-at-start-skriptfeil

Trinnvis løsning

Når et tilpasset run-at-start-skript returnerer en avslutningskode som ikke er null, behandler avtar sikkerhetskopieringen som mislykket. Følg disse trinnene for å sikre at skriptet kommer tilbake på suksess.

  • Finn skriptet som er konfigurert for avtar-kjøring-at-start-fasen (for eksempel /opt/avamar/etc/run_at_start.d/custom_script.sh ).
  • Åpne skriptet i et redigeringsprogram, og kontroller logikken som avgjør om suksess eller fiasko oppstår.
  • På slutten av skriptet legger du til eller endrer avslutningssetningen slik at en vellykket utførelse slutter med exit 0 .
  • Forsikre deg om at eventuelle feilbaner også bruker riktige koder som ikke er null, bare når det oppstår en ekte feil.
  • Lagre endringene og angi kjørbare tillatelser hvis de ikke allerede er angitt.

Eksempel på en skikkelig avslutning av skriptet:

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

 

Valider skriptet lokalt

Kjør skriptet manuelt og bekreft at det avsluttes med .

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

 

Start avtar på nytt og utløs en sikkerhetskopi.

Når du har bekreftet retur av skriptet, kommer du tilbake 0, start avtar-tjenesten på nytt og start en sikkerhetskopieringsjobb for å bekrefte normal drift.

# Restart avtar service
$ systemctl restart avtar

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

 

Bekreft oppløsningen.

Kontroller avtar-loggen for fravær av feilmeldingen "Exiting avtar with run‑at‑start script failure 1." En vellykket loggoppføring ligner på 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

 

FORSIKTIG: Ikke ignorere utgangskoder som ikke er null; De indikerer reelle feil som må rettes opp før du fortsetter.
FORSIKTIG: Hvis du endrer kjøring ved start-skriptet på feil måte, kan det føre til sikkerhetskopieringsfeil for alle klienter som bruker denne policyen. Test endringer i et ikke-produksjonsmiljø først.
MERK: Hvis du ikke kan endre skriptet eller problemet vedvarer etter at du har tatt i bruk trinnene ovenfor, kan du kontakte Dells kundestøtte for å få mer hjelp.

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.