- Visão geral
- Requisitos
- Instalação
- Perguntas e respostas: modelos de implantação
- Baixando pacotes de instalação
- Parâmetros do install-uipath.sh
- Como habilitar o High Availability Add-on do Redis para o cluster
- Arquivo de configuração do Document Understanding
- Adicionando um nó de agente dedicado com suporte a GPU
- Conexão do aplicativo Task Mining
- Adição de um nó de agente dedicado ao Task Mining
- Pós-instalação
- Administração de cluster
- Gerenciando produtos
- Backup e restauração do cluster
- Monitoramento e alertas
- Migração e atualização
- Modo online de avaliação de nó único
- Modo offline de avaliação de nó único
- Modo de produção online pronto para alta disponibilidade de vários nós
- Modo de produção offline pronto para alta disponibilidade de vários nós
- Migrando o disco físico do Longhorn para o LVM
- Fazendo downgrade do Ceph de 16.2.6 para 15.2.9
- Opções de migração
- B) Migração de um único tenant
- Configuração específica do produto
- Melhores práticas e manutenção
- Solução de problemas
- Como solucionar problemas dos serviços durante a instalação
- Como desinstalar o cluster
- Como limpar os artefatos offline para melhorar o espaço em disco
- How to disable TLS 1.0 and 1.1
- Como habilitar o registro em log do Istio
- Como limpar logs manualmente
- Como limpar logs antigos armazenados no bucket do sf-logs
- Como depurar instalações do Automation Suite com falha
- Como desabilitar o descarregamento de soma de verificação do TX
- Não é possível executar uma instalação offline no SO RHEL 8.4
- Erro ao baixar o pacote
- A instalação offline falha devido a um binário ausente
- Problema de certificado na instalação offline
- Erro de validação da string de conexão ao SQL
- Falha após a atualização do certificado
- O Automation Suite requer que Backlog_wait_time seja definido como 1
- Não é possível fazer login após a migração
- Configurando um intervalo de tempo limite para os portais de gerenciamento
- Atualizar as conexões de diretório subjacentes
- kinit: não é possível encontrar o KDC para o realm <AD Domain> ao obter credenciais iniciais
- kinit: o Keytab não contém chaves adequadas para *** ao obter credenciais iniciais
- A operação do GSSAPI falhou com erro: um código de status inválido foi fornecido (as credenciais do cliente foram revogadas).
- Falha do login para o usuário <ADDOMAIN><aduser> Motivo: a conta está desabilitada.
- Alarme recebido para tarefa Kerberos-tgt-update com falha
- Provedor SSPI: servidor não encontrado no banco de dados Kerberos
- Falha ao obter a imagem do sandbox
- Os pods não são exibidos na UI do ArgoCD
- Falha de teste do Redis
- O servidor RKE2 falha ao iniciar
- Segredo não encontrado no namespace da UiPath
- O ArgoCD entra em estado Em andamento após a primeira instalação
- Inconsistência inesperada; execute o fsck manualmente
- Operador de autocura ausente e repositório Sf-k8-utils ausente
- MongoDB degradado ou aplicativos de negócios após a restauração do cluster
- Serviços não íntegros após restauração ou reversão do cluster
- O Document Understanding não está no menu de navegação esquerdo do Automation Suite
- Status de Falha ao criar uma sessão de rotulagem de dados
- Status de Falha ao tentar implantar uma habilidade de ML
- Trabalho de migração falha no ArgoCD
- Reconhecimento de escrita com o Extrator de formulários inteligente não está funcionando
- Usando a ferramenta de diagnóstico do Automation Suite
- Usando o pacote de suporte do Automation Suite
- Exploração de logs
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.
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.
- 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.
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.
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
dnf install nfs-utils -y
systemctl start nfs-server.service
systemctl enable nfs-server.service
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
chown -R nobody: "/datadisk"
chmod -R 777 "/datadisk"
systemctl restart nfs-utils.service
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
systemctl stop firewalld
systemctl disable firewalld
/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
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
exportfs -arv
exportfs -s
- 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
eInsights
.
backup.json
. Certifique-se de preenchê-lo com base nas definições de campo abaixo.
{
"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.
/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"
}
}
}
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
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
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
- 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
.
- 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
eagent
que o Cluster de Backup. -
O cluster de restauração deve ter os mesmos recursos de nós
server
eagent
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
Apenas faça download dosf-installer
zip e forneçachmod -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
Apenas faça download dosf-installer
zip esf-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
Apenas faça download dosf-installer
zip e forneçachmod -R 755 <sf_installer_folder>
para pasta extraída.Modo de produção offline pronto para alta disponibilidade
Apenas faça download dosf-installer
zip esf-infra-bundle.tar.gz
.chmod -R 755 <sf_installer_folder>
para pasta extraída.Crie um arquivo e chame-o derestore.json
. Certifique-se de preenchê-lo com base nas definições de campo a seguir.
{
"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ó únicofixed_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
— Usetrue
oufalse
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 arquivocluster_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 cometcdBackupPath
.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 nocluster_config.json
e é 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 arquivocluster_config.json
e é necessário para a instalação do registro do docker.
Etapa 3.1: Restaurando etcd
no nó principal do cluster
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
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
Etapa 3.3: Restaurando etcd
em nós de agente do cluster
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
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
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-trust
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 .
Etapa 3.1: Restaurando etcd
no nó principal do cluster
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 etcd
em nós de agente do cluster
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
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
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-trust
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 .
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:
Para atualizar o servidor NFS, faça o seguinte:
- Execute novamente as seguintes etapas:
- Atualize as informações do servidor NFS e inclua o novo
nfs.endpoint
nos arquivosbackup.json
erestore.json
.
Para adicionar um novo nó ao cluster, execute novamente as seguintes etapas:
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.
orchestrator
pods.
- Terminologia
- Pré-requisitos do ambiente
- Etapa 1: Configurando o servidor NFS externo
- Requisitos
- Etapa 1.1: Instalando bibliotecas NFS
- Etapa 1.2: Configurando o caminho de montagem
- Etapa 1.3: Desativando o firewall
- Etapa 1.4: Permitir acesso ao caminho de montagem NFS para todos os nós de backup e restauração
- Etapa 2: habilitar o backup de cluster
- Backup.json
- Etapa 2.1: habilitando o backup no nó primário do cluster
- Etapa 2.2: habilitando o backup em nós secundários do cluster
- Etapa 2.3: habilitando o backup em nós de agente do cluster
- Etapa 3: Configurando o cluster de restauração
- Restaurar requisitos de cluster
- Restore.json
- Instalação online
- Instalação offline
- Desativando o backup de cluster
- Configurações adicionais
- Atualizando o servidor NFS
- Adicionando um novo nó ao cluster
- Problemas conhecidos
- Restauração do Redis
- O pod do visualizador de insights falha ao iniciar após a restauração