Configuring the cluster snapshot backup

Configuring the cluster snapshot

Observação: antes de configurar o cluster, desative qualquer snapshot agendado. Você pode reativar os agendamentos após a configuração do instantâneo.

Pré-requisitos:

• Certifique-se de configurar o local de armazenamento do instantâneo.

Para configurar o instantâneo do cluster, siga as seguintes etapas:

1. Faça login em qualquer um dos nós do servidor.

2. Execute o seguinte comando:

   cd /opt/UiPathAutomationSuite/<version>/installer
   ./configureUiPathAS.sh snapshot config -i cluster_config.json

Para ver os sinalizadores disponíveis, anexe -h ao comando anterior.

A tabela a seguir lista os sinalizadores disponíveis e seu uso:

Sinalizadores de configuração	Description	quando usar	Valor padrão
-i, --input (obrigatório)	Restaurar arquivo de entrada	Restaurando o backup	N/A
-s, --schedule (opcional)	Forneça uma expressão cron para configurar um agendamento de snapshot. Clique aqui para experimentar com expressões cron.	Apenas para o backup de instantâneo	*/45 * * * *, o que significa que um instantâneo ocorre a cada 45 minutos. Por exemplo, o valor 0 0 * * 2 dispara um backup de instantâneos toda terça-feira às 00:00 horas.
-r, --retention (opcional)	Forneça o número de horas para reter o instantâneo.	Apenas para o backup de instantâneo.	168h (sete dias)
-t, --target (obrigatório)	Forneça o tipo de destino usado para armazenar o backup de captura instantânea.	Backup de instantâneo Restaurando o backup	NFS, que é o tipo suportado.
-e, --endpoint (obrigatório)	Forneça o FQDN ou o endereço IP do local de armazenamento do instantâneo. Por exemplo, mynfs.mycompany.com ou 192.23.222.81.	Backup de instantâneo Restaurando o backup	N/A
-l, --location (obrigatório)	Forneça o local ou o caminho para o local de armazenamento do instantâneo.	Backup de instantâneo Restaurando o backup	N/A
-p, --prefix (opcional)	Forneça uma string para prefixar todos os backups de captura instantânea agendados.	N/A	schedule
-h, --help	Exibe instruções de ajuda.	N/A	N/A
-d, --debug	Para executar no modo de depuração.	N/A	N/A

Exemplo

./configureUiPathAS.sh snapshot config -s "*/45 * * * *" -r "48h" -t nfs -e 192.168.10.5 -l "/asbackup" --prefix "schedule"

Importante:

Nota 1: Qualquer expressão cron fornecida como parte do parâmetro --schedule corresponde à hora do nó do cluster. Recomendamos que você sincronize a expressão cron com o backup agendado de seus armazenamentos de dados externos (como banco de dados SQL e objectstore).

Nota 2: O Automation Suite armazena apenas o backup do snapshot durante a política de retenção definida. Se sua política de retenção tiver uma duração menor, você poderá perder instantâneos essenciais quando a política de retenção for aplicada. Da mesma forma, se a política de retenção tiver uma duração maior, mais instantâneos serão armazenados, o que pode ocupar espaço no servidor NFS.

Nota 3: Considere cuidadosamente a configuração do cronograma. Tirar instantâneos em pequenos intervalos (por exemplo, 30 minutos) implica operações de backup frequentes, forçando você a armazenar os dados dos últimos 30 minutos. Da mesma forma, tirar instantâneos uma vez por semana pode causar perda de dados, se ocorrer um desastre muito depois do backup anterior. Portanto, recomendamos enfaticamente a sincronização do agendamento de backup e a duração da retenção com seus requisitos de objetivo de ponto de recuperação (RPO).

Enabling the snapshot backup

Para habilitar um backup agendado do seu instantâneo de cluster, siga as seguintes etapas:

1. Faça login em qualquer um dos nós do servidor.
2. Habilitar o backup de instantâneo:

   ./configureUiPathAS.sh snapshot backup enable

Observação:

• Se o prefixo do novo instantâneo já for usado por um instantâneo existente, ocorrerá um erro. Para evitar o erro, desabilite o referido instantâneo e execute novamente o comando na etapa 2.
• Se o backup agendado falhar devido a tempo limite e você receber uma notificação de alerta, execute novamente o comando na etapa 2 com o sinalizador --csi-snapshot-timeout 3h adicional para aumentar o tempo limite para 3 horas.

Disabling the snapshot backup

Para desabilitar o backup periódico de um snapshot de cluster:

1. Faça login em qualquer um dos nós do servidor.
2. Execute o seguinte comando:

   ./configureUiPathAS.sh snapshot backup disable

Observação: espere um erro se o backup que você deseja desativar não estiver ativado.

On-demand snapshot backup

Para criar um backup com base em um instantâneo, siga as seguintes etapas:

1. Faça login em qualquer um dos nós do servidor.
2. Criar o backup:

   ./configureUiPathAS.sh snapshot backup create <backup name>

Observação: substitua <backup name> por um nome exclusivo que deseja atribuir ao backup.

O gatilho de instantâneo é uma operação assíncrona. No entanto, você pode anexar o sinalizador –wait para aguardar até que o backup do instantâneo seja concluído.

./configureUiPathAS.sh snapshot backup create <backup name> --wait

Observação:

• Your retention policy does not delete on-demand snapshot backups. To avoid unnecessary storage consumption, delete on-demand backups manually.
• Se o backup falhar devido a tempo limite, execute novamente o comando na etapa 2 com o sinalizador --csi-snapshot-timeout 3h adicional para aumentar o tempo limite para 3 horas.

Listing existing snapshots

Para ver os backups existentes e seus status:

1. Faça login em qualquer um dos nós do servidor.
2. Execute o seguinte comando:

   ./configureUiPathAS.sh snapshot list

   Uma lista de todos os snapshots de cluster (sob demanda e programados) com seus status, tempos de criação e tempos de expiração é exibida:

   ./configureUiPathAS.sh snapshot list
   NAME           STATUS             CREATION                       EXPIRATION
   manualbackup1   Completed        2022-09-13 09:19:50 +0000 UTC  2023-09-13 09:19:50 +0000 UTC
   manualbackup2   PartiallyFailed  2022-09-13 09:19:50 +0000 UTC  2023-09-13 09:19:50 +0000 UTC

Deleting a backup

Importante: Excluir um backup inclui excluir os metadados do cluster e os dados do volume do servidor de armazenamento de backup. Esta operação é irreversível.

Para excluir backups de instantâneo do servidor de backup, execute o seguinte comando:

./configureUiPathAS.sh snapshot delete -h
Delete the snapshot backup

Usage:
  configureUiPathAS.sh snapshot delete (name | --all) [flags]

Flags:
  -a, --all                Delete all the snapshots
  -f, --force              Forcibly delete the snapshot without confirmation
  -h, --help               help for delete

Exemplos

Excluindo um instantâneo especificado

Este comando exclui o instantâneo especificado após receber sua confirmação.

./configureUiPathAS.sh snapshot delete <snapshot name>

Observação: substitua <snapshot name> pelo nome do backup que deseja excluir.

Excluindo silenciosamente um instantâneo especificado

Este comando exclui o instantâneo sem solicitar sua confirmação.

./configureUiPathAS.sh snapshot delete <snapshot name> --force

Observação: substitua <snapshot name> pelo nome do backup que deseja excluir silenciosamente.

Excluindo todos os instantâneos

Este comando exclui todos os instantâneos após receber sua confirmação.

./configureUiPathAS.sh snapshot delete --all

Excluindo silenciosamente todos os instantâneos

Este comando exclui todos os instantâneos existentes sem solicitar sua confirmação.

./configureUiPathAS.sh snapshot delete --all --force