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. ...
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 0 . I Linux-/UNIX-miljøer, 0 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
1hvilkenavtarlogget 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 0 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 0 .
$ /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