Avamar: come comprendere l'output generato dal comando cplist

Un checkpoint Avamar è un set di directory read-only sui nodi di dati Avamar. 

Si tratta di un'istantanea point-in-time della griglia Avamar. Può essere utile ai fini del rollback nel caso in cui Avamar riscontri un problema grave che non può essere corretto.

• Lo strumento può essere eseguito da chiunque abbia accesso all'Avamar Utility Node. 

• Presupposti errati sullo stato dei checkpoint possono causare la perdita di dati o l'irrecuperabilità del sistema Avamar.

Questo articolo aiuta il lettore a interpretare l'output dello strumento.

Di seguito è riportato un esempio di output di cplist comando:

cp.20230915110057 Fri Sep 15 12:00:57 2023   valid rol ---  nodes   3/3 stripes   3530
cp.20230915110654 Fri Sep 15 12:06:54 2023   valid --- ---  nodes   3/3 stripes   3530

Dal primo checkpoint nell'elenco, viene illustrato il significato di ciascun campo dati:

• • È l'etichetta identificativa del checkpoint e corrisponde all'ora in cui il checkpoint è stato avviato. cp.YYYYMMDDHHMMSS

• • Il giorno, la data e l'ora in cui è stato creato il checkpoint. Corrisponde sempre al tag del checkpoint

• • Se questo campo mostra "valido", il checkpoint è "integro"
  • Validità: indica se il checkpoint è utile ai fini del rollback
  • Se questo campo mostra "valido", il checkpoint non è stato sottoposto a HFScheck Convalida
  • Il campo di validità è superfluo quando si esegue "cplist" poiché per impostazione predefinita il comando mostra i checkpoint utilizzabili
  • In esecuzione "cplist --full" mostra tutti i checkpoint sulla griglia, inclusi quelli che non sono utilizzabili per scopi di rollback

• • Questo campo mostra il tipo di HFScheck Convalida eseguita sul checkpoint
  • I tipi possibili sono: 'hfs', 'rdc', 'par', 'rol'
    • hfs or full - significa che la convalida è stata eseguita su tutti gli stripe del checkpoint
    • rol - significa che la convalida ha controllato tutte le strisce nuove o modificate nel checkpoint
      • La ricerca ha dimostrato che, quando si verificano problemi di integrità dei dati, di solito le stripe interessate sono quelle appena create o modificate di recente
      • Per questo motivo, Avamar Engineering consiglia di considerare la convalida continua praticamente affidabile quanto un riempimento più lungo HFScheck Convalida
      • A seconda del tasso di acquisizione dei dati Avamar, viene eseguito un HFScheck può anche controllare una parte delle strisce non modificate di un checkpoint.
      • Ciò significa che, alla fine, tutti gli stripe, anche quelli che non sono stati modificati, possono essere sottoposti a controllo di integrità
    • rdc - significa che la convalida è stata completata, ma che un nodo non ha partecipato alla convalida. Il tipo di convalida non è specificato
  • Non è possibile garantire l'integrità dei dati per i checkpoint contrassegnati come rdc.
    • Tale controllo offre maggiore fiducia nell'integrità dei dati rispetto a nessuna convalida

• • Questo campo indica se il checkpoint può essere eliminato, in base alle impostazioni di retention dei checkpoint in vigore sull'Avamar Server
  • La retention dei checkpoint è controllata da "cphfschecked" e "cpmostrecent" parametri
  • La retention dei checkpoint deve essere lasciata come predefinita, a meno che non venga consigliato da un tecnico del supporto
  • Impostazioni errate di retention dei checkpoint possono esporre una griglia Avamar al rischio di perdita di dati o causare problemi di capacità del sistema operativo

• • Il primo numero è il refcount
    • Riporta il numero di nodi che hanno risposto al cplist .
    • Questo valore non indica necessariamente il numero di nodi online
  • Il secondo numero è il nodecount.
    • Si riferisce al numero di nodi che hanno partecipato quando il checkpoint è stato originariamente eseguito. 
    • In altre parole, quanti nodi di dati contengono quella particolare directory di checkpoint
  • Annotare attentamente lo stato della griglia (numero totale di nodi e numero di nodi online) e come cplist prima di contemplare il significato dell'output di questi due campi

• • Questo campo visualizza il numero totale di stripe acquisite nel checkpoint.
  • Una convalida continua del checkpoint convalida un sottoinsieme di questo numero di stripe.
  • Una convalida completa del checkpoint li convalida tutti.

 Esempi di cplist Output

Esempio 1:

cp.20230914190119 Thu Sep 14 20:01:19 2023   valid rol ---  nodes   1/1 stripes   1401
cp.20230914192153 Thu Sep 14 20:21:53 2023   valid --- ---  nodes   1/1 stripes   1401

• Si tratta di una griglia a nodo singolo
• Ci sono due punti di controllo "integri" o utilizzabili
• cp.20230914190119 è stato convalidato con un HFScheck, l'altro checkpoint non è stato convalidato
• Entrambi questi checkpoint hanno catturato 1.401 strisce

Esempio 2:

cp.20230911150620 Mon Sep 11 11:06:20 2023   valid rol ---  nodes   9/9 stripes 121107
cp.20230911160421 Mon Sep 11 12:04:21 2023   valid --- ---  nodes   9/9 stripes 121107
cp.20230912151051 Tue Sep 12 11:10:51 2023   valid --- ---  nodes   8/9 stripes 121107

• Durante ogni checkpoint, nove nodi hanno partecipato al processo di creazione del checkpoint
• Il meno recente dei tre checkpoint (cp.20130911150620) è stato convalidato con un rolling HFScheck
• Il checkpoint più recente (12 settembre) è attualmente inaccessibile su uno dei nove nodi che lo compongono

Esempio 3:

cp.20230915110057 Fri Sep 15 12:00:57 2023   valid rol ---  nodes   3/3 stripes   3530
cp.20230915110654 Fri Sep 15 12:06:54 2023   valid --- del  nodes   3/3 stripes   3530
cp.20230916053830 Sat Sep 16 06:38:30 2023   valid --- ---  nodes   3/3 stripes   3530
cp.20230916060236 Sat Sep 16 07:02:36 2023   valid --- ---  nodes   2/2 stripes   3530

• CP.20130915110654 è idoneo per l'eliminazione in base alle regole di retention dei checkpoint
• cp.20130916060236 è stato acquisito mentre uno dei tre nodi era offline

Esempio 4:

Se una griglia Avamar è integrata con Data Domain (DD), il cplist L'output può mostrare che i checkpoint non sono validi se Data Domain diventa non disponibile.

Ad esempio:

Se DD è online:

cplist

cp.20230830173413 Wed Aug 30 10:34:13 2023   valid hfs ---  nodes   1/1 stripes     82
cp.20230831000113 Wed Aug 30 17:01:13 2023   valid hfs ---  nodes   1/1 stripes     82

Se DD è offline:

cplist 

cplist: ERROR: ddrmaint: <4750>Datadomain get checkpoint list operation failed.

2023/09/17-14:28:06.79970 [cplist]  ERROR: <0001> ddrmaint: <4750>Datadomain get checkpoint list operation failed.
cp.20230830173413 Wed Aug 30 10:34:13 2023 invalid --- ---  nodes   1/1 stripes     82
cp.20230831000113 Wed Aug 30 17:01:13 2023 invalid --- ---  nodes   1/1 stripes     82 

• cplist --lscp (che chiama "avmaint lscp")
• cplist

• "avmaint --lscp" interroga le informazioni sul checkpoint dal GSAN sui nodi di dati.
• Se un nodo non risponde, non è possibile interrogarlo e il refcount Il valore non lo include tra i nodi conteggiati.

Di seguito è riportato un esempio in cui un nodo è offline e vengono eseguite entrambe le varianti:

cplist 

cp.20230915110057 Fri Sep 15 12:00:57 2023   valid rol ---  nodes   3/3 stripes   3530
cp.20230915110654 Fri Sep 15 12:06:54 2023   valid --- del  nodes   3/3 stripes   3530
cp.20230916053830 Sat Sep 16 06:38:30 2023   valid --- ---  nodes   3/3 stripes   3530
cp.20230916060236 Sat Sep 16 07:02:36 2023   valid --- ---  nodes   2/2 stripes   3530 

cplist --lscp 

cp.20230915110057 Fri Sep 15 12:00:57 2023   valid rol ---  nodes   2/3 stripes   3530
cp.20230915110654 Fri Sep 15 12:06:54 2023   valid --- del  nodes   2/3 stripes   3530
cp.20230916053830 Sat Sep 16 06:38:30 2023   valid --- ---  nodes   2/3 stripes   3530
cp.20230916060236 Sat Sep 16 07:02:36 2023   valid --- ---  nodes   2/2 stripes   3530

• avmaint lscp
• avmaint cpstatus
• avmaint hfscheckstatus