orchestrator
2024.10
true
UiPath logo, featuring letters U and I in white
Guia de instalação do Orchestrator
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 4 de dez de 2024

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

available 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.

available Conheça 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.

available 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.

available Parar o 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 seção SecureAppSettings no web.config.

Certificados

Observe os novos requisitos de certificados. Se seu certificado existente não os cumprir, aqui está 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), essas contas de diretório que não foram convertidas devem fazer login interativamente no Orchestrator pelo menos uma vez para finalizar a conversão. Entrar no portal de gerenciamento de identidade ou entrar no UiPath Studio ou no 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

When you access an Azure Key Vault from a different cloud than the public one, you must set the environment variable AZURE_AUTHORITY_HOST to the corresponding value (i.e. "AZURE_AUTHORITY_HOST": "https://login.microsoftonline.us/"). For more details on the values, check the Microsoft Entra authentication & national clouds - Microsoft identity platform documentation.

Problemas conhecidos

Erros de tempo limite do banco de dados durante a atualização para 2023.10+

Ter mais de 100.000 grupos no Orchestrator pode causar um erro de tempo limite durante a atualização para 2023.10+.

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 ver as instruções, consulte Como Ativar a sua Licença.

Importante: se você estiver atualizando ou migrando de uma versão anterior 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 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 Legacy relacionadas 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.config

Padrõ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 de

Local Anterior do Legado

Novo Local Composite

Parâmetros Solicitados na Janela de Armazenamento

Parâmetros Solicitados no Modo Silencioso

Parâmetros Ignored do CMD

2019.4+

Padrão

Padrão

  

available

2019.4+

Padrão

Personalizado

  

available

2019.4+

Personalizado

Padrão

available

available

 

2019.4+

Personalizado

Personalizado

  

available

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?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.