Backup e restauração do cluster

Para usar a funcionalidade de backup e restauração, você precisa habilitar um servidor NFS, o cluster de backup e o cluster de restauração.Todos os três são definidos abaixo.

Terminologia

O Servidor NFS é o servidor que armazena os dados de backup e facilita a restauração. É possível configurar o servidor NFS em qualquer máquina ou um serviço PaaS oferecido por provedores de nuvem. Observe que não oferecemos suporte a NFS baseado em Windows e NFS baseado em blob do Azure.

O cluster de backup é onde o Automation Suite está instalado. Isso se refere ao cluster que você configurou durante a instalação.

O cluster de restauração o cluster no qual você deve restaurar todos os dados do cluster de backup.Esse cluster se torna o novo cluster no qual você executa o Automation Suite após a conclusão da restauração.

As etapas a seguir mostram como configurar todos os três.

Pré-requisitos do ambiente

Importante:

• Esta etapa não habilitará um backup para nenhum backup de fonte de dados externa (SQL Server).Você precisa habilitar o backup da fonte de dados externa separadamente.
• Não oferecemos suporte a backup e restauração entre zonas.

Baixando pacotes de instalação

• O servidor NFS deve ser acessível a partir de todos os nós do cluster (clusters de backup e restauração).
• O cluster do qual você deseja fazer backup e o servidor NFS devem estar na mesma região.
• Antes da restauração do cluster, certifique-se de desabilitar o backup conforme descrito em Desativando o backup de cluster

• Certifique-se de habilitar as seguintes portas:

  Porta	Protocol	Origem	Destino	Finalidade	Requisitos
  2049, 111	TCP	Servidor NFS	Todos os nós no cluster de backup	Sincronização de dados entre o cluster de backup e o servidor NFS	Essa comunicação deve ser permitida do servidor NFS para o nó do cluster de backup antes de executar a Etapa 2: Habilitar o backup do cluster.
  2049, 111	TCP	Todos os nós no cluster de backup	Servidor NFS	Sincronização de dados entre o cluster de backup e o servidor NFS	Essa comunicação deve ser permitida do nó do cluster de backup para o servidor NFS antes de executar a Etapa 2: Habilitar o backup do cluster.
  2049, 111	TCP	Servidor NFS	Todos os nós no cluster de restauração	Sincronização de dados entre o NFS Server e o cluster de restauração	Esta comunicação deve ser permitida do servidor NFS para restaurar o nó do cluster antes de executar a Etapa 3: Configuração do cluster de restauração.
  2049, 111	TCP	Todos os nós no cluster de restauração	Servidor NFS	Sincronização de dados entre o cluster de backup e o servidor NFS	Essa comunicação deve ser permitida do servidor NFS para o nó do cluster de backup antes de executar a Etapa 3: Configuração do cluster de restauração.

Etapa 1: Configurando o servidor NFS externo

Requisitos

O servidor NFS deve atender aos seguintes requisitos:

• É possível configurar o servidor NFS em qualquer máquina e qualquer sistema operacional de sua escolha ou, alternativamente, usar qualquer serviço PaaS oferecido por provedores de nuvem. Observe que não oferecemos suporte a NFS baseado em Windows e NFS baseado em blob do Azure.

• A versão do servidor NFS deve ser NFSv4 no Linux.

• O servidor NFS deve ser executado fora do cluster de backup e do cluster de restauração.

• O tamanho do disco do Servidor NFS deve ser maior que o tamanho do disco de dados do nó do servidor primário.

Consulte Requisitos de hardware para obter mais detalhes.

Etapa 1.1: Instalando bibliotecas NFS

Importante: Ignore a Etapa 1.1 se você já tiver um servidor NFS.

Instale a biblioteca nfs-utils no nó que você planeja usar como servidor NFS.

dnf install nfs-utils -y
systemctl start nfs-server.service
systemctl enable nfs-server.service

Etapa 1.2: Configurando o caminho de montagem

Configure o caminho de montagem que você deseja expor a partir do servidor NFS.

chown -R nobody: "/datadisk"
chmod -R 777 "/datadisk"
systemctl restart nfs-utils.service

Etapa 1.3: Desativando o firewall

Firewalld é uma biblioteca de segurança que gerencia regras de rede e firewall.

Consulte a documentação oficial da Firewalld para obter mais detalhes.

Para desabilitar a Firewalld, execute o seguinte comando.

systemctl stop firewalld
systemctl disable firewalld

Etapa 1.4: Permitir acesso ao caminho de montagem NFS para todos os nós de backup e restauração

Todos os nós devem poder acessar o caminho de montagem do NFS. No servidor NFS, vá para o arquivo /etc/exports, e adicione uma entrada para o FQDN para cada nó (tanto servidor quanto agente) para ambos, Cluster de Backup e o Cluster de Restauração.

Abaixo está um exemplo de como adicionar uma entrada, onde a entrada abaixo especifica o FQDN de uma máquina e as permissões correspondentes nessa máquina:

echo "/datadisk sfdev1868610-d053997f-node.eastus.cloudapp.azure.com(rw,sync,no_all_squash,root_squash)" >> /etc/exports

Em seguida, execute o seguinte comando para exportar o caminho de montagem:

exportfs -arv
exportfs -s

Etapa 2: habilitar o backup de cluster

Importante:

• Certifique-se de ter seguido a etapa Pré-requisitos do ambiente.
• Certifique-se de fazer backup do arquivo cluster_config.json usado para instalação.
• Esta etapa não habilitará o backup para nenhum backup de fonte de dados externa (como o SQL Server).Você precisa habilitar o backup de fonte de dados externa separadamente.
• Não é recomendado reduzir o intervalo de backup para menos de 15 minutos.
• O Automation Suite não faz backup de todos os Volumes Persistentes, como os volumes anexados ao pipeline de treinamento no AI Center. Um backup é criado apenas para alguns Volumes Persistentes, como Alert Manager, Prometheus, Docker Registry, MongoDB, RabbitMQ, Ceph Objectstore e Insights.

Crie um arquivo e chame-o de backup.json. Certifique-se de preenchê-lo com base nas definições de campo abaixo.

Backup.json

{
  "backup": {
    "etcdBackupPath": "PLACEHOLDER",
    "nfs": {
      "endpoint": "PLACEHOLDER",
      "mountpath": "PLACEHOLDER"
    }
  },
  "backup_interval": "15"
}

• backup.etcdBackupPath — o caminho relativo onde os dados de backup serão armazenados no servidor NFS.
• backup.nfs.endpoint — o ponto de extremidade do servidor NFS (endereço IP ou nome DNS).
• backup.nfs.mountpath — Caminho no servidor NFS (ponto de extremidade)
• backup_interval — O intervalo de tempo de backup em minutos.

No exemplo a seguir, os dados de backup serão armazenados sob /datadisk/backup/cluster0 no servidor NFS:

{
  "backup": {
    "etcdBackupPath": "cluster0",
    "nfs": {
      "endpoint": "20.224.01.66",
      "mountpath": "/datadisk"
    }
  }
}

Etapa 2.1: habilitando o backup no nó primário do cluster

Para habilitar o backup no nó primário do cluster, execute o seguinte comando:

./install-uipath.sh -i backup.json -o output.json -b --accept-license-agreement

Etapa 2.2: habilitando o backup em nós secundários do cluster

Para habilitar o backup em nós secundários do cluster, execute o seguinte comando no nó do agente:

./install-uipath.sh -i backup.json -o output.json -b -j server --accept-license-agreement

Etapa 2.3: habilitando o backup em nós de agente do cluster

Para habilitar o backup nos nós do agente do cluster, execute o seguinte comando:

./install-uipath.sh -i backup.json -o output.json -b -j agent --accept-license-agreement

Etapa 3: Configurando o cluster de restauração

Importante:

• Certifique-se de que o backup esteja desabilitado antes de restaurar o cluster. Consulte Desabilitar o backup do cluster.
• Certifique-se de que o pacote wget, unzip, jq esteja disponível em todos os nós de restauração.
• Certifique-se de ter seguido a etapa Pré-requisitos do ambiente.
• Toda fonte de fonte de dados externa deve ser a mesma (SQL Server).
• Reinicie o servidor NFS antes da restauração do cluster.Execute o seguinte comando no nó de servidor NFS: systemctl restart nfs-server.

Restaurar requisitos de cluster

• O cluster de restauração deve ter o mesmo fqdn que o cluster de backup.
• O Cluster de Restauração deve ter o mesmo número de nós server e agent que o Cluster de Backup.
• O cluster de restauração deve ter os mesmos recursos de nós server e agent que o Cluster de Backup, conforme mostrado abaixo:
  • Configuração de hardware para CPU
  • Configuração de hardware para memória
  • Configuração de hardware para espaço em disco

  • Hostname do nó

    Tipo de Instalação	Instruções de Instalação	Requisitos
    Modo online de avaliação de nó único	Configuração das máquinas Configuração do DNS Instalação offline de avaliação de nó único	Apenas faça download do sf-installerzip e forneça chmod -R 755 <sf_installer_folder>para pasta extraída. chmod -R 755 <sf_installer_folder>para pasta extraída.
    Modo offline de avaliação de nó único	Configuração das máquinas Configuração do DNS Instalação offline de avaliação de nó único	Apenas faça download do sf-installerzip e sf-infra-bundle.tar.gz. chmod -R 755 <sf_installer_folder>para pasta extraída.
    Modo de produção online pronto para alta disponibilidade de vários nós	Configuração das máquinas Instalação offline de produção pronta para alta disponibilidade de vários nós	Apenas faça download do sf-installerzip e forneça chmod -R 755 <sf_installer_folder>para pasta extraída.
    Modo de produção offline pronto para alta disponibilidade	Configuração das máquinas Instalação offline de produção pronta para alta disponibilidade de vários nós	Apenas faça download do sf-installerzip e sf-infra-bundle.tar.gz. chmod -R 755 <sf_installer_folder>para pasta extraída.

    Crie um arquivo e chame-o de restore.json. Certifique-se de preenchê-lo com base nas definições de campo a seguir.

Restore.json

{
  "fixed_rke_address": "PLACEHOLDER",
  "gpu_support": false,
  "fqdn": "PLACEHOLDER",
  "rke_token": "PLACEHOLDER",
  "restore": {
    "etcdRestorePath": "PLACEHOLDER",
    "nfs": {
      "endpoint": "PLACEHOLDER",
      "mountpath": "PLACEHOLDER"
    }
  },
  "infra": {
    "docker_registry": {
      "username": "PLACEHOLDER",
      "password": "PLACEHOLDER"
    }
  }
}

• fqdn — O FQDN do balanceador de carga para o modo de produção pronto para alta disponibilidade de vários nós ou o FQDN da máquina para o modo de avaliação de nó único
• fixed_rke_address — O fqdn do balanceador de carga, se estiver configurado, caso contrário, é o fqdn do primeiro nó do servidor de restauração.Usado para balancear a carga de registro de nó e de solicitação de API do kube. Consulte Endereço fixo e Configuração do balanceador de carga para obter mais informações.
• gpu_support — Use true ou false para habilitar ou desabilitar o suporte a GPU para o cluster (use se você tiver nós de agente com GPUs).
• rke_token — Este é um segredo pré-compartilhado específico do cluster. Este deve ser o mesmo que o cluster de Backup e pode ser encontrado no arquivo cluster_config.json.É necessário para todos os nós que ingressam no cluster.
• restore.etcdRestorePath — Caminho onde os dados de backup são armazenados para o cluster no NFS Server.Configurado no Backup com etcdBackupPath.
• restore.nfs.endpoint— Endpoint do servidor NFS.
• restore.nfs.mountpath: Caminho de montagem do servidor NFS.
• infra.docker_registry.username — O nome de usuário que você definiu no cluster de backup.Ele pode ser encontrado no cluster_config.jsone é necessário para o registro do docker.
• infra.docker_registry.password — A senha que você definiu no Cluster de Backup. Ele pode ser encontrado no arquivo cluster_config.json e é necessário para a instalação do registro do docker.

Instalação online

Etapa 3.1: Restaurando etcd no nó principal do cluster

Para restaurar etcd no nó principal do cluster, execute o seguinte comando:

./install-uipath.sh -i restore.json -o output.json -r --accept-license-agreement --install-type online

Etapa 3.2: Restaurando etcd em nós secundários do cluster

Para restaurar etcd nos nós secundários do cluster, execute o seguinte comando:

./install-uipath.sh -i restore.json -o output.json -r -j server --accept-license-agreement --install-type online

Importante: a função dos nós é obrigatória para todos os nós do servidor secundário.

Etapa 3.3: Restaurando etcdem nós de agente do cluster

Para restaurar etcd nos nós do agente do cluster, execute o seguinte comando:

./install-uipath.sh -i restore.json -o output.json -r -j agent --accept-license-agreement --install-type online

Etapa 3.4: Desativando o modo de manutenção

Observação: esta etapa é necessária apenas se a restauração fizer parte da operação de reversão durante o upgrade.

Após a restauração de etcd estar concluída, certifique-se de desabilitar o modo de manutenção:

/path/to/old-installer/configureUiPathAS.sh disable-maintenance-mode

Para verificar se o modo de manutenção está desabilitado, execute o seguinte comando:

/path/to/old-installer/configureUiPathAS.sh is-maintenance-enabled

Etapa 3.5: Execução da restauração do volume no nó primário

Após a restauração de etcd estar concluída, execute a restauração do volume no nó primário usando o seguinte comando:

./install-uipath.sh -i restore.json -o output.json -r --volume-restore --accept-license-agreement --install-type online

Etapa 3.6: Instalação do certificado de cluster do Automation Suite no nó primário de restauração

sudo ./configureUiPathAS.sh tls-cert get --outpath /opt/
cp /opt/ca.crt /etc/pki/ca-trust/source/anchors/
update-ca-trust

Habilitação do AI Center no cluster restaurado

Após restaurar um cluster do Automation Suite com o AI Center™ habilitado, siga as etapas do procedimento Habilitar o AI Center no cluster restaurado .

Instalação offline

Etapa 3.1: Restaurando etcd no nó principal do cluster

Para restaurar etcd no nó principal do cluster, execute o seguinte comando:

./install-uipath.sh -i restore.json -o output.json -r --offline-bundle "/uipath/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Etapa 3.2: Restaurando etcd em nós secundários do cluster

./install-uipath.sh -i restore.json -o output.json -r -j server --offline-bundle "/uipath/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Etapa 3.3: Restaurando etcdem nós de agente do cluster

Para restaurar etcd nos nós do agente do cluster, execute o seguinte comando:

./install-uipath.sh -i restore.json -o output.json -r -j agent --offline-bundle "/uipath/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Etapa 3.4: Desativando o modo de manutenção

Observação: esta etapa é necessária apenas se a restauração fizer parte da operação de reversão durante o upgrade.

Após a restauração de etcd estar concluída, certifique-se de desabilitar o modo de manutenção:

/path/to/old-installer/configureUiPathAS.sh disable-maintenance-mode

Para verificar se o modo de manutenção está desabilitado, execute o seguinte comando:

/path/to/old-installer/configureUiPathAS.sh is-maintenance-enabled

Etapa 3.5: Execução da restauração do volume no nó primário

Após a restauração de etcd estar concluída, execute a restauração do volume no nó primário usando o seguinte comando:

./install-uipath.sh -i restore.json -o ./output.json -r --volume-restore --accept-license-agreement --install-type offline

Etapa 3.6: Instalação do certificado de cluster do Automation Suite no nó primário de restauração

sudo ./configureUiPathAS.sh tls-cert get --outpath /opt/
cp /opt/ca.crt /etc/pki/ca-trust/source/anchors/
update-ca-trust

Habilitação do AI Center no cluster restaurado

Após restaurar um cluster do Automation Suite com o AI Center™ habilitado, siga as etapas do procedimento Habilitar o AI Center no cluster restaurado .

Desativando o backup de cluster

Importante: você pode habilitar o backup do cluster para salvar dados em um horário especificado usando o parâmetro backup_interval. A desativação do backup de cluster causará perda de dados que foram criados entre a última execução agendada e o momento em que você desativou o backup.

Para desabilitar o backup, execute os seguintes comandos nesta ordem:

1. Desabilite o backup no nó primário do cluster.

   ./install-uipath.sh -i backup.json -o output.json -b --disable-backup --accept-license-agreement

2. Desabilite o backup em nós secundários do cluster.

   ./install-uipath.sh -i backup.json -o output.json -b -j server --disable-backup --accept-license-agreement

3. Desabilite o backup nos nós do agente do cluster.

   ./install-uipath.sh -i backup.json -o output.json -b -j agent --disable-backup --accept-license-agreement

Configurações adicionais

Atualizando o servidor NFS

Importante: certifique-se que o backup esteja desabilitado antes de atualizar o servidor NFS. Consulte Desabilitar o backup do cluster para obter mais detalhes.

Para atualizar o servidor NFS, faça o seguinte:

1. Execute novamente as seguintes etapas:
   1. Etapa 1: Configurando o servidor NFS externo
   2. Etapa 2: Configurando o cluster de backup
   3. Etapa 3: Configurando o cluster de restauração
2. Atualize as informações do servidor NFS e inclua o novo nfs.endpointnos arquivos backup.json e restore.json.

Adicionando um novo nó ao cluster

Para adicionar um novo nó ao cluster, execute novamente as seguintes etapas:

1. Etapa 1: Configurando o servidor NFS externo
2. Etapa 2: Configurando o cluster de backup

Problemas conhecidos

Restauração do Redis

A restauração do Redis falha quando a restauração é executada, portanto, você precisa executar algumas etapas adicionais.

Siga as etapas na seção Solução de problemas.

Importante: depois que o Redis for restaurado, certifique-se de reiniciar orchestratorpods.

O pod do visualizador de insights falha ao iniciar após a restauração

Você pode corrigir esse problema excluindo o pod do Looker do aplicativo Insights na interface do usuário do ArgoCD. A implantação criará um novo pod que deve iniciar com êxito.