Avamar: Come eliminare un backup quando è abilitato Retention Lock (modalità Governance)

Summary: Eliminazione di un backup quando il blocco della retention (modalità di governance) è abilitato sulle soluzioni integrate Avamar e Data Domain.

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.

Instructions

Per eliminare un backup quando è abilitato il blocco della retention (modalità governance), è necessario seguire questi passaggi in quest'ordine specifico.

Avvertenza: Comandi alternati tra Avamar e Data Domain (DD). Prestare molta attenzione alla posizione in cui devono essere eseguiti i comandi.
 
Attenzione: Questi passaggi possono sbloccare i dati protetti o causare la perdita di dati se non seguiti accuratamente.
 
 

Passaggio 1 - Avamar:

Accedere ad Avamar Utility Node come amministratore.

Determinare il percorso del client utilizzando il seguente comando:

avmgr getl --path=<domain path to client> | grep -i '<client name>'
 

Esempio:

avmgr getl --path=/clients/physical | grep -i 'testclientA'
1  testclientA.company.com      location: d057f520d4f5ab5b26c2b754714c9f21f50255c2      pswd: c1015019cf10175d15984d7cc9c833754f3cff3e
 

Prendere nota della posizione. Questo è chiamato anche ID client (CID).

Queste informazioni sono necessarie per trovare il percorso completo su Data Domain nei passaggi successivi.

Passaggio 2 - Avamar:

Per eliminare un intero client o tutti i backup da un client, andare al passaggio 3.

Per eliminare un singolo backup, più backup (ma non tutti), eseguire il comando seguente per recuperare l'elenco dei backup per tale Avamar Client:

avmgr getb --path=<full path to client> --format=xml
 

Esempio:

avmgr getb --path=/clients/physical/testclientA.company.com --format=xml
1  Request succeeded
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<backuplist version="3.0">
  <backuplistrec flags="19922945" labelnum="488" label="1800-phy-file_srv_phy-1576465200020" created="1576466965" roothash="23f00d475c58c8ff95b5f1d298e01a1d4a632f72" totalbytes="4775684341760.00" ispresentbytes="0.00" pidnum="3001" percentnew="1" expires="0" created_prectime="0x1d5b3c104506658" partial="0" retentiontype="daily,weekly" backuptype="Full" ddrindex="1" locked="0" direct_restore="1" tier="0" appconsistent="not_available" sealstate="COMPLETE" imu_locked="false" imu_locked_weeks="0" force_no_imulock="false"/>
  <backuplistrec flags="19922945" labelnum="481" label="1800-phy-file_srv_phy-1575860400016" created="1575862022" roothash="895eae1260310a6e27316d29e8d52fdff562cb76" totalbytes="4779966201856.00" ispresentbytes="0.00" pidnum="3001" percentnew="1" expires="0" created_prectime="0x1d5ae4085e092a0" partial="0" retentiontype="daily,weekly" backuptype="Full" ddrindex="1" locked="0" direct_restore="1" tier="0" appconsistent="not_available" sealstate="COMPLETE" imu_locked="false" imu_locked_weeks="0" force_no_imulock="false"/>
  <backuplistrec flags="24117249" labelnum="474" label="1800-phy-file_srv_phy-1575255600018" created="1575257228" roothash="fadf73cd92ce3d97d4e5223c13255aca49716631" totalbytes="4774015008768.00" ispresentbytes="0.00" pidnum="3001" percentnew="1" expires="0" created_prectime="0x1d5a8c060960b04" partial="0" retentiontype="daily,weekly,monthly" backuptype="Full" ddrindex="1" locked="0" direct_restore="1" tier="0" appconsistent="not_available" sealstate="COMPLETE" imu_locked="false" imu_locked_weeks="0" force_no_imulock="false"/>
  <backuplistrec flags="19922945" labelnum="467" label="1800-phy-file_srv_phy-1574650800019" created="1574652417" roothash="afafe01c88300c5376a4042c4323d066a8c49cc2" totalbytes="4766955470848.00" ispresentbytes="0.00" pidnum="3001" percentnew="1" expires="0" created_prectime="0x1d5a3403120cb82" partial="0" retentiontype="daily,weekly" backuptype="Full" ddrindex="1" locked="0" direct_restore="1" tier="0" appconsistent="not_available" sealstate="COMPLETE" imu_locked="false" imu_locked_weeks="0" force_no_imulock="false"/>
</backuplist>
 
Prendere nota del "created_prectime" valore o valori. Questa è l'ora di creazione del backup o BID (e il modo in cui il backup viene sigillato sul server Data Domain). 
      • Il valore viene sempre visualizzato come "0x" seguito dal timestamp (ad esempio "0x1d5a8c060960b04"). 
      • Il valore che segue "0x" è ciò che è richiesto da questo output (che sarebbe "1d5a8c060960b04" in questo esempio). 
 

Passaggio 3 - Data Domain:

In Data Domain, accedere come sysadmin.

Eseguire il seguente comando per elencare il mtrees:

mtree list
 

Esempio:

mtree list
Name                           Pre-Comp (GiB)   Status
----------------------------   --------------   -------
/data/col1/avamar-1234567890           9080.1   RW/RLGE
/data/col1/backup                         0.0   RW
----------------------------   --------------   -------
 D    : Deleted
 Q    : Quota Defined
 RO   : Read Only
 RW   : Read Write
 RD   : Replication Destination
 IRH  : Retention-Lock Indefinite Retention Hold Enabled
 ARL  : Automatic-Retention-Lock Enabled
 RLGE : Retention-Lock Governance Enabled
 RLGD : Retention-Lock Governance Disabled
 RLCE : Retention-Lock Compliance Enabled
 M    : Mobile
 m    : Migratable
 

Prendere nota di Avamar mtree. La colonna mtree Name è obbligatorio per ripristinare il retention lock più avanti in questa procedura.

Passaggio 4 - Avamar:

Verifica di Avamar mtree Name eseguendo il seguente comando:

avmaint hfscreate 
 

Output di esempio:

1234567890
 

Quindi anteporre la stringa "/data/col1/avamar-".

In questo esempio, il risultato mtree Il nome è /data/col1/avamar-1234567890 e corrisponde all'output del passaggio 3.

Passaggio 5 - Data Domain:

  • Membri del team di supporto tecnico Avamar di Dell Technologies:

Fare riferimento alla sezione "Note interne" per i passaggi successivi.

 

  • Tutti gli altri:

Eseguire il seguente comando per generare un report di tutti i file con Retention Lock su Data Domain:
(viene utilizzato per trovare i client e i backup da eliminare).

mtree retention-lock report generate retention-details mtrees /data/col1/<avamar-xxxxxxxx> output-file <filename.txt>

(dove "mtrees" è Avamar mtree determinato in precedenza (in questo esempio: /data/col1/avamar-1234567890)

Esempio:

mtree retention-lock report generate retention-details mtrees /data/col1/avamar-1234567890 output-file dd_retentionlock.txt
 

In questo modo viene generato un report con tutti i file bloccati.

L'output viene inviato a /ddvar/log/debug/retention-lock-reports/ directory (o la directory specificata al momento dell'esecuzione del comando). 

Utilizzare l'ID client (CID) ricavato dal passaggio 1 e individuare il percorso di backup su Data Domain dal file generato (in questo esempio dd_retentionlock.txt)

Passaggio 6 - Data Domain:

Una volta trovato il percorso, eseguire il seguente comando per invertire il blocco di backup (rendendo possibile l'eliminazione):

mtree retention-lock revert <path to client/backup>
 

Il comando richiede la password sysadmin per completare il processo di ripristino.

A seconda di ciò che viene eliminato, il comando varia leggermente:

Se si eliminano tutti i backup o un client, il comando utilizza l'ID client (CID) del passaggio 1.

Esempio:

mtree retention-lock revert /data/col1/avamar-1234567890/cur/d057f520d4f5ab5b26c2b754714c9f21f50255c2
The 'mtree retention-lock revert' command removes retention-lock on this path thereby making it unprotected.
        Are you sure? (yes|no) [no]: yes

ok, proceeding.

Please enter sysadmin password to confirm 'mtree retention-lock revert':
 

Se si eliminano singoli backup, il comando è costituito sia dall'ID client (CID) del passaggio 1 che dall'ID di backup del passaggio 4 (deve essere inserito in maiuscolo):

Esempio:

mtree retention-lock revert /data/col1/avamar-1234567890/cur/d057f520d4f5ab5b26c2b754714c9f21f50255c2/1D5A8C060960B04
The 'mtree retention-lock revert' command removes retention-lock on this path thereby making it unprotected.
        Are you sure? (yes|no) [no]: yes

ok, proceeding.

Please enter sysadmin password to confirm 'mtree retention-lock revert':
 

È necessario eseguire un comando separato per ogni singolo backup eliminato.

Ad esempio, per eliminare due backup:

mtree retention-lock revert /data/col1/avamar-1234567890/cur/d057f520d4f5ab5b26c2b754714c9f21f50255c2/1D5A8C060960B04
mtree retention-lock revert /data/col1/avamar-1234567890/cur/d057f520d4f5ab5b26c2b754714c9f21f50255c2/1D5A3403120cB82
 

Passaggio 7 - Avamar:

Una volta completato il ripristino del blocco, eseguire il seguente comando sulla griglia Avamar per disabilitare temporaneamente la modalità governance:

avmaint config governancemode=false --ava
 

Passaggio 8 - Avamar (interfaccia utente, AUI o MCCLI):

Una volta disabilitata la modalità governance, è possibile eliminare i backup o i client utilizzando l'interfaccia web Avamar (AUI), la console di gestione (interfaccia utente MC) o mccli.

Passaggio 9 - Avamar:

Dopo aver eliminato i client o i backup, abilitare nuovamente la modalità governance sulla griglia Avamar eseguendo il seguente comando:

avmaint config governancemode=true --ava

Affected Products

Avamar, Avamar, Avamar Server
Article Properties
Article Number: 000227152
Article Type: How To
Last Modified: 10 Nov 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.