- Visão geral
- Requisitos
- Recomendado: modelos de implantação
- Manual: preparando a instalação
- Manual: preparando a instalação
- Etapa 1: Configuração do registro compatível com OCI para instalações offline
- Etapa 2: configuração do objectstore externo
- Etapa 3: configuração do High Availability Add-on
- Etapa 4: configuração do Microsoft SQL Server
- Etapa 5: configuração do balanceador de carga
- Etapa 5: configuração do DNS
- Etapa 7: configuração dos discos
- Etapa 8: ajuste das configurações no nível do kernel e do sistema operacional
- Etapa 9: configuração das portas do nó
- Etapa 10: 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
- Configuração de Certificados
- Configuração do Banco de Dados
- Configuração externa do Objectstore
- Configuração de URL pré-assinada
- 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
- Parâmetros do install-uipath.sh
- Adicionando um nó de agente dedicado com suporte a GPU
- Adição de um nó de agente dedicado ao Task Mining
- Conexão do aplicativo Task Mining
- 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
- Manual: realizando a instalação
- Pós-instalação
- Administração de cluster
- Gerenciando produtos
- Introdução ao portal de administração do cluster
- Migrating objectstore from persistent volume to raw disks
- Migração do High Availability Add-on no cluster para externo
- Migrating data between objectstores
- Migrating in-cluster objectstore to external objectstore
- Migração 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
- Redirecionamento do tráfego dos serviços não compatíveis para o cluster principal
- Monitoramento e alertas
- Migração e atualização
- Etapa 1: mover os dados da organização do Identity, de independente para o Automation Suite
- Etapa 2: restauração do banco de dados de produtos independente
- Etapa 3: backup do banco de dados da plataforma no Automation Suite
- Etapa 4: mesclando organizações no Automation Suite
- Etapa 5: atualização das strings de conexão do produto migradas
- Etapa 6: migração do Orchestrator independente
- Etapa 7: migração do Insights independente
- Etapa 8: exclusão do tenant padrão
- B) Migração de um único tenant
- Migração do Automation Suite no Linux para o Automation Suite no EKS/AKS
- 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
- Uso da ferramenta de configuração do Orchestrator
- Configuração de parâmetros do Orchestrator
- Configurações de aplicativo 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 dos repositórios de credenciais
- Configuração da chave de criptografia por tenant
- Limpeza do banco de dados do Orchestrator
- 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
- Como limpar os dados do Redis
- Como habilitar o registro em log do Istio
- Como limpar logs manualmente
- 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 atualizar do Automation Suite 2022.10.10 e 2022.4.11 para 2023.10.2
- 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
- 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
- First installation fails during Longhorn setup
- Erro de validação da string de conexão ao SQL
- Verificação de pré-requisito para o módulo iscsid do selinux falha
- Azure disk not marked as SSD
- Falha após a atualização do certificado
- 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
- Não é possível montar o volume devido a não estar pronto para cargas de trabalho
- Falha na coleta de logs do pacote de suporte
- A cadeia de caracteres de conexão SQL da Automação de Teste é ignorada
- A atualização de nó único falha no estágio de malha
- Cluster unhealthy after automated upgrade from 2021.10
- Upgrade fails due to unhealthy Ceph
- RKE2 não é iniciado devido a um problema de espaço
- O volume não pode ser montado e permanece no estado de loop anexar/desanexar
- 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
- Um componente sem integridade do Insights causa uma falha na migração
- A atualização do serviço falha para o Apps
- Tempos limite de atualização no local
- Migração de registro do Docker presa no estágio de exclusão do PVC
- Falha no provisionamento do AI Center após a atualização para a 2023.10
- Falha de atualização em ambientes offline
- A validação de SQL falha durante a atualização
- pod snapshot-controller-crds no estado CrashLoopBackOff após a atualização
- Erro de upgrade/reinstalação do endpoint da API REST do Longhorn
- 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
- Atualizar as conexões de diretório subjacentes
- 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
- Pods de MongoDB em CrashLoopBackOff ou provisionamento de PVC pendente após exclusão
- Unhealthy services after cluster restore or rollback
- Pods presos em Init:0/X
- Métricas Ceph-rook ausentes nos painéis de monitoramento
- Os pods não podem se comunicar com o FQDN em um ambiente de proxy
- 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
- Após a recuperação de desastres, o Dapr não está funcionando corretamente para Process Mining e Task Mining
- 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
- Execução da ferramenta de diagnóstico
- Usando a ferramenta de pacote de suporte do Automation Suite
- Exploração de logs
Atualizando o Automação Suite
-
O Automation Suite 2023.4.5 e 2023.10.2 incluem uma atualização para o Kubernetes 1.26.11. Dessa forma, ao atualizar o Automation Suite, você deve certificar-se de não fazer o downgrade do Kubernetes. Para fazer isso, ao migrar do Automation Suite 2023.4.5 ou de uma versão menor posterior para a próxima versão principal, você deve fazer atualização para a versão 2023.10.2 no mínimo.
-
Para os caminhos de atualização disponíveis, consulte Caminhos de atualização do Automation Suite.
-
Se você planeja atualizar a partir do Automation Suite 2022.10 ou anterior e o Process Mining estiver habilitado, deverá migrar aplicativos de processos para o novo layout de gráfico do processo antes de iniciar a atualização.
-
Se você atualizar de uma versão do Automation Suite instalada em uma máquina com FIPS 140-2 desabilitado, poderá habilitar o FIPS 140-2 seguindo as instruções em Segurança e conformidade.
-
Certifique-se de atender aos requisitos de hardware e software para a nova versão do Automation Suite. Se o AI Center estiver habilitado, certifique-se de atender aos requisitos do CUDA.
-
Certifique-se de seguir as práticas recomendadas de atualização do Automation Suite e execute o processo de atualização que melhor se adeque às suas necessidades.
O Automation Suite oferece suporte a dois processos de atualização:
-
Atualização no local
-
Atualização lado a lado
O processo de atualização no local do Automation Suite permite migrar para uma nova versão do Automation Suite mantendo suas configurações e dados intactos no mesmo hardware.
-
No processo de atualização no local, primeiro você atualiza o Kubernetes e outros componentes de infraestrutura, e depois atualiza os componentes compartilhados e os serviços dos produtos UiPath®.
-
Em caso de falha de hardware sem recuperação durante o processo de atualização, é necessário reverter para a versão anterior usando o recurso de backup e restauração.
A atualização lado a lado do Automation Suite se beneficia de uma experiência de atualização corporativa, que geralmente é chamada de azul-verde e é um processo padrão em todo o setor.
-
A atualização lado a lado permite que você execute uma 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 (ou seja, a implantação azul) para o novo cluster do Automation Suite (ou seja, a implantação verde) após verificar a nova implantação. Se você detectar um problema, poderá reverter rapidamente para a implantação antiga.
Recursos |
Mecanismo de atualização | |
---|---|---|
Atualização no local |
Atualização lado a lado | |
Atualização para uma nova versão LTS |
|
|
Atualizar a partir de qualquer versão suportada |
1 |
2 |
Migração de dados de alta fidelidade |
|
3 |
Nenhum tempo de inatividade durante a atualização |
|
|
Reversão instantânea |
|
|
<sup class="ph sup">1 Você pode atualizar a partir de qualquer versão do Automation Suite, mas uma atualização intermediária entre suas versões inicial e de destino pode ser necessária. Para obter detalhes, consulte Caminhos de atualização locais.
2 Você pode atualizar a partir de qualquer versão do Automation Suite, exceto 2021.10. Para obter detalhes, consulte Caminhos de atualização lado a lado.
3 Para obter detalhes, consulte Migração de dados e responsabilidades.
A matriz a seguir mostra os caminhos de atualização no local disponíveis para as versões do Automation Suite:
- está disponível um percurso direto de atualização no local entre versões principais;
- é necessária uma atualização intermediária no local entre suas versões inicial e de destino.
Recomendamos fortemente que você atualize para a versão menor mais recente do Automation Suite. Isso permite que você aproveite os aprimoramentos mais recentes e garante a operação perfeita de todos os componentes internos.
Versão inicial |
Versão de destino | ||||
---|---|---|---|---|---|
2021.10.x |
2022.4.x |
2022.10.x |
2023.4.x |
2023.10.x | |
2021.10.x |
|
|
|
|
|
2022.4.x |
N/A |
|
|
|
Requer 2022.4.7 no mínimo com Ceph em dispositivos raw e a conclusão da migração do Cilium antes de iniciar a atualização.
|
2022.10.x |
N/A |
N/A |
|
|
|
2023.4.x |
N/A |
N/A |
N/A |
|
|
2023.10.x |
N/A |
N/A |
N/A |
N/A |
|
-
Em alguns casos, a atualização do Automation Suite requer a transição por meio de uma versão intermediária ou ignorar totalmente algumas versões para manter o bom funcionamento dos componentes internos. Não seguir as diretrizes de atualização na tabela anterior pode levar a um downgrade de componente interno ou uma atualização de componente interno malsucedida, fazendo com que a atualização do Automation Suite falhe.
-
Se você planeja atualizar a partir do Automation Suite 2022.10 ou anterior e o Process Mining estiver habilitado, deverá migrar aplicativos de processos para o novo layout de gráfico do processo antes de iniciar a atualização.
-
Se você usar o Active Directory (AD) e estiver planejando atualizar para a versão 2023.4.0, é altamente recomendável que você pule diretamente para a versão 2023.4.3, pois 2023.4.0, 2023.4.1 e 2023.4.2 são impactados por um problema do AD.
-
Apenas as atualizações para o Automation Suite 2023.10 e posterior se beneficiam do processo de atualização simplificado.
A matriz a seguir mostra os percursos de atualização lado a lado disponíveis para as versões do Automation Suite:
- um percurso de atualização lado a lado direta entre versões está disponível;
- não é possível atualizar lado a lado entre suas versões inicial e de destino.
Recomendamos fortemente que você atualize para a versão menor mais recente do Automation Suite. Isso permite que você aproveite os aprimoramentos mais recentes e garante a operação perfeita de todos os componentes internos.
Versão inicial |
Versão de destino | ||||
---|---|---|---|---|---|
2021.10.x |
2022.4.x |
2022.10.x |
2023.4.x |
2023.10.x | |
2021.10.x |
|
|
|
|
|
2022.4.x |
N/A |
|
|
|
|
2022.10.x |
N/A |
N/A |
|
|
|
2023.4.x |
N/A |
N/A |
N/A |
|
|
2023.10.x |
N/A |
N/A |
N/A |
N/A |
|
Se você puder trazer um ambiente adicional para realizar a atualização, recomendamos escolher o percurso de atualização lado a lado, pois fornece uma abordagem de atualização mais segura e reversão instantânea.
Se não puder trazer um ambiente adicional para realizar a atualização, é possível optar pela atualização no local. Certifique-se de seguir as práticas recomendadas de validação de atualização.
Recomendamos preparar dois ambientes semelhantes do Automation Suite, independentemente de você desejar usar a atualização no local ou lado a lado:
-
Cluster de vários nós do Automation Suite para desenvolvimento ou controle de qualidade
Observação: o ambiente de desenvolvimento/controle de qualidade não precisa estar online o tempo todo se não for usado para outra tarefa que não a validação de atualização. -
Cluster de vários nós do Automation Suite para produção
It is strongly recommended to create a backup of the cluster and the SQL database before upgrading Automation Suite. This is to ensure you can restore the cluster if something goes wrong during the upgrade operation.
O backup dos dados do cluster é feito no servidor NFS. Certifique-se de ter configurado o servidor NFS antes de prosseguir.
global.userInputs.identity.krb5KeytabSecret
para global.kerberosAuthConfig.userKeytab
se atender simultaneamente aos seguintes requisitos:
-
Você configurou a integração do Active Directory usando nome de usuário e senha;
-
Você tem a autenticação do Windows habilitada;
-
Você não usa a autenticação integrada do SQL.
Para validar as automações que construiu, crie organizações ou tenants separados diretamente em seu ambiente de produção do Automation Suite, que é a solução com o melhor custo-benefício. Para conhecer mais práticas recomendadas, consulte Orchestrator — Melhores práticas de automação.
Para validar suas automações em diferentes ambientes e versões, faça uso de seu segundo cluster do Automation Suite após instalar o novo cluster do Automation Suite, mas antes de transicionar o tráfego para o novo cluster em produção.
A atualização para uma nova versão do Automation Suite não requer uma licença adicional, independentemente do caminho de atualização escolhido. No entanto, se você seguir nossas práticas recomendadas e usar dois clusters do Automation Suite (um para controle de qualidade/dev e outro para produção), você precisará de uma licença por cluster.
- Requisitos
- Processo de atualização
- Processo de atualização no local
- Atualização lado a lado
- Mecanismo e recursos de atualização
- Caminhos de atualização no local
- Percursos de atualização lado a lado
- Práticas recomendadas para atualização
- Práticas recomendadas de validação de atualização
- Ambientes
- Backup
- Autenticação
- Práticas recomendadas de validação de automação
- Validação da versão
- Licenciamento