- Introdução
- Requisitos
- Melhores práticas
- Instalação
- Atualizando
- Servidor de Identidade
- Solução de problemas de erros de inicialização
Guia de instalação do Orchestrator
Sobre atualização e migração
Você pode atualizar o Orchestrator diretamente para 2021.10 se você usar atualmente alguma das seguintes versões:
- 2021.x
- 2020.x
- 2019.x
-
2018.4
Importante:Se você usar uma versão inferior a 2018.4, é preciso fazer atualização para v2018.4 ou v2019.x ou 2020.x e, em seguida, para 2021.10.
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.
Antes de prosseguir com uma atualização/instalação do Orchestrator, revise cuidadosamente a seguinte lista de tarefas:
|
Description |
Detalhes |
|---|---|
|
|
Certifique-se de atender aos pré-requisitos e aos requisitos de hardware e software para a versão que você deseja instalar. |
|
|
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. |
|
|
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.
|
|
|
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. |
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:
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.
UiPathPlatformInstaller.exedescontinuado, use o instalador do Windows para atualizar para esta versão.
Uma atualização complexa do Orchestrator e seus componentes em um ou vários nós, no Portal do Azure.
UiPathStudio.msi e UiPathOrchestrator.msi.
UiPathStudio.msi e UiPathOrchestrator.msi, UiPathPlatformInstaller.exe não aceita argumentos de linha de comando.
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.
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.
appsettings.Production.json.
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.
web.config, você será solicitado sobre as alterações manuais que você precisa executar em seus provedores externos preexistentes.
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.
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.
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.PathNuGet.Activities.PathNuget.EnableRedisNodeCoordinationNuget.EnableNugetServerLoggingNuGet.EnableFileSystemMonitoringNuGet.Repository.Type
NuGet.Packages.Path e NuGet.Activities.Path em web.config para a versão anterior do Orchestrator.
~/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 |
|---|---|
|
|
|
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.
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 nessa combinação de funcionalidades a matriz mostra que os dois parâmetros são necessários (sinalizados com marca de verificação) no Modo Silencioso nos seguintes casos:
- Para uma atualização a partir da versão 2018.4, se o pacote foi armazenado em um local personalizado
-
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
2018.4
Padrão
2018.4
Personalizado
2019.4+
Padrão
Padrão
2019.4+
Padrão
Personalizado
2019.4+
Personalizado
Padrão
2019.4+
Personalizado
Personalizado
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.
- Visão geral
- Lista de verificação pré-instalação
- Atualizando diretamente o Orchestrator
- Usando o Instalador do Windows
- Usando o Script do Azure
- Usando o Instalador do UiPathPlatform
- Considerações sobre atualização
- Criptografia
- Certificados
- Banco de Dados
- Provedores Externos
- Problemas conhecidos
- Atualizando Sua Licença Após a Instalação
- Migração do pacote
- Local padrão
- Local Personalizado
- Matriz de Migração de Pacotes
- Erros de Migração
