- Introdução
- Requisitos
- Melhores práticas
- Instalação
- Atualizando
- Servidor de Identidade
- Complemento de alta disponibilidade
- Solução de problemas de erros de inicialização
Guia de instalação do Orchestrator
Sobre atualização e migração
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.
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.
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.
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.
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.
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_AUTHORITY_HOST com o valor correspondente (ou seja, "AZURE_AUTHORITY_HOST": "https://login.microsoftonline.us/"). Para obter mais detalhes sobre os valores, consulte a documentação Autenticação do Microsoft Entrada e nuvens nacionais - plataforma de identidade da Microsoft .
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 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 |
|
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
- Considerações sobre atualização
- Criptografia
- Certificados
- Banco de Dados
- Provedores Externos
- Usuários
- Identidades do Pool de Aplicativos
- Azure Key Vault
- 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
