Configuring the cluster snapshot backup

Configuring the cluster snapshot

Observação:

Before configuring the cluster, disable any scheduled snapshot. You can re-enable the schedules after the snapshot configuration.

Pré-requisitos:

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

Para configurar o snapshot do cluster:

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

2. Execute o seguinte comando:

   cd <installer directory>
   ./configureUiPathAS.sh snapshot config
   

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
-s, --agenda (opcional)	Forneça uma expressão cron para configurar um agendamento de snapshot. Click here to experiment with cron expressions.	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, --retenção (opcional)	Forneça o número de horas para reter o instantâneo.	Apenas para o backup de instantâneo	168h (sete dias)
-t, --alvo (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, --localização (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, --prefixo (opcional)	Forneça uma string para prefixar todos os backups de instantâneo agendados. A cadeia de caracteres fornecida deve estar em letras minúsculas.	N/A	schedule
-h, --ajuda	Exibe instruções de ajuda.	N/A	N/A
-d, --debug	Para executar no modo de depuração.	N/A	N/A

Exemplo

cd <installer directory>
./configureUiPathAS.sh snapshot config -s "*/45 * * * *" -r "48h" -t nfs -e 192.168.10.5 -l "/backup-store" --prefix "schedule"

Importante:

Note 1: Any cron expression provided as part of the --schedule parameter matches the time of the cluster node. We recommend you to sync the cron expression with the scheduled backup of your external data stores (such as SQL database and objectstore).

Note 2: Automation Suite stores only the snapshot backed-up during the defined retention policy. If your retention policy has a shorter duration, you may lose essential snapshots once retention policy applies. Similarly, if the retention policy has a longer duration, more snapshot are stored, which may take up space on the NFS server.

Note 3: Carefully consider the schedule setup. Taking snapshots at small intervals (for example, 30 minutes) implies frequent backup operations, forcing you to store the last 30-minutes data. Similarly, taking snapshots once a week can cause data loss, if a disaster occurs much later than the previous backup. Therefore, we strongly recommend the synchronization of the backup schedule and the retention duration with your Recovery Point Objective (RPO) requirements.

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 desabilitar não estiver habilitado.

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 você 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
   

Excluindo um backup

Importante:

Deleting a backup includes deleting the cluster metadata and the volume data from the backup storage server. This operation is irreversible.

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 você 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 você 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