- 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 ajustes do nível do kernel e do sistema operacional
- Etapa 8: configuração dos discos
- 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
- 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
- Redirecting traffic for the unsupported services to the primary cluster
- 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
- Migração para um registro externo compatível com OCI
- 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
- 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 pacote 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 NIC
- 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
- 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
- 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
- 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
- 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 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.
-
Se você atualizar do Automation Suite 2022.10, você pode realizar uma atualização direta para 2023.4 ou posterior. No entanto, se você atualizar do Automation Suite 2021.10 ou 2022.4, você precisa atualizar primeiro para 2022.10, e só depois para 2023.4 ou posterior. Para obter detalhes, consulte Caminhos de atualização doAutomation Suite .
-
Upgrading Automation Suite enables maintenance mode on the cluster, which causes downtime for the entire upgrade duration.
-
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.
-
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 |
|
Você deve atualizar para a versão 2022.4.7 ou 2022.4.10 e, em seguida, para a versão 2022.4.11 ou posterior. |
Você deve atualizar para 2022.10.0 e 2022.10.9 primeiro e depois para 2022.10.10 ou posterior. |
Você deve atualizar para a versão 2022.10.0 ou 2022.10.9 primeiro, e depois para a versão 2023.4.x. |
Você deve atualizar para a versão 2022.10.0 ou 2022.10.9 primeiro, e depois para a versão 2023.10.x. |
2022.4.x |
N/A |
|
Se sua versão atual for 2022.4.0 até 2022.4.6, você deve atualizar para 2022.10.0 até 2022.10.9 primeiro e depois para 2022.10.10 ou posterior. Se sua versão atual for a 2022.4.7 ou posterior, você deve atualizar para a versão 2022.10.10 ou posterior. |
Se sua versão atual for a 2022.4.0 ou 2022.4.10. você deve atualizar para a versão 2022.10.0 ou 2022.10.9 primeiro, e depois para a versão 2023.4.x. Se sua versão atual for 2022.4.11, você deve atualizar para 2022.10.10 primeiro e depois para 2023.4.5. |
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. Se sua versão atual for a 2022.4.7 ou 2022.4.10, você pode atualizar para a versão 2023.10.x. Se sua versão atual for a 2022.4.11, você deve atualizar para a versão 2023.10.2 ou posterior. |
2022.10.x |
N/A |
N/A |
|
Se sua versão atual for a 2022.10.0 ou 2022.10.9, você pode atualizar para a versão 2023.4.x. Se sua versão atual for a 2022.10.10 ou posterior, você deve atualizar para a versão 2023.4.5 ou posterior. |
e sua versão atual for a 2022.10.0 ou 2022.10.9, você pode atualizar para a versão 2023.10.x. Se sua versão atual for a 2022.10.10 ou posterior, você deve atualizar para 2023.10.2 ou posterior. |
2023.4.x |
N/A |
N/A |
N/A |
|
Se sua versão atual for a 2023.4.0.ou 2023.4.4, você pode atualizar para a versão 2023.10.x. Se sua versão atual for a 2023.4.5 ou posterior, você deve atualizar para a versão 2023.10.2 ou posterior. |
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