Avamar: Como excluir um backup quando o Retention Lock (modo de governança) está ativado

Summary: Excluir um backup quando o bloqueio de retenção (modo de governança) estiver habilitado nas soluções integradas 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.
Check out other resources

Instructions

Para excluir um backup quando o bloqueio de retenção (modo de governança) está ativado, essas etapas devem ser seguidas nesta ordem específica.

Advertência: Os comandos alternam entre o Avamar e o Data Domain (DD). Preste muita atenção onde os comandos devem ser executados.
 
Aviso: Essas etapas podem desbloquear dados protegidos ou produzir perda de dados se não forem seguidas com precisão.
 
 

Etapa 1 — Avamar:

Faça log-in no Avamar Utility Node como administrador.

Determine o caminho para o client usando o seguinte comando:

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

Exemplo:

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

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

Anote a localização. Isso também é chamado de ID do client (CID).

Essas informações são necessárias para localizar o caminho completo no Data Domain em etapas posteriores.

Etapa 2 — Avamar:

Para excluir um client inteiro ou todos os backups de um client, vá para a etapa 3.

Para excluir um único backup, vários (mas não todos) backups, execute o seguinte comando para recuperar a lista de backups desse Avamar Client:

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

Exemplo:

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>
 
Anote o "created_prectime" valor ou valores. Esse é o tempo de criação do backup ou BID (e como o backup é selado no servidor Data Domain). 
      • O valor é sempre visto como "0x" seguido pelo registro de data e hora (por exemplo, "0x1d5a8c060960b04"). 
      • O valor após o "0x" é o que é necessário para essa saída (que seria "1d5a8c060960b04" neste exemplo). 
 

Etapa 3 - Data Domain:

No Data Domain, faça log-in como sysadmin.

Execute o seguinte comando para listar os mtrees:

mtree list
 

Exemplo:

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
 

Anote o Avamar mtree. A coluna mtree Name é obrigatório para reverter o bloqueio de retenção posteriormente neste procedimento.

Etapa 4 — Avamar:

Verificar o Avamar mtree Execute o seguinte comando:

avmaint hfscreate
 

Exemplo de resultado:

1234567890
 

Em seguida, acrescente a string "/data/col1/avamar-"

Neste exemplo, o resultado mtree O nome é /data/col1/avamar-1234567890, correspondendo ao resultado da etapa 3.

Etapa 5 - Data Domain:

  • Membros da equipe de suporte técnico do Dell Technologies Avamar:

Consulte a seção "Internal Notes" para obter as próximas etapas.

 

  • Todos os outros:

Execute o seguinte comando para gerar um relatório de todos os arquivos bloqueados para retenção no Data Domain:
(Isso é usado para localizar os clients e backups a serem excluídos.)

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

(Em que "mtrees" é a mtree do Avamar determinada anteriormente (neste exemplo: /data/col1/avamar-1234567890)

Exemplo:

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

Isso gera um relatório com todos os arquivos bloqueados.

A saída é enviada para o /ddvar/log/debug/retention-lock-reports/ diretório (ou o diretório especificado quando o comando é executado). 

Use o CID (Client ID, ID do client) coletado na etapa 1 e localize o caminho de backup no Data Domain a partir do arquivo de saída gerado (neste exemplo dd_retentionlock.txt)

Etapa 6 - Data Domain:

Depois que o caminho for encontrado, execute o seguinte comando para reverter o bloqueio de backup (possibilitando que ele seja excluído):

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

O comando solicita a senha do sysadmin para que o processo de reversão seja concluído.

Dependendo do que está sendo excluído, o comando varia ligeiramente:

Se estiver excluindo todos os backups ou um client, o comando usará o ID do client (CID) da etapa 1.

Exemplo:

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 estiver excluindo backups individuais, o comando consistirá no ID do client (CID) da etapa 1 e no ID de backup da etapa 4 (isso deve ser inserido em maiúsculas):

Exemplo:

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

Um comando separado deve ser executado para cada backup individual que está sendo excluído.

Por exemplo, para excluir dois dos backups:

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

Etapa 7 — Avamar:

Depois que a reversão do bloqueio for concluída, execute o seguinte comando na grade do Avamar para desativar temporariamente o modo de governança:

avmaint config governancemode=false --ava
 

Etapa 8 - Avamar (interface do usuário, AUI ou MCCLI):

Depois que o modo de governança estiver desativado, os backups ou clients poderão ser excluídos usando a interface Web do Avamar (AUI), o console de gerenciamento (interface do usuário do MC) ou mccli.

Etapa 9 — Avamar:

Depois de excluir os clients ou backups, reative o modo de governança na grade do Avamar executando o seguinte 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.