- Visão geral
- Requisitos
- Instalação
- Q&A: Deployment templates
- Configuração das máquinas
- Configurando o objectstore externo
- Configurando um registro externo do Docker
- Configuração do balanceador de carga
- Configuração do DNS
- Como configurar o Microsoft SQL Server
- Configuração dos certificados
- Instalação online de produção pronta para alta disponibilidade de vários nós
- Instalação offline de produção pronta para alta disponibilidade de vários nós
- Disaster Recovery - Instalando o cluster secundário
- Baixando os 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
- 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
- Pós-instalação
- Administração de cluster
- Monitoramento e alertas
- Migração e atualização
- Opções de migraçã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 Insights independente
- Etapa 7: exclusão do tenant padrão
- Executando uma migração de único tenant
- Configuração específica do produto
- Uso da ferramenta de configuração do Orchestrator
- Preparando o Orchestrator
- Atualização da configuração do Orchestrator
- 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 limpar automaticamente instantâneos do Longhorn
- Como desabilitar o descarregamento de soma de verificação do TX
- Como definir manualmente o nível de log do ArgoCD como Info
- Como gerar o pull_secret_value codificado para registros externos
- Como lidar com cifras fracas no TLS 1.2
- Como trabalhar com certificados
- 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
- 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
- A primeira instalação falha durante a configuração do Longhorn
- 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ó da GPU afetado por indisponibilidade de recurso
- 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 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
- A validação de SQL falha durante a atualização
- pod snapshot-controller-crds no estado CrashLoopBackOff após a atualização
- Falha ao carregar ou baixar dados no objectstore
- PVC resize does not heal Ceph
- Falha no redimensionamento do PVC
- Falha no redimensionamento do PVC do Objectstore
- Pod do Rook Ceph ou Looker travado no estado Init
- Erro de anexo de volume StatefulSet
- Falha ao criar volumes persistentes
- Patch de reclamação de armazenamento
- Falha de backup devido ao erro TooManySnapshots
- Todas as réplicas do Longhorn estão com falha
- Configurando um intervalo de tempo limite para os portais de gerenciamento
- Atualizar as conexões de diretório subjacentes
- 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
- Segredo não encontrado no namespace da UiPath
- O ArgoCD entra em estado Em andamento após a primeira instalação
- Problemas de acesso à conta somente leitura do ArgoCD
- 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
- Prometheus no estado CrashloopBackoff com erro de falta de memória (OOM)
- 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
- Falha ao configurar alertas por e-mail após a atualização
- Nenhum problema upstream íntegro
- 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
- Falha na implantação de habilidade de ML devido à expiração do token
- 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
- Usando a ferramenta de diagnóstico do Automation Suite
- Usando o pacote de suporte do Automation Suite
- Exploração de logs
Atualização da configuração do Orchestrator
Atualize a configuração do Orchestrator. Certifique-se de revisar o seguinte:
- Configuração personalizada de
UiPath.Orchestrator.dll.config - Todas as configurações
web.config. - Armazenamento (pacotes, mídia de execução e dados de buckets) — aplicável principalmente para
Storage.Type=FileSystem - Destinos de Nlog personalizados.
- Repositórios de credenciais personalizados.
- Chave de criptografia por configuração de tenant.
You can simplify many of the following steps by using the provided Orchestrator Configurator Tool.
A ferramenta de bash orchestrator_configurator.sh pode atualizar o mapa de configuração personalizada do Orchestrator e carregar arquivos para os locais de armazenamento de blobs conhecidos do Orchestrator. Use o parâmetro -y para pular a confirmação das ações propostas.
Configuração do web.config
Edite o mapa de configuração orchestrator-customconfig usando uma ferramenta como o Lens ou kubectl.
Configure o limite de solicitação no arquivo values.json. A implantação do Orchestrator deve reiniciar automaticamente após essa alteração de configuração.
{
"Kestrel": {
"Limits": {
"MaxRequestBodySize": 314572800
}
}
{
"Kestrel": {
"Limits": {
"MaxRequestBodySize": 314572800
}
}
Configuração do AppSettings
O arquivo appsettings.json editado nas etapas de pré-migração agora contém toda a personalização necessária na seção appSettings. Você precisa colocar esse arquivo .json no mapa de configuração orchestrator-customconfig, no arquivo values.json, na chave appSettings.
{
"ExampleSetting.Enabled": true,
"ExampleSetting.Type": "BasicExample",
"ExampleSetting.Count": 3
}
{
"ExampleSetting.Enabled": true,
"ExampleSetting.Type": "BasicExample",
"ExampleSetting.Count": 3
}
A ferramenta de configuração do Orchestrator pode mesclar as chaves no appSettings personalizado com as chaves já presentes no mapa de configuração. Você pode carregar as configurações do aplicativo usando o parâmetro -c|--app-settings :
./orchestrator_configurator.sh -c appsettings.json
./orchestrator_configurator.sh -c appsettings.json
Se estiver usando a ferramenta de configuração, percorra todas as etapas para coletar todas as substituições appSettings necessárias e execute o script uma vez no final.
Configuração de armazenamento
Se você estiver migrando do armazenamento FileSystem para o provedor de armazenamento do Orchestrator, use a Ferramenta Configurador do Orchestrator para transferir o conteúdo do armazenamento.
Carregue os arquivos usando o parâmetro -s|--storage-folder na Ferramenta Configurador do Orchestrator, onde path é a pasta pai. Substitua o caminho pelo local da pasta onde seus arquivos estão armazenados. Para determinar o caminho, verifique o parâmetro Storage.Path em UiPath.Orchestrator.dll.config.
Para garantir que seja a pasta correta, ela deve conter essa hierarquia:
- Uma pasta chamada Orchestrator-Host\Libraries.
- Uma pasta para cada tenant, chamada Orchestrator-[tenantKey].
./orchestrator_configurator.sh -s path
./orchestrator_configurator.sh -s path
O comando carrega o conteúdo da pasta de caminho para o provedor de armazenamento configurado.
- A ferramenta Configurador do Orchestrator é compatível apenas com o CEPH, S3 (ou compatível) ou o Azure Blob Storage. Para qualquer outro armazenamento, copie o conteúdo para o novo local manualmente.
Para usar o FileStore de rede, edite os parâmetros do aplicativo ArgoCD do Orchestrator e defina o seguinte:
storage.type = smbstorage.smb.domainstorage.smb.passwordstorage.smb.sourcestorage.smb.usernamestorage.smb.size
Para configurar outras opções de armazenamento, edite os parâmetros do aplicativo ArgoCD do Orchestrator e defina o seguinte:
storage.typepara o provedor desejado. O valor diferencia maiúsculas de minúsculas. Os valores possíveis são:Azure,AWS,Minio.storage.connectionString
Visão geral das configurações de armazenamento do aplicativo do Orchestrator:
Configurando um bucket para armazenar todos os inquilinos
Se você estiver usando depósitos de armazenamento externo, poderá instruir o Orchestrator a armazenar dados em um único depósito externo sem atribuir permissões administrativas à conta de armazenamento externo usando o sinalizador --use-external-storage .
Configuração de buckets de armazenamento do Azure/Amazon S3
O acesso de navegador do Orchestrator a buckets de armazenamento da Amazon e Azure pode ser restrito devido à política de mesma origem no lado do provedor. Para acessar com sucesso o conteúdo de um bucket desse tipo, você precisa configurar o respectivo provedor para permitir solicitações de origem cruzada do Orchestrator.
See instructions on how to configure each provider to allow cross-origin requests from Orchestrator.
Configuração do NLog
Para instalar as extensões do NLog, elas precisam ser copiadas no Ceph, no bucket uipath. O pod do Orchestrator será então capaz de carregá-las na inicialização. Você também precisa colocar a configuração em orchestrator-customconfig no arquivo nlog.json.
O configurador pode fazer isso com os parâmetros -n|--nlog-extensions-folder e -l|--nlog-config-file.
./orchestrator_configurator.sh -n nlogextensions -l nlog.custom.json
./orchestrator_configurator.sh -n nlogextensions -l nlog.custom.json
Os plug-ins estarão disponíveis no pod do Orchestrator no caminho local /var/orchestrator/plugins/nlog. O configurador atualiza automaticamente os caminhos do assemblyFile, acrescentando o caminho dos plug-ins a eles.
Configuração dos repositórios de credenciais
As alterações de configuração para os repositórios de credenciais estão incluídas em appsettings.json, de modo que não há mais atualizações de configuração necessárias.
Para fazer as alterações manualmente, coloque-as no arquivo values.json de orchestrator-customconfig, na seção do appSettings.
Se também forem necessários assemblies seguros, então você deve colocá-los em algum pod do Orchestrator no caminho /var/orchestrator/plugins/securestore/.
A ferramenta de configuração do Orchestrator pode fazer isso usando o parâmetro -p|--securestore-plugins-folder:
./orchestrator_configurator.sh -p securestoreplugins
./orchestrator_configurator.sh -p securestoreplugins
Configuração da chave de criptografia
Para configurar a chave de criptografia, substitua-a no segredo orchestrator-generated-secrets do Kubernetes substituindo o valor de APPSETTINGS__EncryptionKey. Para fazê-lo, execute o seguinte comando:
ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"
ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"
Certifique-se de substituir <key> pelo valor da chave recuperada de UiPath.Orchestrator.dll.config.
Configuração da chave de criptografia por tenant
Para migrar a chave de criptografia por tenant, siga as etapas a seguir:
-
Adicione as configurações e o certificado do AzureKeyVault na interface do usuário do ArgoCD, substituindo os parâmetros para o aplicativo do Orchestrator.
encryptionKeyPerTenant.certificateBase64encryptionKeyPerTenant.certificatePasswordencryptionKeyPerTenant.clientIdencryptionKeyPerTenant.directoryIdencryptionKeyPerTenant.vaultAddress
-
Use the values from the following configuration keys (referenced in the preparation steps):
Azure.KeyVault.VaultAddressAzure.KeyVault.ClientIdAzure.KeyVault.DirectoryId
-
Converta o certificado para base64 e o use como uma substituição de parâmetro. Para convertê-lo, use o seguinte comando:
PowerShell:
[convert]::ToBase64String((Get-Content -path "path_to_certificate" -Encoding byte))[convert]::ToBase64String((Get-Content -path "path_to_certificate" -Encoding byte))Shell:
base64 [_path_to_certificate_]base64 [_path_to_certificate_]
-
Aplique as substituições de parâmetros do aplicativo ArgoCD do Orchestrator e, em seguida, execute a ferramenta de configuração do Orchestrator.
-
Depois que a nova configuração estiver refletida no ArgoCD, aguarde até o aplicativo ser sincronizado novamente.
-
Habilite a funcionalidade EncryptionKeyPerTenant da seguinte forma:
- use as duas configurações colocadas em
appsettings.jsone execute a ferramenta de configuração do Orchestrator; - ou manualmente no
orchestrator-customconfig, na seçãoappConfigdo arquivovalues.json.
"EncryptionKeyPerTenant.Enabled": "true", "EncryptionKeyPerTenant.KeyProvider": "AzureKeyVault","EncryptionKeyPerTenant.Enabled": "true", "EncryptionKeyPerTenant.KeyProvider": "AzureKeyVault", - use as duas configurações colocadas em
-
Reinicie a implantação do Orchestrator do Automation Suite no cluster para que as alterações entrem em vigor.
Observação:As configurações do SMTP no Identity Server não são criptografadas com a chave por tenant. Depois que a migração for concluída, certifique-se de inserir novamente a senha do SMTP no portal do Automation Suite.
- Configuração do web.config
- Configuração do AppSettings
- Configuração de armazenamento
- Configurando um bucket para armazenar todos os inquilinos
- Configuração de buckets de armazenamento do Azure/Amazon S3
- Configuração do NLog
- Configuração dos repositórios de credenciais
- Configuração da chave de criptografia
- Configuração da chave de criptografia por tenant