Avamar: De uitvoer begrijpen die wordt gegenereerd door de opdracht status.dpn

In dit artikel wordt de status.dpn commando en legt elk deel van de uitvoer uit.

Wat is de status.dpn bevelen?   

De status.dpn commando is een perl script dat een reeks opmaak van "avmaint nodelist" en opdrachten voor het Linux-besturingssysteem (OS) in een voor mensen leesbare indeling voor het weergeven van de huidige status van een Avamar Grid. 

Vergelijkbaar met andere Avamar-opdrachten en -hulpprogramma's, status.dpn bevindt zich in de "/usr/local/avamar/bin/" map. 

De status.dpn opdracht is afhankelijk van de GSAN online zijn om te rennen, zoals "avmaint" interageert met de GSAN om de opdrachten uit te voeren.

Als de GSAN niet wordt uitgevoerd op een dataknooppunt, wordt er geen informatie over dat knooppunt, behalve het knooppuntnummer en de offline status, weergegeven.

Voorbeeld van een status.dpn uitvoer:

Tue May 13 00:43:37 EDT 2025  [Avamar1.company.com] Tue May 13 04:43:36 2025 UTC (Initialized Fri Aug 26 22:10:38 2022 UTC)
Node   IP Address     Version   State   Runlevel  Srvr+Root+User Dis Suspend Load UsedMB Errlen  %Full   Percent Full and Stripe Status by Disk
0.0  192.168.255.2  19.12.0-186  ONLINE fullaccess mhpu+0hpu+0hpu   1 false   0.03 30672 26994469   0.1%   0%(onl:62 )  0%(onl:44 )  0%(onl:54 )  0%(onl:36 )  0%(onl:38 )  0%(onl:37 )  0%(onl:37 )  0%(onl:42 )  0%(onl:33 )  0%(onl:32 )  0%(onl:30 )  0%(onl:30 )
0.1  192.168.255.3  19.12.0-186  ONLINE fullaccess mhpu+0hpu+0hpu   2 false   0.02 30821 26812792   0.1%   0%(onl:40 )  0%(onl:33 )  0%(onl:41 )  0%(onl:33 )  0%(onl:68 )  0%(onl:32 )  0%(onl:33 )  0%(onl:39 )  0%(onl:31 )  0%(onl:36 )  0%(onl:31 )  0%(onl:50 )
0.2  192.168.255.4  19.12.0-186  ONLINE fullaccess mhpu+0hpu+0hpu   0 false   0.02 29008 26927773   0.1%   0%(onl:36 )  0%(onl:39 )  0%(onl:41 )  0%(onl:48 )  0%(onl:40 )  0%(onl:34 )  0%(onl:41 )  0%(onl:32 )  0%(onl:41 )  0%(onl:35 )  0%(onl:34 )  0%(onl:46 )
Srvr+Root+User Modes = migrate + hfswriteable + persistwriteable + useraccntwriteable

System ID: 1234567890@EC:2A:72:07:59:23

All reported states=(ONLINE), runlevels=(fullaccess), modes=(mhpu+0hpu+0hpu)
System-Status: ok
Access-Status: full

Last checkpoint: cp.20250512120531 finished Mon May 12 08:05:55 2025 after 00m 24s (OK)
Last GC: finished Mon May 12 08:00:26 2025 after 00m 08s >> recovered 0.00 KB (OK)
Last hfscheck: finished Mon May 12 08:04:15 2025 after 02m 54s >> checked 1406 of 1406 stripes (OK)

Maintenance windows scheduler capacity profile is active.
  The backup window is currently running.
  Next backup window start time: Tue May 13 20:00:00 2025 EDT
  Next maintenance window start time: Tue May 13 08:00:00 2025 EDT
 

• De tijd en datum in de lokale tijdzone
• De hostnaam van het Avamar hulpprogrammaknooppunt
• De tijd en datum in Universal Time Coordinated (UTC)
• De tijd en datum waarop het Avamar grid is geïnitialiseerd (geïnstalleerd) in UTC. UTC wordt weergegeven terwijl de dataknooppunten op UTC-tijd worden uitgevoerd

• Toont de versie van de GSAN Binair bestand op het Avamar-dataknooppunt

• • ONLINE

    • De GSAN wordt uitgevoerd op dit dataknooppunt. Normale functionaliteit
  • OFFLINE
    • De GSAN wordt niet uitgevoerd op dit dataknooppunt. Vereist probleemoplossing

• Geeft de runniveaustatus weer van de GSAN Proces (per Avamar-dataknooppunt)
• Er zijn meerdere uitvoeringsniveaus van GSAN:

• • Afsluiten

    • Afsluiten van de GSAN proces
  • Computer opstarten

    • Opstarten van de GSAN online verwerken
  • Verbinden

    • De GSAN Verbinding maken met de gegevens van elke peer-dataknooppunt. GSAN
  • Valideren

    • Bezig met valideren van de stripe DNS table op elk Avamar-dataknooppunt
  • Opstarten

    • Strepen online brengen
  • Synchroniseren

    • Bepalen welke stripes moeten worden bijgewerkt, indien van toepassing, door ze opnieuw op te bouwen of de transactielogboeken te gebruiken
  • Upgrade

    • Wordt gebruikt wanneer de GSAN Binary wordt bijgewerkt naar een nieuwere versie
  • Lopend

    • De GSAN is begonnen. Alle stripes zijn online, maar niet beschikbaar voor het accepteren van back-ups
  • Fullaccess
    • Het raster is beschikbaar om back-ups te accepteren

• • Srvr

    • Avamar GSAN Privileges
  • Root

    • Avamar dpn root user Privileges
  • User
    • Alle rechten van alle andere gebruikers

• • mhpu+0hpu+0hpu

    • Volledige toegang
      • Normale werking
  • mhpu+0hpu+0000

    • Beheerdersmodus
      • Wanneer "waitcGSAN" wordt opgestart als gevolg van een hfscheckde GSAN capaciteit gelijk is aan of groter is dan de "diskreadonly" limiet en het verschil in het capaciteitsgebruik van het besturingssysteem overschrijdt de "freespaceunbalance "Waarde vermeld in "avmaint config"
  • mhpu+0000+0000

    • Synchronisatiemodus
      • Tijdens een herstart van GSAN tijdens het synchroniseren van strepen en wanneer "testintegrity" wordt uitgevoerd of een streep wordt opnieuw opgebouwd
  • m000+0000+0000
    • Alleen-lezen-modus
      • Wordt weergegeven tijdens controlepunten

(Kan ook worden weergegeven als 0000+0000+0000)

Zie Bijlage #1 voor de processen die van invloed zijn op de activiteitstoegangsmodus.

• • m=Migrate

    • Kan het systeem strepen migreren?
  • h=HFS Data Store

    • Kan het systeem schrijven naar de HFS Data Store?
  • p=Persistent Store

    • Kan het systeem schrijven naar de Persistent Store?
  • u=User Accounting System
    • Is het systeem in staat om naar het gebruikersboekhoudsysteem te schrijven?

• Geeft de status van de dispatcher weer (al dan niet geschorst)
• Als het Avamar-raster wordt onderbroken, voorkomt het dat nieuwe dispatchers worden geactiveerd voor gebruik voor back-ups, herstel en replicaties

• Totale hoeveelheid RAM die het Avamar-dataknooppunt momenteel gebruikt door alle processen

• Een samenvatting van de status van het raster
• Geeft de knooppuntstatus weer, runlevelsen modi
• Als er meerdere statussen voor een item zijn, worden ze allemaal weergegeven.

All reported states=(ONLINE, OFFLINE), runlevels=(fullaccess), modes=(mhpu+0hpu+0hpu) 

• In het eerste deel wordt de status van de onderhoudsactiviteiten weergegeven sinds GSAN is online.
• Het geeft de voortgang van de onderhoudsactiviteiten en hun status weer (In uitvoering, voltooid of mislukt met fout)
• Als de GSAN onlangs is gestart, is de status van de onderhoudsactiviteiten gewist

Zie bijlage #3a en #3b voor voorbeelden.

• In het tweede gedeelte wordt weergegeven welk schema momenteel actief is, welke onderhoudstaken worden uitgevoerd en informatie over het onderhouds- en back-upschema

• • Script 

    • Voert de GSAN onderhoudsscripts aan het begin van elk venster. Standaard duurt het maximaal 15 minuten zonder onderbreking, waarna het parallel met andere taken wordt uitgevoerd totdat het is voltooid.
    • Deze scripts bevinden zich in de "/usr/local/avamar/etc/GSAN-maint-scripts/" map
  • indexcacheloader

    • Laadt de indexcaches aan het begin van het back-upvenster en het onderhoudsvenster indien nodig, en verwijdert de indexcaches aan het begin van het onderhoudsvenster.
    • Vanaf v 7.x is er een  "indexcacheunloader" taak om de "indexcaches"  Lossen
  • Annuleren

    • Annuleert of stopt back-ups voordat ze worden opgehaald
  • gc/cp/hfscheck

    • De respectieve onderhoudstaak wordt momenteel uitgevoerd
  • autorepair

    • Voert autoreparatie uit (indien nodig) na hfscheck Voltooit
  • Conversie

    • Converteert strepen (indien nodig) aan het einde van het onderhoudsvenster
  • Evenwicht
    • Balansstrepen aan het einde van het onderhoudsvenster als er tijd beschikbaar is nadat de onderhoudsactiviteiten zijn voltooid.
    • Deze optie stelt standaard tijdelijk in "balancemin" tot 10 (kan worden geconfigureerd in de avmaint schema), tenzij "balancemin" is al expliciet ingesteld met behulp van "avmaint config"

• De informatie voor de schema's is ingesteld voor wanneer Avamar-onderhoud (garbage collection, checkpoint en hfscheck) en back-ups zijn gepland om te worden gestart

• In dit gedeelte wordt ook aangegeven of een van de schema's of afzonderlijke onderhoudsactiviteiten is gestopt of opgeschort.

Zie Bijlage #4 voor het voorbeeld.

Bijlage #1 - Toegangsmodi voor activiteiten:

Hieronder volgen items die de toegangsmodus van het Avamar-raster kunnen wijzigen.

Voer de volgende opdracht uit om te bepalen welk proces de activiteitstoegangsmodus van het Avamar grid heeft gewijzigd.

avmaint nodelist --xmlperline=99 | grep activityaccessmodes 

Voorbeeldresultaat:

<activityaccessmodes adminuser="mhpu+0hpu+0hpu" checkpoint="mhpu+0hpu+0hpu" conversion="mhpu+0hpu+0hpu" diskbeat="mhpu+0hpu+0hpu" garbagecollect="mhpu+0hpu+0hpu" heartbeat="mhpu+0hpu+0hpu" hfscheckserver="mhpu+0hpu+0hpu" hfscheckexecute="mhpu+0hpu+0hpu" nodebeat="mhpu+0hpu+0hpu" runlevel="mhpu+0hpu+0hpu" testintegrity="mhpu+0hpu+0hpu" removehashes="mhpu+0hpu+0hpu" rebuildstripe="mhpu+0hpu+0hpu" diskfull="mhpu+0hpu+0hpu"/>

Bijlage #2 - Stripe-status:

• ONL -Online- (onl:2961)
  • Stripe is zonder problemen online
  • Normale stripe-status
• UIT - Offline - (onl:2960,OFF:1)
  • Stripe is offline
  • Ditkan het gevolg zijn van een stripe die opnieuw wordt opgebouwd of een stripe die offline is gezet vanwege een fout
• ERR - Fout - (onl:2959,ERR: 2)
  • Stripe bevindt zich in de status OFFLINE_MEDIA_ERROR
  • Zie Avamar: Problemen met Stripes Offline oplossen met OFFLINE_MEDIA_ERROR fouten (oplossingspad) voor meer informatie
• SUS - Geschorst - (onl:1,SUS:2960)
  • Stripe is waarschijnlijk onderbroken vanwege I/O-prestaties van de schijf en heeft ervoor gezorgd dat Avamar de datapartitie heeft onderbroken
  • Zie Avamar: Opgeschorte partities, stripes en HFSCHECK-fouten op Avamar Meer informatie
• MIG - Migreren - (onl:2960,MIG:1) 
  • Stripe verhuist of migreert naar een ander Avamar-dataknooppunt
• RES - Opnieuw opstarten - (onl:2040,RES:920)
  • Stripe start opnieuw op vanuit de vorige offline staat

Bijlage #3a - Voorbeelduitvoer voor onderhoudsactiviteiten die op het Avamar-net zijn uitgevoerd:

Last checkpoint: cp.20121223181633 finished Sun Jan 23 18:17:00 2013 after 00m 27s (OK)
Last GC: finished Sun Jan 23 17:07:26 2013 after 01m 25s >> recovered 342.02 MB (OK)
Last hfscheck: finished Sun Jan 23 18:16:19 2013 after 12m 05s >> checked 2132 of 2132 stripes (OK)

Aanhangsel #3b - Voorbeeld van de uitvoer van de onderhoudswerkzaamheden na een GSAN herstarten:

No checkpoint yet
No GC yet
No hfscheck yet 

Bijlage #4 - Voorbeelduitvoer van het onderhoudsschema, het controlepunt, de afvalinzameling en hfscheck Wordt geschorst:    

Maintenance windows scheduler capacity profile is active.
  WARNING: cp is suspended temporarily.
  WARNING: gc is suspended temporarily.
  WARNING: hfscheck is suspended temporarily.
  The backup window is currently running 
  Next backup window start time: Tue May 13 21:00:00 2025 PDT
  Next maintenance window start time: Tue May 13 14:00:00 2025 PDT

Bijlage #5 - status.dpnOpdrachtopties:

• status.dpn <interval in seconden>
  • Voert de status.dpn opdracht in een lus voor het opgegeven aantal seconden
    • Een waarde van 10 (Tien) retourneert de status.dpn Voer elke 10 seconden uit totdat de opdracht handmatig wordt afgesloten
    • Een waarde van 0 (nul) retourneert een enkele status.dpn Uitvoer zonder looping
• --help
  • Toont de status.dpn Helpmenu
• --short
  • Minder details weergeven in status.dpn
    • Verwijdert de hostnaam, versie, laad, UsedMB Informatie %vol en Percentage vol en Stripe-status per schijf
  • Wordt gebruikt voor snellere weergave status.dpn Uitvoer en probleemoplossing
• --sort
  • Sorteert de knooppunten op een andere variabele optie:
    • =knooppunt
      • Sorteert de gegevensknooppunten op logische knooppuntnummers (standaard)
    • =ipaddr
      • Sorteert de dataknooppunten op IP-adres
    • =verzender
      • Sorteert de gegevensknooppunten op het aantal coördinatoren in gebruik (gesorteerd met het laagste aantal in gebruik zijnde coördinatoren bovenaan de lijst)
    • = belasting
      • Sorteert de dataknooppunten op de belastingswaarde (gesorteerd met de laagste belastingswaarde bovenaan de lijst)
    • =gebruikt
      • Sorteert de gegevensknooppunten op basis van de UsedMB waarde (gesorteerd met de laagste waarde van UsedMB staan bovenaan de lijst)
    • =vol
      • Sorteert de dataknooppunten op de waarde %Full (Gesorteerd met de laagste waarde %Full staan bovenaan de lijst)