- Visão geral
- Requisitos
- Modelos de implantação
- Manual: preparando a instalação
- Manual: preparando a instalação
- Etapa 2: configuração do registro compatível com OCI para instalações offline
- Etapa 3: configuração do objectstore externo
- Etapa 4: configuração do High Availability Add-on
- Etapa 5: configuração de bancos de dados SQL
- Etapa 7: configuração do DNS
- Etapa 8: configuração dos discos
- Etapa 9: configuração dos ajustes do nível do kernel e do sistema operacional
- Etapa 10: configuração das portas do nó
- Etapa 11: aplicação de configurações diversas
- Etapa 12: validação e instalação dos pacotes RPM necessários
- Etapa 13: geração de cluster_config.json
- Amostra Cluster_config.json
- Configuração geral
- Configuração do perfil
- Configuração de Certificados
- Configuração do Banco de Dados
- Configuração externa do Objectstore
- Configuração de URL pré-assinada
- Configuração do ArgoCD
- Configuração da autenticação do Kerberos
- Configuração de registro externo compatível com OCI
- Disaster Recovery: configurações Ativo/Passivo e Ativo/Ativo
- Configuração do High Availability Add-on
- Configuração específica do Orchestrator
- Configuração específica do Insights
- Process Mining-specific configuration
- Configuração específica do Document Understanding
- Automation Suite Robots-specific configuration
- Configuração do monitoramento
- Opcional: configuração do servidor proxy
- Opcional: habilitação da resiliência a falhas zonais em um cluster de produção pronto para alta disponibilidade de vários nós
- Opcional: transmitindo resolv.conf personalizado
- Optional: Increasing fault tolerance
- Adicionando um nó de agente dedicado com suporte a GPU
- Adicionando um nó de agente dedicado para robôs do Automation Suite
- Etapa 15: configuração do registro temporário do Docker para instalações offline
- Etapa 16: validação dos pré-requisitos para a instalação
- Executando o uipathctl
- Manual: realizando a instalação
- Pós-instalação
- Administração de cluster
- Gerenciando produtos
- Introdução ao portal de administração do cluster
- Migração do Redis do High Availability Add-on no cluster para externo
- Migrating data between objectstores
- Migrating in-cluster objectstore to external objectstore
- Migração de um registro no cluster para um registro externo compatível com OCI
- Mudança para o cluster secundário manualmente em uma configuração Ativo/Passivo
- Disaster Recovery: executando operações pós-instalação
- Convertendo uma instalação existente para configuração multi-local
- Diretrizes sobre atualização de uma implantação Ativo/Passivo ou Ativo/Ativo
- Diretrizes sobre backup e restauração de uma implantação Ativo/Passivo ou Ativo/Ativo
- Escalando uma implantação de nó único (avaliação) para uma implantação de vários nós (HA)
- Monitoramento e alertas
- Migração e atualização
- Migração entre clusters do Automation Suite
- Atualizando o Automação Suite
- Download dos pacotes de instalação e obtenção de todos os arquivos no primeiro nó do servidor
- Recuperação da mais recente configuração aplicada do cluster
- Atualização da configuração de cluster
- Configuração do registro compatível com OCI para instalações offline
- Execução da atualização
- Realização de operações pós-atualização
- Configuração específica do produto
- Configuração avançada do Orchestrator
- Configuração de parâmetros do Orchestrator
- Configuração do AppSettings
- Configuração do tamanho máximo da solicitação
- Substituição da configuração de armazenamento no nível do cluster
- Configuração do NLog
- Salvando logs do robô no Elasticsearch
- Configuração dos repositórios de credenciais
- Configuração da chave de criptografia por tenant
- Limpeza do banco de dados do Orchestrator
- Ignorar a instalação da biblioteca do host
- Melhores práticas e manutenção
- Solução de problemas
- Como solucionar problemas dos serviços durante a instalação
- Como reduzir as permissões para um diretório de backup NFS
- Como desinstalar o cluster
- Como limpar os artefatos offline para melhorar o espaço em disco
- Como limpar os dados do Redis
- Como habilitar o registro em log do Istio
- Como limpar logs manualmente
- Alterando o modo somente leitura do Ceph
- Como limpar logs antigos armazenados no bucket do sf-logs
- Como desabilitar os logs de streaming para o AI Center
- Como depurar instalações do Automation Suite com falha
- Como excluir imagens do instalador antigo após a atualização
- Como desabilitar o descarregamento de soma de verificação do TX
- Como definir manualmente o nível de log do ArgoCD como Info
- Como expandir o armazenamento do AI Center
- Como gerar o pull_secret_value codificado para registros externos
- Como lidar com cifras fracas no TLS 1.2
- Como verificar a versão do TLS
- Como trabalhar com certificados
- Como agendar o backup e restaurar dados do Ceph
- Como coletar dados de uso de DU com objectstore (Ceph) no cluster
- Como instalar o RKE2 SELinux em ambientes air-gapped
- Como limpar backups diferenciados antigos em um servidor NFS
- Como implantar o Insights em um cluster habilitado para FIPS
- Como migrar para o Cgroup v2
- Como recuperar a autenticação do Kerberos após uma reinicialização da VM
- Como enviar uma imagem do Docker local para o registro no cluster
- Como excluir buckets do backup
- Erro ao baixar o pacote
- A instalação offline falha devido a um binário ausente
- Azure disk not marked as SSD
- Falha após a atualização do certificado
- Erros de validação de certificado TLS
- Antivírus causa problemas de instalação
- Automation Suite not working after OS upgrade
- O Automation Suite requer que backlog_wait_time seja definido como 0
- A instalação do registro temporário falha no RHEL 8.9
- Problema de reinício frequente em implantações de namespace uipath durante instalações offline
- Configurações de DNS não honradas pelo CoreDNS
- A geração de registros no cluster falha devido a memória insuficiente
- As verificações de pré-requisitos falham quando os projetos modernos do Document Understanding estão habilitados e o AI Center está desabilitado
- Upgrade fails due to unhealthy Ceph
- A atualização falha devido a objetos clássicos no banco de dados do Orchestrator
- Um cluster do Ceph foi encontrado em um estado degradado após atualização lado a lado
- A atualização do serviço falha para o Apps
- Tempos limite de atualização no local
- Falha de atualização em ambientes offline
- pod snapshot-controller-crds no estado CrashLoopBackOff após a atualização
- Falha de atualização devido aos tamanhos de PVC do Insights substituídos
- Falha de atualização devido ao nome de host em letra maiúscula
- Configurando um intervalo de tempo limite para os portais de gerenciamento
- Autenticação não funciona após migração
- 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
- Falha na operação GSSAPI devido a código de status inválido
- Alarme recebido para trabalho com falha do Kerberos-tgt-update
- Provedor de SSPI: servidor não encontrado no banco de dados Kerberos
- Falha de login para usuário do AD devido a conta desabilitada
- ArgoCD login failed
- 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
- O ArgoCD entra em estado Em andamento após a primeira instalação
- Pod de repositório do ArgoCD em CrashLoopBackOff
- Migreção manual do ArgoCD NetworkPolicy (GHSA-47m3-95c7-g2g8)
- Métricas Ceph-rook ausentes nos painéis de monitoramento
- Incompatibilidade em erros relatados durante as verificações de integridade do diagnóstico
- Configuração de solicitações e limites de recursos para cargas de trabalho criadas pelo uipathctl
- Nenhum problema upstream íntegro
- Inicialização do Redis bloqueada por antivírus
- Os pods do AI Center e do Document Understanding falham ao iniciar com a verificação do certificado TLS habilitada
- O Fluentd não exporta logs em ambientes IPv6
- O Studio Desktop não pode carregar conectores e atividades do Integration Service
- 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
- Execução de alta disponibilidade com o Process Mining
- Falha na ingestão do Process Mining ao fazer logon usando o Kerberos
- Não é possível conectar-se ao banco de dados AutomationSuite_ProcessMining_Warehouse usando uma string de conexão em formato pyodbc.
- A instalação do Airflow falha com sqlalchemy.exc.ArgumentError: não foi possível analisar o URL rfc1738 da string ''
- Como adicionar uma regra de tabela de IP para usar a porta 1433 do SQL Server
- O certificado do Automation Suite não é confiável para o servidor em que o CData Sync está sendo executado
- O Process Mining falha ao carregar após desabilitá-lo e reabilitá-lo
- Execução da ferramenta de diagnóstico
- Usando o pacote de suporte do Automation Suite
- Exploração de logs
Execute uma atualização lado a lado para o Automation Suite usando um ambiente paralelo para alternar o tráfego com segurança para um novo cluster.
A atualização lado a lado do Automation Suite permite que você execute operações de atualização com segurança usando um ambiente paralelo, em vez de atualizar no local.
Este método permite que os administradores alterem o tráfego do cluster antigo do Automation Suite (por exemplo, a implantação azul) para o novo cluster do Automation Suite (por exemplo, a implantação verde) após verificar a nova implantação. Se você detectar um problema, poderá reverter para a implantação antiga rapidamente.
Ao realizar uma atualização lado a lado, os dois clusters paralelos compartilham uma única licença.
Requisitos
- Se o AI Center estiver habilitado, certifique-se de atender aos requisitos do CUDA.
- Requisitos de hardware, dependendo do modelo que você escolheu:
- Atualização lado a lado (cluster de destino de tamanho idêntico) - Tanto o ambiente de origem quanto o de destino devem atender aos mesmos requisitos de hardware e software.
- Atualização lado a lado (início de nó único) - Você pode configurar um cluster de destino de nó único e, em seguida, dimensioná-lo. Certifique-se de atender aos requisitos de hardware sugeridos pela Calculadora de dimensionamento de instalação do Automation Suite com base em sua seleção de produtos e detalhes de uso.
- Requisitos de software: tanto o ambiente de origem quanto o de destino devem atender aos mesmos requisitos de hardware e software.
Migração de dados e responsabilidades
A tabela a seguir descreve o status da migração de dados e as responsabilidades de cada componente durante a atualização.
| Dados | Status | Responsabilidade |
|---|---|---|
| Sql | Mantido | Cliente |
| FQDN | Mantido; opcional Você deve escolher um novo FQDN para o novo cluster. Opcionalmente, você pode reverter para o FQDN anterior se necessário. | Cliente |
| Pacotes sob demanda | Não migrado Execute um script para ver quais pacotes estão no cluster. É necessária a geração manual. | Cliente |
| Certificados | Não migrado Você deve trazer certificados como parte da nova instalação do cluster. | Cliente |
| Configuração de cluster | Não migrado Você deve gerar cluster_config.json a partir do cluster de origem original para mapear os mesmos serviços para a nova instalação do cluster. | Cliente |
| Alertas e painéis personalizados criados pelos usuários | Não migrado Você deve reconfigurar os alertas e painéis personalizados após a atualização. | Cliente |
| Logs do aplicativo/configuração de streaming do Prometheus criada por usuários | Não migrado Você deve reconfigurar o log do aplicativo e o streaming do Prometheus. | Cliente |
| Cargas de trabalho dinâmicas | Depende do aplicativo Os trabalhos de treinamento do AI Center são perdidos; As habilidades são mantidas. | Habilidades (o script precisava ser executado após a atualização): UiPath® / Trabalhos de treinamento: cliente |
| Armazenamento de objeto | Mantido | Objectstore no cluster (Ceph): UiPath® / Objectstore externo: Cliente |
| Insights | Mantido | UiPath® |
| Dados do MongoDB | Mantido Os dados do MongoDB são movidos para o SQL de destino. | UiPath® |
| RabbitMQ | Não é necessário | UiPath® |
| Monitoramento (dados) | Não é necessário Os dados de monitoramento não se aplicam ao novo cluster. Se você não usar os componentes de monitoramento integrados, você deve configurar componentes de monitoramento externos após a atualização da migração. | N/A |
| Registro do Docker | Não é necessário Você deve instalar um registro do docker no cluster ou trazer um registro do docker externo. | N/A |
Visão geral do processo
Para realizar uma atualização lado a lado, conclua as seguintes etapas:
-
Prepare o novo cluster:
- Prepare o arquivo
cluster_config.json. - Instale seu novo cluster (infraestrutura e objectstore no cluster (se aplicável) apenas).
- Configure os certificados de CA adicionais.
- Prepare o arquivo
-
Migre os dados para o novo cluster:
- Preencha o registro do docker com as informações das imagens de atualização offline.
- Coloque o cluster no modo de manutenção.
- Clone seus bancos de dados do cluster de origem.
- Execute o script de migração de dados no cluster de origem.
- Se você configurou um objectstore externo, clone os buckets do objectstore.
-
Conclua a atualização:
- Edite o arquivo
cluster_config.jsonpara apontar para os bancos de dados e buckets clonados. - Execute o instalador no cluster de destino.
- Se você não forneceu os certificados durante a instalação, atualize-os após a instalação.
- Valide se o cluster de destino funciona conforme o esperado.
- Se você optar pela atualização lado a lado (cluster de destino de tamanho idêntico), poderá atualizar opcionalmente o FQDN do cluster de destino para corresponder ao FQDN do cluster de origem ou usar um novo FQDN. Se você optar pela atualização lado a lado (início único do nó), você pode atualizar o FQDN posteriormente.
- Habilite o backup no cluster de destino.
- Edite o arquivo
-
Dimensione o cluster de destino - aplicável apenas se você optou pela atualização lado a lado (início único do nó):
- Faça o backup do cluster de origem (recomendado).
- Adicione nós de servidor e agente semelhantes ao seu cluster de origem.
- Edite o arquivo
cluster_config.json. - Execute novamente o instalador para escalonar o cluster na configuração de alta disponibilidade.
- Opcionalmente, atualize o FQDN do cluster de destino para corresponder ao FQDN do cluster de origem ou use um novo FQDN.
Modelos de atualização lado a lado
Oferecemos dois modelos para atualizações lado a lado:
- Atualização lado a lado (cluster de destino de tamanho idêntico):
- Requer que o cluster de destino tenha os mesmos recursos de hardware que o cluster de origem.
- Pronto para o tráfego uma vez:
- A migração de dados foi concluída.
- As verificações de integridade foram bem-sucedidas.
- Atualização lado a lado (início de nó único):
- Inicia com uma configuração de nó único e, em seguida, escala até uma configuração de HA. Isso reduz os requisitos iniciais de hardware necessários para atualização lado a lado.
- O hardware para a configuração de nó único deve atender às recomendações da Calculadora de capacidade para a configuração de nó único.
- Para dimensionamento:
- Os nós do cluster de origem podem ser descontinuados e adicionados ao cluster de destino.
- Pronto para o tráfego uma vez:
- A migração de dados foi concluída.
- O cluster é dimensionado para vários nós.
- As verificações de integridade foram bem-sucedidas.
Você pode encontrar uma comparação entre os dois modelos na tabela a seguir:
| Atualização lado a lado (cluster de destino de tamanho idêntico) | Atualização lado a lado (início de nó único) | |
|---|---|---|
| Requisitos de Hardware | Requer hardware idêntico para clusters de origem e destino. | Começa com um hardware mínimo, escalando conforme necessário. |
| Downtime | Tempo de inatividade mínimo devido ao ambiente de destino totalmente redundante. | Maior tempo de inatividade devido a operações de dimensionamento dos nós. |
| Impacto no cluster de origem | Nenhum impacto. | Os nós de origem podem ser descontinuados e associados ao cluster de destino. |
| Processo de reversão | Reversão simples, pois a origem permanece intocada. | Se a operação de escalamento falhar no cluster de destino, a reversão envolverá a reintegração dos nós ao cluster de origem. |
| Impacto do custo | Custos mais altos devido à infraestrutura duplicada. | Custos mais baixos com requisitos iniciais de hardware reduzidos. |