Actualizar el script de Azure

ADVERTENCIA: Ten en cuenta que esta información se refiere a la versión a la que se está actualizando, NO a la versión desde la que se está actualizando. Por ello, asegúrate de leer los detalles correctos antes de continuar.

Importante:

• Si utilizas Active Directory (AD) y estás planeando actualizar a 2023.4.0, te recomendamos encarecidamente que saltes directamente a la versión 2023.4.3, ya que 2023.4.0, 2023.4.1 y 2023.4.2 se ven afectados por un problema de AD.

• Si no lo has hecho previamente (p. ej., actualizar desde v2019.10), comprueba que has creado los servicios de la aplicación para:
  • Servidor de identidad
  • Servicio de Webhooks
  • Servicio de catálogo de recursos
• Antes de ejecutar el script Publish-Orchestrator.ps1, comprueba que has eliminado el módulo de AzureRM PowerShell. Recomendamos utilizar Az como alternativa. No se puede tener instalados a la vez los módulos de AzureRM y Az al mismo tiempo.
• Si no se detecta la versión de Az deseada, y AzureRM está presente al ejecutar el script, se te solicitará que confirmes la eliminación de AzureRM incluso en instalaciones no atendidas.
• La actualización a Az v6.0.0 cuando se está usando cualquier versión anterior del módulo hace que se muestre el siguiente mensaje: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Para solucionar este problema, asegúrate de ejecutar Publish-Orchestrator.ps1 en una nueva sesión de PowerShell.

1. Descarga el último archivo UiPathOrchestrator.zip disponible.
2. Desbloquea el archivo UiPathOrchestrator.zip utilizando el comando de PowerShell Unblock-File. Por ejemplo, Unblock-File .\UiPathOrchestrator.zip.
3. Descomprime UiPathOrchestrator.zip.
4. Ejecuta el script Publish-Orchestrator.ps1 en PowerShell en la instancia de Orchestrator que deseas actualizar, tal y como se muestra a continuación. Ten en cuenta que tu configuración de UiPath.Orchestrator.dll.config (anteriormente web.config) se mantiene si no se especifica explícitamente como parámetros de script.
5. Ejecuta el script Publish-IdentityServer.ps1 en PowerShell en tu instancia de Identity Server, como se indica a continuación.
6. Ejecuta el script Publish-Webhooks.ps1 en PowerShell en tu instancia de Servicio de Webhooks, como se indica a continuación.
7. Ejecuta el script Publish-ResourceCatalog.ps1 en PowerShell, en tu instancia de servicio de catálogo de recursos, tal y como se muestra a continuación.
8. Ejecuta el script MigrateTo-ResourceCatalog.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
9. Si actualizas una instancia de Orchestrator multinodo, descarga todas las claves de la caché de Redis mediante el comando FLUSHALL o FLUSHDB . Más información sobre ellos aquí y aquí.

10. Abre la aplicación web en el portal de Azure y dirígete a Configuración > Configuración general y selecciona los siguientes ajustes:

    • Stack debería establecerse como .NET Core.
    • Platform debería establecerse como 64 Bit.
    • Web sockets debe establecerse en On si no utiliza el servicio Azure SignalR

11. Inicia el servicio de aplicación de Orchestrator. Disfruta de Orchestrator en tu portal de Azure.

12. Reinicia el servicio de UiPath Robot en todas las máquinas de Robot que tengas conectadas a Orchestrator.

Actualización de Publish-Orchestrator.ps1

Una vez descargado el último script Publish-Orchestrator.ps1 en tu máquina local, ejecuta el script de la siguiente manera para actualizar 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 los módulos Test Automation, Insights y Update Server, ejecuta el script de la siguiente manera:

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

Actualización Publish-IdentityServer.ps1

Importante: Si no lo has hecho previamente (por ejemplo actualizar desde v2019.10), comprueba que has creado el servicio de aplicaciones para Identity Server. Comprueba que el script Publish-IdentityServer.ps1 tiene como destino el servicio de aplicación de Identity Server.

Después de descargar el último script Publish-IdentityServer.ps1 en tu máquina local, ejecuta el script como se indica para actualizar la aplicación web de Azure del 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

Actualización de Publish-Webhooks.ps1

Importante: si no lo ha hecho anteriormente (por ejemplo, actualizando desde v2019.10), asegúrate de haber creado el servicio de aplicación para el servicio de Webhooks. Asegúrate de que el script Publish-Webhooks.ps1 se dirige al servicio de aplicaciones de Webhooks.

Después de haber descargado y extraído el último archivo UiPath.WebhookService.Web.zip a tu máquina local, ejecuta el script Publish-Webhooks.ps1 como se indica a continuación para actualizar la aplicación web de Azure del Servicio Webhooks:

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

Actualización de Publish-ResourceCatalog.ps1

Una vez descargado el último script Publish-ResourceCatalog.ps1 en tu máquina local, ejecuta el script de la siguiente manera para actualizar el servicio de 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: El script MigrateTo-ResourceCatalog.ps1 debe ejecutarse al actualizar el servicio de catálogo de recursos.