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.

Você pode atualizar o Orchestrator diretamente para 2022.4 se usar atualmente alguma das seguintes versões:

• 2021.x

• 2020.x

• 2019.x

  Importante:

  Se você usar a versão 2018.4, precisará atualizar para 2019.x ou 2020.x ou para 2021.x e depois saltar para 2022.4.

  Se você usar uma versão inferior a 2018.4, é preciso fazer atualização para v2018.4 ou v2019.x ou 2020.x e depois saltar para 2022.4.

  Recomendamos usar 2019.10 como versão intermediária.

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. Requisitos de Hardware Requisitos de software Pré-requisitos
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. Alterado o tempo de execução de .NET Framework para .NET Core Feitas várias alterações nos arquivos de configuração Atualizado o protocolo SignalR. Revisada a infraestrutura do NuGet. Atualizada a biblioteca do Swagger. Mudanças no API
✅ 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. Platform Configuration Tool documentation and download.
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.

Saiba como atualizar usando o instalador do Windows.

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.

Saiba como atualizar usando o script do Azure.

Considerações sobre atualização

Criptografia

During an Orchestrator update, the installer cannot read an encrypted SecureAppSettings section within web.config . In order to read the EncryptionKey from Orchestrator's web.config and then migrate it into Identity Server's appsettings.Production.json, the key must be plain text. You need to manually decrypt the section before updating Orchestrator. After the Orchestrator update process was finalized, remember to re-encrypt the SecureAppSettings section in web.config.

Certificados

Note the new certificate requirements. If your existing certificate doesn't meet them, here is how to get a valid certificate and how to replace it in the existing Orchestrator instance, before upgrading.

For security reasons, for the certificate used to sign the access tokens generated by the Identity Server, make sure to use a public key on 2048 bits. The certificate's location has to be set within appsettings.Production.json's Signing Credential section.

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.

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);

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

In v2020.10+, Legacy is no longer a supported NuGet repository type. Packages previously residing in a Legacy repository are migrated to a Composite repository. For composite repositories, package location is configured using the Storage.Type and Storage.Location parameters in UiPath.Orchestrator.dll.config. After the upgrade, all Legacy-related app settings become deprecated and no longer have an effect:

• 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			✅
2019.4+	Padrão	Personalizado			✅
2019.4+	Personalizado	Padrão	✅	✅
2019.4+	Personalizado	Personalizado			✅

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.