UiPath Documentation
orchestrator
2023.10
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia de instalação do Orchestrator

Última atualização 28 de abr de 2026

Sobre atualização e migração

Visão geral​

AVISO:

Tenha em mente que essas informações pertencem à versão para a qual você está atualizando, NÃO à versão a partir da qual você está atualizando. Dessa forma, certifique-se de ler os detalhes corretos antes de prosseguir.

Para ver se sua versão mais antiga do Orchestrator pode ser atualizada para uma versão mais recente, consulte a matriz de caminhos de atualização do Orchestrator em nosso guia de Visão geral.

Para ver as versões mais recentes disponíveis, consulte a página Notas de Versão.

Lista de verificação pré-instalação​

Antes de prosseguir com uma atualização/instalação do Orchestrator, revise cuidadosamente a seguinte lista de tarefas:

Description

Detalhes

✅ Revise os requisitos do sistema

Certifique-se de atender aos pré-requisitos e aos requisitos de hardware e software para a versão que você deseja instalar.

Aprenda ✅ sobre as alterações introduzidas pela nova implantação

Uma nova implantação do Orchestrator produz as alterações que você deve conhecer. É preciso prestar atenção em alguns itens antes de uma atualização/instalação. Alguns são notas sobre as maiores alterações e recomendações sobre como obter o máximo proveito da nova versão.

✅ Execute a Ferramenta de Configuração da Plataforma

A Ferramenta de Configuração da Plataforma é um script do PowerShell usado para ajudar você na instalação/atualização bem-sucedida do Orchestrator. Ela ajuda você a verificar a integridade e a preparação do seu ambiente antes de uma atualização e auxilia você na execução de várias operações após a instalação.

Parar ✅ Orchestrator

Atualizações do seu Orchestrator devem ser feitas com o aplicativo interrompido. A execução de qualquer atualização enquanto o aplicativo estiver em execução pode resultar em erros e não é compatível.

Atualizando diretamente o Orchestrator​

Os artefatos de instalação são fornecidos ao você compra pela primeira vez do Orchestrator ou eles podem ser fornecidos pelo seu gerente de sucesso do cliente ou pela nossa equipe de suporte. Há algumas maneiras de atualizar diretamente:

Usando o Instalador do Windows​

UiPathOrchestrator.msi executa uma atualização no local que copia todas as suas configurações e cria uma pasta de backup para a versão antiga. É adequado para uma arquitetura de um nó e de vários nós. Algumas configurações web.config não são copiadas se a versão que você está atualizando foi instalada usando os scripts depreciados. A funcionalidade de reparo do Instalador do Windows não é compatível.

Se o Orchestrator que você deseja atualizar tiver sido instalado usando o agora UiPathPlatformInstaller.exedescontinuado, use o instalador do Windows para atualizar para esta versão.

Usando o Script do Azure​

Uma atualização complexa do Orchestrator e seus componentes em um ou vários nós, no Portal do Azure.

Considerações sobre atualização​

Criptografia​

Durante uma atualização do Orchestrator, o instalador não consegue ler uma seção criptografada em web.config . Para ler o EncryptionKey no web.config do Orchestrator e depois migrá-lo para o appsettings.Production.json do Identity Server, a chave deve ser texto simples. Você precisa descriptografar manualmente a seção antes de atualizar o Orchestrator. Após a atualização do Orchestrator ser finalizada, lembre-se de recriptografar a SecureAppSettings seção no web.config.

Certificados​

Observe os novos requisitos de certificados. Se seu certificado existente não os cumprir, eis aqui como obter um certificado válido e substituí-lo na instância do Orchestrator existente antes da atualização.

Por razões de segurança, certifique-se de usar uma chave pública em 2048 bits para o certificado usado para assinar os tokens de acesso gerados pelo Identity Server. O local do certificado deve ser definido na seção Credencial de Assinatura do appsettings.Production.json.

Banco de Dados​

Independentemente de como você escolher atualizar, se o banco de dados que você indicar não existir, ele será criado automaticamente ao executar a atualização. Se você indicar um banco de dados existente, ele será atualizado durante o mesmo processo. O banco de dados do SQL do Orchestrator é definido automaticamente para ser insensível a maiúsculas e minúsculas ("OrchDB" = "Orchestrator ") na instalação.

Provedores Externos​

Ao executar a atualização, se você tiver qualquer provedores externos habilitados em web.config, você será solicitado sobre as alterações manuais que você precisa executar em seus provedores externos preexistentes.

Usuários​

Ao atualizar para a versão mais recente do Orchestrator, todas as suas contas locais são migradas automaticamente do Orchestrator para o Identity Server e convertidas para o formato necessário.

Essa alteração não impacta seus robôs.

Observação:

Se você já usou a versão 2018.4 e não concluiu a conversão de contas de usuário importadas do Active Directory em contas de diretório (ou não converteu todos os usuários importados), as contas de diretório que não foram convertidas devem fazer logon interativamente no Orchestrator pelo menos uma vez para finalizar a conversão . Fazer login no portal do Gerenciamento de Identidades, ou fazer login no UiPath Studio ou UiPath Assistant não conclui a conversão da conta.

Após a conversão ser concluída, você não pode mais usar a autenticação básica para fazer logon com os usuários respectivos.

Identidades do Pool de Aplicativos​

Ao atualizar para a versão mais recente do Orchestrator, é altamente recomendável usar o mesmo tipo de identidade do Pool de Aplicativos para o Identity Server e Webhooks que o usado para o Orchestrator durante a instalação original.

Por exemplo, se você definiu o tipo de identidade do Pool de Aplicativos como uma conta personalizada durante a instalação do Orchestrator v2020.10, ao atualizar para a v2021.10, selecione o mesmo tipo de identidade do Pool de Aplicativos (ou seja, conta personalizada) tanto para o Identity Server quanto para o Webhooks. Caso contrário, o acesso ao servidor SQL pode ser bloqueado.

Azure Key Vault​

Quando você acessa um Azure Key Vault de uma nuvem diferente da pública, você deve definir a variável de ambiente AZURE_AUTHORITY_HOST para o valor correspondente (por exemplo "AZURE_AUTHORITY_HOST": "https://login.microsoftonline.us/"). Para obter mais detalhes sobre os valores, consulte a página [Autenticação do Microsoft Entra e nuvens nacionais

Problemas conhecidos​

Erros de tempo limite do banco de dados ao atualizar para 2023.10 ou posterior​

Ter mais de 100.000 grupos no Orchestrator pode causar um erro de tempo limite ao atualizar de uma versão mais antiga que 2023.10 para 2023.10 ou posterior.

Para superar isso, execute o seguinte script diretamente em seu banco de dados e, em seguida, repita a atualização:

-- 1. Delete group subscriptions

DECLARE @rowCount BIGINT = 1
DECLARE @batchSize BIGINT = 4000
DECLARE @pivotDate DATETIME = GETUTCDATE()
WHILE (@rowCount > 0)
BEGIN
    DECLARE @subscriptionsToDeleteIds TABLE(
        [Id] UNIQUEIDENTIFIER NOT NULL
    )
    INSERT INTO @subscriptionsToDeleteIds
    SELECT TOP(@batchSize) [ns].[Id]
    FROM [dbo].[NotificationSubscriptions] [ns]
    JOIN [dbo].[Users] [u] ON [u].[Id] = [ns].[UserId]
    WHERE [u].[Type] = 3 AND -- Group
        [u].[CreationTime] <= @pivotDate AND
        [u].[IsDeleted] = 0
    DELETE FROM [dbo].[NotificationSubscriptions]
    WHERE [Id] IN (
        SELECT [Id] FROM @subscriptionsToDeleteIds
    )
    OPTION (MAXDOP 1)
    SET @rowCount = @@ROWCOUNT
    WAITFOR DELAY '00:00:00.1'
END

-- 2. Create index on UserNotifications

IF NOT EXISTS(SELECT * FROM sys.indexes WHERE OBJECT_ID = OBJECT_ID(N'[dbo].[UserNotifications]') AND NAME = N'IX_UserId_CreationTime')
   CREATE NONCLUSTERED INDEX [IX_UserId_CreationTime] ON [dbo].[UserNotifications]
   (
       [UserId] ASC,
       [CreationTime] ASC
   ) INCLUDE ([TenantNotificationId]) WITH (ONLINE = ON);
-- 1. Delete group subscriptions

DECLARE @rowCount BIGINT = 1
DECLARE @batchSize BIGINT = 4000
DECLARE @pivotDate DATETIME = GETUTCDATE()
WHILE (@rowCount > 0)
BEGIN
    DECLARE @subscriptionsToDeleteIds TABLE(
        [Id] UNIQUEIDENTIFIER NOT NULL
    )
    INSERT INTO @subscriptionsToDeleteIds
    SELECT TOP(@batchSize) [ns].[Id]
    FROM [dbo].[NotificationSubscriptions] [ns]
    JOIN [dbo].[Users] [u] ON [u].[Id] = [ns].[UserId]
    WHERE [u].[Type] = 3 AND -- Group
        [u].[CreationTime] <= @pivotDate AND
        [u].[IsDeleted] = 0
    DELETE FROM [dbo].[NotificationSubscriptions]
    WHERE [Id] IN (
        SELECT [Id] FROM @subscriptionsToDeleteIds
    )
    OPTION (MAXDOP 1)
    SET @rowCount = @@ROWCOUNT
    WAITFOR DELAY '00:00:00.1'
END

-- 2. Create index on UserNotifications

IF NOT EXISTS(SELECT * FROM sys.indexes WHERE OBJECT_ID = OBJECT_ID(N'[dbo].[UserNotifications]') AND NAME = N'IX_UserId_CreationTime')
   CREATE NONCLUSTERED INDEX [IX_UserId_CreationTime] ON [dbo].[UserNotifications]
   (
       [UserId] ASC,
       [CreationTime] ASC
   ) INCLUDE ([TenantNotificationId]) WITH (ONLINE = ON);
Problemas de software antivírus​

Alguns software antivírus podem impedir que os scripts de migração de dados funcionem corretamente durante uma atualização.

Problemas de tentativas de login​

Após atualizar seu Orchestrator da versão 2019.10 ou mais antiga do que o de página Perfil não exibirá tentativas de logon anteriores a essa atualização.

Atualizando Sua Licença Após a Instalação​

Após fazer o upgrade ou migrar o Orchestrator, recomendamos que você atualize as informações da sua licença na página Licenças usando a ativação online ou offline. Para obter instruções, consulte Ativando Sua Licença.

Importante:

Se você estiver atualizando ou migrando de uma versão que é mais antiga que a 2019.10, você deve atualizar suas informações de licença, caso contrário, você não se beneficiará do período de carência na expiração da licença, o que pode causar a interrupção do serviço.

Migração do pacote​

Na versão v2020.10+, Legacy não é mais um tipo de repositório do NuGet compatível. Os pacotes que estão anteriormente em um repositório Legacy são migrados para um repositório Composite . Para repositórios compósitos, o local do pacote está configurado usando os parâmetros Storage.Type e Storage.Location em UiPath.Orchestrator.dll.config. Após a atualização, todas as Legacyrelacionadas com configurações do aplicativo se tornam descontinuadas e não têm mais efeito:

  • NuGet.Packages.Path
  • NuGet.Activities.Path
  • Nuget.EnableRedisNodeCoordination
  • Nuget.EnableNugetServerLogging
  • NuGet.EnableFileSystemMonitoring
  • NuGet.Repository.Type

O novo local do pacote depende de como você configurou os parâmetros NuGet.Packages.Path e NuGet.Activities.Path em web.config para a versão anterior do Orchestrator.

Local padrão​

Se você armazenar os pacotes nos locais padrão (~/NuGetPackages e ~/NuGetPackages/Activities), o novo local do pacote será RootPath=.\Storage.

Padrões da Chave Pré-2020.10 - web.configPadrões da Chave 2020.10+ - UiPath.Orchestrator.dll.config
<add key="NuGet.Packages.Path" value="~/NuGetPackages" /> <add key="NuGet.Activities.Path" value="~/NuGetPackages/Activities" /><add key="Storage.Type" value="FileSystem" /> <add key="Storage.Location" value="RootPath=.\Storage" />

Local Personalizado​

Se você tiver armazenado os pacotes em um local personalizado, durante a instalação será solicitado que você informe um novo local de armazenamento. Para instalações silenciosas, os parâmetros STORAGE_LOCATION e STORAGE_TYPE tornam-se obrigatórios, a menos que você os adicione especificamente em web.config (Storage.Type e Storage.Location) antes da atualização.

Matriz de Migração de Pacotes​

A matriz abaixo descreve quando os parâmetros STORAGE_TYPE e STORAGE_LOCATION são solicitados ou ignorados durante uma atualização. A matriz leva em consideração a versão a partir da qual você está atualizando, bem como a personalização do local do pacote, tanto na versão anterior quanto em 2020.10 e posterior.

Por exemplo, com base nesta combinação de funcionalidades, a matriz mostra que dois parâmetros são necessários (sinalizados com marca de verificação) no Modo silencioso para uma atualização a partir da versão 2019.4+ se o pacote foi armazenado em um local personalizado, mas seu novo local de armazenamento é padrão.

Atualizar deLocal Anterior do LegadoNovo Local CompositeParâmetros Solicitados na Janela de ArmazenamentoParâmetros Solicitados no Modo SilenciosoParâmetros Ignored do CMD
2019.4+PadrãoPadrão✅
2019.4+PadrãoPersonalizado✅
2019.4+PersonalizadoPadrão✅✅
2019.4+PersonalizadoPersonalizado✅

Erros de Migração​

Se por qualquer motivo a migração de pacotes falhar, você será apresentado com as seguintes opções:

  • Tentar novamente - a migração de pacotes é reiniciada. Os pacotes que já foram migrados são ignorados.
  • Anular - a instalação é reiniciada. Durante a etapa de migração, os pacotes que já foram migrados não são ignorados e são migrados novamente. Por esse motivo, você pode encontrar arquivos duplicados em diferentes contêineres. Isso só acontece ao migrar de versões mais antigas que a 2019.4.
  • Continuar - a migração está ocorrendo.
Atualizações da 2019.10​

A migração como parte de uma atualização da 2019.10 pode, às vezes, fazer com que os nomes dos pacotes mudem, tornando-se, assim, indisponíveis no Orchestrator. Se isso acontecer, recomendamos que você carregue manualmente qualquer pacote afetado.

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades