Atualizando o script do Azure

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.

Importante:

• Se você usar o Active Directory (AD) e estiver planejando atualizar para a versão 2023.4.0, é altamente recomendável que você pule diretamente para a versão 2023.4.3, pois 2023.4.0, 2023.4.1 e 2023.4.2 são impactados por um problema do AD.

• Se você não tiver feito isso anteriormente (por exemplo, atualizar a partir do v2019.10), certifique-se de ter criado os serviços do aplicativo para:
  • Servidor de Identidade
  • Serviço de Webhooks
  • Serviço Catálogo de recursos
• Antes de executar o script Publish-Orchestrator.ps1, certifique-se de remover o módulo do AzureRM PowerShell. Recomendamos usar o Az como uma alternativa. Não há suporte para instalar os módulos AzureRM e Az ao mesmo tempo.
• Se a versão desejada do Az não for detectada e o AzureRM estiver presente ao executar o script, você receberá a solicitação para confirmar a remoção do AzureRM, mesmo em instalações não assistidas.
• Atualizar para Az v6.0.0 quando qualquer versão anterior do módulo está em uso faz com que a seguinte mensagem apareça: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Para resolver este problema, certifique-se de executar Publish-Orchestrator.ps1 em uma nova sessão do PowerShell.

1. Faça o download do último arquivo UiPathOrchestrator.zip disponível.
2. Desbloqueie o arquivo UiPathOrchestrator.zip usando o comando Unblock-File do PowerShell. Por exemplo, Unblock-File .\UiPathOrchestrator.zip.
3. Desarquive UiPathOrchestrator.zip.
4. Execute o script Publish-Orchestrator.ps1 no PowerShell na instância do Orchestrator que você deseja atualizar, conforme mostrado abaixo. Leve em conta que suas configurações do UiPath.Orchestrator.dll.config (anteriormente web.config) são mantidas se não forem explicitamente especificadas como parâmetros de script.
5. Execute o script Publish-IdentityServer.ps1 no PowerShell na sua instância do Identity Server, conforme mostrado abaixo.
6. Execute o script Publish-Webhooks.ps1 no PowerShell na sua instância do Serviço do Webhooks, conforme exibido abaixo.
7. Execute o script Publish-ResourceCatalog.ps1 no PowerShell na instância de seu serviço Catálogo de recursos, conforme mostrado abaixo.
8. Execute o script MigrateTo-ResourceCatalog.ps1 no PowerShell, usando os parâmetros descritos aqui.
9. Se você estiver atualizando uma instância do Orchestrator de vários nós, libere todas as chaves do cache do Redis usando o comando FLUSHALL ou FLUSHDB. Mais informações sobre eles estão disponíveis aqui e aqui.

10. Abra o aplicativo da Web no Portal do Azure e navegue até Configuração > Configurações gerais e verifique as seguintes configurações:

    • Stack deve ser definido como .NET Core.
    • Platform deve ser definido como 64 Bit.
    • Web sockets deve ser definido como On se você não estiver usando o serviço Azure SignalR

11. Inicie o serviço do aplicativo do Orchestrator. Aproveite o uso do Orchestrator no seu Portal Azure.

12. Reinicie o serviço do UiPath Robot em todas as máquinas do Robô que você conectou ao Orchestrator.

Atualização do Publish-Orchestrator.ps1

Após você ter baixado o script Publish-Orchestrator.ps1 mais recente para sua máquina local, execute o script da seguinte forma para atualizar o Orchestrator:

.\Publish-Orchestrator.ps1 -action Update -package .\UiPath.Orchestrator.Web.zip -stopApplicationBeforePublish -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<app_service_name>" -confirmBlockClassicExecutions -Verbose

Para incluir os módulos de Automação de teste, Insights e Atualizar servidor, execute o script da seguinte forma:

.\Publish-Orchestrator.ps1 -action Update -package .\UiPath.Orchestrator.Web.zip -stopApplicationBeforePublish -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<app_service_name>" -confirmBlockClassicExecutions -testAutomationFeatureEnabled -insightsFeatureEnabled -updateServerFeatureEnabled -Verbose

Atualizar Publish-IdentityServer.ps1

Importante: Se você não tiver feito isso anteriormente (por exemplo, atualizando a partir do v2019.10), certifique-se de ter criado o serviço do aplicativo para o Identity Server. Certifique-se de que o script Publish-IdentityServer.ps1 tem como objetivo o serviço do aplicativo do Identity Server.

Depois de baixar o script Publish-IdentityServer.ps1 mais recente para sua máquina local, execute o script da seguinte maneira para atualizar o aplicativo de Web do Azure do Identity Server:

.\Publish-IdentityServer.ps1 ` -action Update ` -azureSubscriptionId "<azure_subscription_id>" ` -azureAccountTenantId "<azure_tenant_id>" ` -azureAccountApplicationId "<azure_application_id>" ` -azureAccountPassword "<azure_account_password>" ` -orchestratorURL "https://<orchestratorURL>" ` -identityServerUrl "https://<IdentityServerURL>/identity" ` -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } ` -identityServerDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } ` -package "UiPath.IdentityServer.Web.zip" ` -cliPackage "UiPath.IdentityServer.Migrator.Cli.zip" ` -resourceCatalogUrl "<resource_catalog_url>" ` -stopApplicationBeforePublish ` -unattended

Atualização de Publish-Webhooks.ps1

Importante: Se você ainda não o fez (por exemplo, atualizando de v2019.10), certifique-se de ter criado o serviço de aplicativo para o Webhooks Service. Certifique-se de que o script Publish-Webhooks.ps1 tenha como destino o serviço de aplicativo Webhooks.

Após ter baixado e extraído o arquivo UiPath.WebhookService.Web.zip mais recente para sua máquina local, execute o script Publish-Webhooks.ps1 da seguinte maneira para atualizar o aplicativo de Web do Webhooks Service Azure:

.\Publish-Webhooks.ps1 ` -action Update ` -package "UiPath.WebhookService.Web.zip" ` -azureAccountApplicationId "<azure_application_id>" ` -azureAccountPassword "<azure_account_password>" ` -azureSubscriptionId "<subscription_id>" ` -azureAccountTenantId "<azure_tenant_id>" ` -resourceGroupName "<resourcegroup_name>" ` -appServiceName "<appservice_name>" ` -stopApplicationBeforePublish

Atualização do Publish-ResourceCatalog.ps1

Depois de você ter baixado o script Publish-ResourceCatalog.ps1 mais recente para sua máquina local, execute o script da seguinte forma para atualizar o serviço Catálogo de recursos:

.\Publish-ResourceCatalog.ps1 -action update -package "UiPath.ResourceCatalogService-Win64.zip" -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<appservice_name>"

Importante: o script MigrateTo-ResourceCatalog.ps1 deve ser executado ao atualizar o serviço Catálogo de recursos.