Gerenciamento de capacidade do Avamar: Como excluir ou expirar backups em massa com a ferramenta "modify-snapups"

Este artigo é para documentar como usar a ferramenta modify-snapupsem um sistema Avamar para ajudar com alguns dos desafios a seguir.

• O administrador deseja excluir backups em massa para resolver ou impedir uma situação de alta capacidade.
• O sistema está ficando cheio e, embora as políticas de retenção sejam reduzidas, essa ação afeta apenas novos backups. Também é necessário alterar a expiração dos backups existentes.
• Os backups existentes foram definidos com datas de expiração incorretas.
• Os requisitos de negócios mudam e a organização deve armazenar mais ou menos backups do que o planejado originalmente.

O utilitário "modify-snapups.sh" é um script que está presente por padrão no nó do utilitário Avamar em /usr/local/avamar/bin.

O utilitário substitui os scripts "expire-snapups" e "delete-snapups", que eram formas anteriores da ferramenta. Ambos os scripts anteriores estão obsoletos e os comandos agora chamam diretamente de modify-snapups, se executados (consulte o item nº 1 em Notas).

Modos de expiração e exclusão:    
modify-snapups é executado usando o modo de expiração ou o modo de exclusão.
 
Os indicadores passados para cada modo são quase idênticos e são visualizados acrescentando --help ao comando. (consulte o item nº 2 em Notas)

O que o script faz?  
A execução de modify-snapups por conta própria é segura, pois não faz alterações no servidor Avamar.

Quando executado com argumentos corretos, o utilitário gera um script que contém uma lista de comandos. A execução do script executa a lista de comandos em série para alterar as datas de expiração de cada backup ou excluí-lo.

Os comandos são gerados de acordo com os indicadores passados para modify-snapups.  

Um usuário pode decidir se deseja incluir backups:      

• Dentro de um determinado intervalo de datas (--after/--before)
• Em um determinado domínio (--domínio)
• Para um determinado client
• Se deve incluir backups internos do banco de dados do Avamar para AVI, EM, MC
• Se deve incluir backups no destino de replicação

Comandos de exemplo

Exemplo 1: Verifique todos os backups em "mydomain" e crie um script que expire os criados antes de 1º de março de 2015.
 
O script produz uma lista de comandos mccli backup edit para MODIFICAR (que, nesse caso, expirará) os backups apropriados. Aqueles que não correspondem aos critérios também são listados, mas têm um prefixo com um hash (#) e a descrição CONSERVE:   
 
Exemplo 2: Exclua todos os backups do mydomain que foram criados há mais de um mês.
 
Use as datas adequadas como no exemplo nº 1, mas, para ilustrar, aqui são usadas as notações de data "amigáveis" do Linux (há um mês).

O script contém o resultado conforme mostrado abaixo (truncado por motivos de espaço). No cabeçalho, o script explica exatamente qual operação ele está realizando e os parâmetros que estão em vigor. O script foi executado em 17 de abril de 2015.
Os backups listados com MODIFY são alterados com o comando 'mccli backup delete'. Todos esses backups têm datas "criadas" antes de um mês atrás (17 de março de 2015).

Exemplo 3: Estender a expiração dos backups existentes.
O comando a seguir faz backups criados entre 1 e 15 de maio de 2018 para clients no domínio /clients e cria um script que, quando executado, substitui a expiração desses backups para que eles expirem 100 dias após a criação do backup.
 

.
8.
# =================================================================================#
CLIENT: /clients/server.asl.lab.emc.com
# Operação: EXPIRE selected snapups
# After :: "2018-05-01" (1525158000) Terça-feira, 1º de maio, 00:00:00 PDT 2018
# Antes: "2018-05-15 " (1526367600) Terça-feira, 15 de maio 00:00:00 PDT 2018
# ========================= ================================================================
# MODIFY Snapup data: 05/05/2018 22:00:52 PDT Nº do laboratório: 498 Replicados: Eco N/A em
execução: "mccli backup edit --domain=/clients --name=server --labelNum=498 --created=2018-05-07 --expiration=2018-08-15"
mccli edição de backup --domain=/clients --name=server --labelNum=498 --created=2018-05-07 --expiration=2018-08-15
# MODIFY Snapup data: 06/05/2018 22:00:46 PDT Nº do laboratório: 497 Replicados: Eco N/A em
execução: "mccli backup edit --domain=/clients --name=server --labelNum=497 --created=2018-05-06 --expiration=2018-08-14"
mccli backup edit --domain=/clients --name=server --labelNum=497 --created=2018-05-06 --expiration=2018-08-14
8# Data do snapup CONSERVE: 25/06/2018 22:00:41 PDT Nº do laboratório: 501 Replicado: Eco N/A
# em execução: "mccli backup edit --domain=/clients --name=server --labelNum=501 --created=2018-06-25 --expiration=2018-10-03"
# mccli edição de backup --domain=/clients --name=server --labelNum=501 --created=2018-06-25 --expiration=2018-10-03
# CONSERVE Snapup data: 04/04/2018 22:00:57 PDT Nº do laboratório: 491 Replicados: Eco N/A
# em execução: "mccli backup edit --domain=/clients --name=server --labelNum=491 --created=2018-04-30 --expiration=2018-08-08".
# mccli backup edit --domain=/clients --name=server --labelNum=491 --created=2018-04-30 --expiration=2018-08-08

Executando o script para modificar ou excluir backups

É altamente recomendável que um checkpoint seja feito antes de executar este procedimento.

Depois de criar o script, verifique o conteúdo com cuidado. Quando estiver satisfeito com as ações que serão realizadas, defina o script como executável.

Por exemplo, crie um script para excluir todos os backups em /mydomain que têm mais de 6 meses.

Defina o script como executável e verifique as permissões:    
 
Execute o script. Redirecione a saída para outro arquivo para registrar as alterações feitas.
 
Se o script foi executado até a conclusão e é executado uma segunda vez, consulte:    
Se o script levar muito tempo para ser executado e precisar ser interrompido, ele poderá ser executado uma segunda vez. Para evitar a remarcação de backups excluídos anteriormente, edite o script manualmente para excluir os comandos já processados. Como alternativa, gere novamente o script.

A geração e a execução do script podem levar um tempo significativo. É útil "dividir e conquistar" dividindo o trabalho em períodos menores ou domínios individuais.

Item nº 1
O termo "snapup" é uma terminologia obsoleta do Avamar que pode ser tomada para significar um backup. É um híbrido das palavras de snapshote backup.

Item nº 2
A documentação completa sobre como usar os modos de exclusão e expiração está disponível adicionando --help ao comando.
 
Item nº 3
Esteja ciente do seguinte artigo.

• (Somente clientes registrados da Dell podem acessar o conteúdo no artigo da Base de conhecimento Dell) Avamar - modify-snapups --domain flag não funciona como pretendido e faz com que o script retorne "NO SNAPUPS FOUND".

Veja este vídeo: