Mise à jour à l'aide du script Azure

Avertissement : Veuillez garder à l’esprit que ces informations concernent la version vers laquelle vous effectuez la mise à niveau, et non la version à partir de laquelle vous effectuez la mise à niveau. Veillez donc à prendre connaissance des informations adéquates avant de continuer.

Important :

• Si vous utilisez Active Directory (AD) et que vous prévoyez d’effectuer la mise à niveau vers 2023.4.0, nous vous recommandons fortement de passer directement à la version 2023.4.3, car les versions 2023.4.0, 2023.4.1 et 2023.4.2 sont affectées par un problème au niveau d’AD.

• Si vous ne l'avez pas déjà fait (par exemple, la mise à niveau depuis v2019.10), vérifiez que vous avez créé les services d'application pour :
  • Serveur d'identité
  • Webhooks Service
  • Service de catalogue de ressources
• Avant d’exécuter le script Publish-Orchestrator.ps1, assurez-vous de supprimer le module PowerShell AzureRM. Nous vous recommandons d’utiliser Az comme alternative. L’installation simultanée de modules AzureRM et Az n’est pas prise en charge.
• Si la version Az souhaitée n’est pas détectée et qu’AzureRM est présent lors de l’exécution du script, vous êtes invité à confirmer la suppression d'AzureRM même sur les installations Unattended.
• Lorsqu'une version précédente du module est utilisée, la mise à niveau vers Az v6.0.0 fait apparaître le message suivant : WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Afin de résoudre ce problème, assurez-vous d'exécuter Publish-Orchestrator.ps1 dans une nouvelle session PowerShell.

1. Téléchargez la dernière archive UiPathOrchestrator.zip disponible.
2. Déverrouillez le fichier UiPathOrchestrator.zip à l'aide de la commande Unblock-File de PowerShell. Par exemple, Unblock-File .\UiPathOrchestrator.zip.
3. Décompressez UiPathOrchestrator.zip.
4. Exécutez le script Publish-Orchestrator.ps1 dans PowerShell dans l'instance d'Orchestrator à mettre à jour, comme indiqué ci-dessous. Tenez compte du fait que vos paramètres UiPath.Orchestrator.dll.config (anciennement web.config) sont conservés s'ils ne sont pas explicitement spécifiés comme des paramètres de script.
5. Exécutez le script Publish-IdentityServer.ps1 dans PowerShell sur votre instance Identity Server, comme indiqué ci-dessous.
6. Exécutez le script Publish-Webhooks.ps1 dans PowerShell sur votre instance Webhooks Service, comme indiqué ci-dessous.
7. Exécutez le script Publish-ResourceCatalog.ps1 dans PowerShell sur votre instance du service de catalogue de ressources, comme indiqué ci-dessous.
8. Exécutez le script MigrateTo-ResourceCatalog.ps1 dans PowerShell en utilisant les paramètres décrits ici.
9. Si vous mettez à jour une instance Orchestrator multi-nœuds, videz toutes les clés de cache Redis à l'aide de la commande FLUSHALL ou FLUSHDB . Plus d'informations à leur sujet sont disponibles ici et ici.

10. Ouvrez l’application Web dans le portail Azure, puis accédez à Configuration > Paramètres généraux et vérifiez les paramètres suivants :

    • Stack devrait être réglé sur .NET Core.
    • Platform devrait être réglé sur 64 Bit.
    • Web sockets doit être défini sur On si vous n’utilisez pas le service Azure SignalR

11. Démarrez le service d'applications Orchestrator. Profitez d'Orchestrator sur votre portail Azure.

12. Redémarrez le service UiPath Robot sur toutes les machines Robot que vos avez connectées à Orchestrator.

Mise à jour Publish-Orchestrator.ps1

Une fois que vous avez téléchargé le dernier script Publish-Orchestrator.ps1 sur votre machine locale, exécutez le script comme suit pour mettre à jour 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

Pour inclure les modules Automatisation de test, Insights et Mettre à jour le serveur, exécutez le script comme suit :

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

Paramètres Publish-IdentityServer.ps1

Attention : si vous ne l'avez pas déjà fait (par exemple, la mise à niveau depuis v2019.10), vérifiez que vous avez créé le service d'application pour Identity Server. Assurez-vous que le script Publish-IdentityServer.ps1 cible le service d'application Identity Server.

Une fois que vous avez téléchargé le dernier script Publish-IdentityServer.ps1 sur votre machine locale, exécutez le script comme suit pour mettre à jour l'application Web Azure du serveur d'identité :

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

Mise à jour Publish-Webhooks.ps1

Important : si vous ne l'avez pas déjà fait (par ex. mise à niveau à partir de v2019.10), assurez-vous que vous avez créé le service d'application pour le service Webhooks. Assurez-vous que le script Publish-Webhooks.ps1 cible le service d'application Webhooks.

Une fois que vous avez téléchargé et extrait la dernière archive UiPath.WebhookService.Web.zip sur votre machine locale, exécutez le script Publish-Webhooks.ps1 comme suit pour mettre à jour l'application Web Azure du service Webhook :

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

Mise à jour Publish-ResourceCatalog.ps1

Une fois que vous avez téléchargé le dernier script Publish-ResourceCatalog.ps1 sur votre machine locale, exécutez le script comme suit pour mettre à jour le service de catalogue de ressources :

.\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>"

Important : le script MigrateTo-ResourceCatalog.ps1 doit être exécuté lors de la mise à niveau du service de catalogue de ressources.