Avamar : Suppression d’une sauvegarde lorsque Retention Lock (mode Gouvernance) est activé

Summary: Suppression d’une sauvegarde lorsque le verrouillage de rétention (mode de gouvernance) est activé sur les solutions intégrées Avamar et 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.
Check out other resources

Instructions

Pour supprimer une sauvegarde lorsque le verrouillage de rétention (mode gouvernance) est activé, ces étapes doivent être suivies dans cet ordre spécifique.

Avertissement : Les commandes alternent entre Avamar et Data Domain (DD). Portez une attention particulière à l’endroit où les commandes doivent être exécutées.
 
Attention : Si elles ne sont pas suivies à la lettre, ces étapes peuvent déverrouiller les données protégées ou entraîner une perte de données.
 
 

Étape 1 - Avamar :

Connectez-vous à Avamar Utility Node en tant qu’administrateur.

Déterminez le chemin d’accès au client à l’aide de la commande suivante :

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

Exemple :

avmgr getl --path=/clients/physical | grep -i 'testclientA'

1  testclientA.company.com      location: d057f520d4f5ab5b26c2b754714c9f21f50255c2      pswd: c1015019cf10175d15984d7cc9c833754f3cff3e
 

Prenez note de l’emplacement. Il s’agit également de l’ID client (CID).

Ces informations sont nécessaires pour trouver le chemin complet sur le système Data Domain dans les étapes ultérieures.

Étape 2 - Avamar :

Pour supprimer l’intégralité d’un client ou toutes les sauvegardes d’un client, passez à l’étape 3.

Pour supprimer une seule sauvegarde et plusieurs sauvegardes (mais pas toutes), exécutez la commande suivante pour récupérer la liste des sauvegardes de ce client Avamar :

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

Exemple :

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>
 
Notez l’icône «created_prectime" valeur(s). Il s’agit de l’heure de création de la sauvegarde ou BID (et de la façon dont la sauvegarde est scellée sur le serveur Data Domain). 
      • La valeur est toujours indiquée par « 0x » suivi de l’horodatage (par exemple, « 0x1d5a8c060960b04 »). 
      • La valeur suivant le « 0x » est requise à partir de cette sortie (qui serait « 1d5a8c060960b04 » dans cet exemple). 
 

Étape 3 - Data Domain :

Sur le Data Domain, connectez-vous en tant que sysadmin.

Exécutez la commande suivante pour répertorier le mtrees:

mtree list
 

Exemple :

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
 

Prenez note de l’expérience Avamar mtree. La commande mtree Le nom est requis pour rétablir le verrouillage de rétention ultérieurement dans cette procédure.

Étape 4 - Avamar :

Vérification de l’Avamar mtree name en exécutant la commande suivante :

avmaint hfscreate
 

Exemple de résultat :

1234567890
 

Puis, ajoutez " au début de la chaîne/data/col1/avamar-»

Dans cet exemple, le résultat mtree Nom : /data/col1/avamar-1234567890, ce qui correspond à la sortie de l’étape 3.

Étape 5 - Data Domain :

  • Membres de l’équipe de support technique Dell Technologies Avamar :

Reportez-vous à la section « Notes internes » pour connaître les étapes suivantes.

 

  • Tous les autres :

Exécutez la commande suivante pour générer un rapport de tous les fichiers verrouillés pour rétention sur le système Data Domain :
(Permet de rechercher les clients et les sauvegardes à supprimer.)

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

(Où « mtrees » correspond à une mtree Avamar déterminée précédemment (dans cet exemple : /data/col1/avamar-1234567890)

Exemple :

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

Cela génère un rapport avec tous les fichiers verrouillés.

La sortie est envoyée à l' /ddvar/log/debug/retention-lock-reports/ directory (ou le répertoire spécifié lors de l’exécution de la commande). 

Utilisez l’ID client (CID) collecté à l’étape 1 et recherchez le chemin de sauvegarde sur Data Domain à partir du fichier de sortie généré (dans cet exemple dd_retentionlock.txt)

Étape 6 - Data Domain :

Une fois le chemin trouvé, exécutez la commande suivante pour rétablir le verrouillage de sauvegarde (ce qui permet sa suppression) :

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

La commande vous invite à saisir le mot de passe sysadmin pour terminer le processus de rétablissement.

En fonction de ce qui est supprimé, la commande varie légèrement :

Si vous supprimez toutes les sauvegardes ou un client, la commande utilise l’ID client (CID) de l’étape 1.

Exemple :

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':
 

Si vous supprimez des sauvegardes individuelles, la commande se compose à la fois de l’ID client (CID) de l’étape 1 et de l’ID de sauvegarde de l’étape 4 (il doit être saisi en majuscules) :

Exemple :

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':
 

Une commande distincte doit être exécutée pour chaque sauvegarde individuelle en cours de suppression.

Par exemple, pour supprimer deux des sauvegardes :

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

Étape 7 - Avamar :

Une fois le verrouillage rétabli, exécutez la commande suivante sur la grille Avamar pour désactiver temporairement le mode gouvernance :

avmaint config governancemode=false --ava
 

Étape 8 - Avamar (interface utilisateur, AUI ou MCCLI) :

Une fois le mode gouvernance désactivé, les sauvegardes ou les clients peuvent être supprimés à l’aide de l’interface Web Avamar (AUI), de la console de gestion (MC UI) ou mccli.

Étape 9 - Avamar :

Après avoir supprimé les clients ou les sauvegardes, réactivez le mode gouvernance sur la grille Avamar en exécutant la commande suivante :

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.