automation-suite
2021.10
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white
Fora do período de suporte

Guia de instalação do Automation Suite

Última atualização 21 de nov de 2024

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.
  • 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.servicednf 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.servicechown -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 firewalldsystemctl 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/exportsecho "/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 -sexportfs -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": "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"
    }
  }
}{
  "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./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./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./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

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"
    }
  }
}{
  "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.
  • 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./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./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./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/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/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./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-trustsudo ./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./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./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./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/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/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./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-trustsudo ./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./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./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./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.

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.