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 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. Run the MigrateTo-ResourceCatalog.ps1 script, in PowerShell, using the parameters described here.
9. Si vous mettez à jour une instance d’Orchestrator multinœud, videz toutes les clés du cache Redis à l’aide de la commande FLUSHALL ou FLUSHDB. Vous trouverez plus d’informations disponibles ici ou 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>" -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

Important :

If you have not previously done so (e.g. upgrading from v2019.10), ensure that you have created the app service for Identity Server. Make sure the Publish-IdentityServer.ps1 script targets the Identity Server app service.

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 exemple la mise à niveau depuis v2019.10), vérifiez que vous avez créé le service d'application pour le Service Webhook. 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.