Pular para o conteúdo principal

Como gerenciar cadeias de backup

Quando usar​

Quando um cluster funciona como armazenamento de backup: você precisa criar um local para os backups de uma VM específica, abrir um receptor de fluxo e, mais tarde, limpar o histórico ou remover a cadeia inteira. Este procedimento abrange todas as operações no cluster de armazenamento de backup, exceto o envio de dados históricos de volta, que é descrito em Como enviar um ponto de restauração a partir de uma cadeia.

A interface web do cluster não tem telas para cadeias: quem faz a chamada — GI ou o seu próprio agendador de backups — gerencia as operações. Portanto, as etapas abaixo descrevem ações sobre objetos sem referência a telas. O modelo do subsistema é descrito em Backup entre clusters.

Pré-requisitos​

  • privilégio 14002 (gerenciamento de cadeias de backup) — escopo no nível do cluster; o papel de administrador de VDC (data center virtual) não pode fazer essas requisições;
  • feature.backup em cluster.options no cluster de armazenamento de backup é 1; quando é 0, qualquer operação do subsistema retorna -25420;
  • versão do vStack Center — 3.0.5;
  • o cluster tem pelo menos um pool consumidor com um nó proprietário ativo e espaço livre suficiente para o backup;
  • todas as operações são endereçadas ao cluster de armazenamento de backup: as cadeias residem apenas nele.

Etapas​

Etapa 1. Criar uma cadeia​

Crie uma cadeia de backup no cluster de armazenamento de backup. Especifique apenas o nome da folha — sem o pool nem o prefixo .backup. O nome deve ter de 1 a 128 caracteres e ser composto por letras latinas, dígitos e os símbolos _, ., -. O cluster rejeita espaços, caracteres cirílicos, barras e @ com o código -25430. O próprio cluster seleciona o pool. Se o tamanho total do backup for conhecido com antecedência, forneça uma estimativa de tamanho. O cluster adiciona uma margem de 20 % para o crescimento da cadeia e exclui os pools com menos espaço livre do que esse total. Uma estimativa de 0 desativa o filtro.

Em resposta, o cluster retorna o caminho completo da cadeia no formato <pool>/.backup/<leaf>, junto com o pool selecionado e o endereço do nó proprietário desse pool.

Salve o caminho da cadeia nos seus próprios registros: todas as operações seguintes precisam dele, e o subsistema não tem como listar as cadeias do cluster. O pool e o endereço do nó são informativos — eles mostram a localização atual e não precisam ser armazenados.

Etapa 2. Abrir um receptor de fluxo​

Abra um receptor para a cadeia especificando o seu caminho completo. O tempo limite em segundos especifica por quanto tempo o receptor aguarda a conexão do remetente antes de fechar a porta.

A resposta chega imediatamente e contém os dados de conexão do receptor — o endereço do nó proprietário do pool e o número da porta alocada. É aqui que o remetente se conecta: o cluster de origem com a sua VM, ou outro cluster de armazenamento de backup que envia um ponto de restauração. Passe os dados de conexão ao remetente e conecte-se dentro do tempo limite: quando ele expira, a porta é fechada, e o receptor precisa ser aberto novamente.

Etapa 3. Excluir um ponto de restauração desatualizado​

A rotação remove um ponto de cada vez. Especifique o caminho da cadeia e o nome curto do snapshot — o sufixo após @, sem o caminho da cadeia.

A exclusão é idempotente: repetir uma requisição para um ponto que já foi excluído retorna a mesma resposta. A resposta não tem um indicador separado de que "o ponto existia e foi excluído", então não é necessário verificar antes se o snapshot existe.

Etapa 4. Excluir a cadeia inteira​

A exclusão de uma cadeia a remove junto com todos os pontos de restauração; eles não podem ser recuperados depois.

Essa operação também é idempotente. Após a exclusão, remova o caminho da cadeia salvo do seu catálogo: o cluster não tem mais nenhuma informação sobre a cadeia.

Verificar o resultado​

Verifique a resposta, mas interprete-a de acordo com a operação. Para a criação de cadeia e ambas as operações de exclusão, uma resposta bem-sucedida confirma que o trabalho foi concluído no nó: o caminho da cadeia para a criação, uma confirmação para a exclusão.

A recepção de fluxo segue uma regra diferente. O cluster aloca uma porta, repassa o comando ao agente de armazenamento no nó proprietário do pool e retorna imediatamente os dados de conexão. Portanto, uma resposta bem-sucedida confirma que o comando foi repassado e que os dados de conexão foram alocados — um endereço de nó não vazio e um número de porta —, e não que o fluxo já foi recebido. Os dados são de fato recebidos depois que o remetente se conecta a esse endereço e porta.

Não há uma operação de leitura separada para verificação. Uma forma indireta de verificar que uma cadeia foi excluída é abrir um receptor no seu caminho: a resposta -25432 confirma que a cadeia de fato não existe mais.

Solução de problemas​

-25420, o subsistema de backup está desativado. O feature.backup do cluster em cluster.options é 0. A chave se aplica ao cluster inteiro e é verificada antes de qualquer operação com pools, então esse código é retornado para qualquer uma das cinco operações. Solução alternativa — ative o subsistema neste cluster; tentar contorná-lo por meio de outra operação é inútil.

-25431 durante a criação, nenhum pool tem espaço livre suficiente. O cluster não encontrou nenhum pool consumidor com um nó proprietário ativo e espaço livre suficiente para a estimativa de tamanho mais a margem de 20 %. Um pool em que o backup mal cabe não atende a essa condição e também é excluído. A causa pode ser tanto a estimativa quanto o estado do cluster. Solução alternativa — refine a estimativa ou omita-a por completo, libere espaço no pool e verifique se os nós proprietários dos pools estão ativos.

-25430, caminho de cadeia ou nome de snapshot inválido. O caminho especificado não está no formato <pool>/.backup/<leaf>, ou o nome da cadeia ou do ponto de restauração contém caracteres fora do conjunto "letras latinas, dígitos, _, ., -". Essa verificação é intencional: apenas caminhos dentro de .backup são repassados aos nós; caso contrário, as operações de cadeia poderiam alcançar datasets de VMs. Solução alternativa — use o caminho completo exatamente como retornado na criação, em vez de construí-lo manualmente.

-25432, cadeia não encontrada. O caminho é válido, mas essa cadeia não existe no cluster — na maioria das vezes ela já foi excluída ou foi criada em outro cluster. Solução alternativa — confira o caminho com o seu catálogo e verifique a qual cluster a operação está endereçada.

-25434, o pool da cadeia está indisponível. A cadeia existe, mas o nó proprietário do seu pool não está respondendo. Os dados não foram perdidos: a operação ficará disponível quando o nó voltar. Solução alternativa — resolva o problema com o nó; o subsistema não pode mover a cadeia para outro pool.

-25436, a operação de cadeia falhou. Um código de falha genérico do nó. Ele abrange diferentes causas, que não podem ser distinguidas pelo código. Solução alternativa — tente a operação novamente; se a falha persistir, verifique o estado do nó proprietário do pool.

-78 durante a criação, erro de banco de dados. O dispatcher do cluster não conseguiu ler o mapa de pools para selecionar um local para a cadeia. A cadeia não foi criada, e o estado não mudou. Solução alternativa — tente a operação novamente; se a falha persistir, verifique o estado do dispatcher do cluster.

Veja também​

Métodos da API​

Operações de API abordadas nesta página: backup-dataset-create, backup-dataset-receive, backup-snapshot-remove, backup-dataset-remove — consulte a referência da API.