Sobre actualizar y migrar

Información general

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.

Orchestrator puede actualizarse directamente a la versión v2020 en los siguientes casos:

• Tienes una versión2020.x
• Tienes una versión2020.x
• Tienes cualquier versión2020.x

Para ver las versiones más recientes disponibles, consulta la página Notas de la versión.

Lista de comprobación previa a la instalación

Antes de ponerse con una actualización o instalación de Orchestrator, repasa la siguiente lista de tareas:

Descripción	Detalles
Comprueba los requisitos del sistema	Asegúrate de cumplir los requisitos previos, y los requisitos de hardware y software para la versión que quieres instalar. Requisitos de hardware Requisitos de software Requisitos previos
Descubre los cambios introducidos en la nueva implementación	Una nueva implementación de Orchestrator conlleva cambios con los que deberías estar familiarizado. Algunos de estos asuntos deben estar resueltos antes de una actualización/instalación. Otros son notas sobre los cambios más importantes y recomendaciones sobre cómo aprovechar al máximo la nueva versión. Se ha cambiado el tiempo de ejecución de .NET Framework a .NET Core Se han realizado varios cambios en los archivos de configuración Se ha actualizado el protocolo SignalR. Se ha renovado la infraestructura de NuGet. Se ha actualizado la biblioteca Swagger. Cambios en la API
Ejecuta la herramienta de configuración de la plataforma	La herramienta de configuración de la plataforma es un script de PowerShell que se utiliza para ayudarte a instalar/actualizar Orchestrator con éxito. Te ayuda a comprobar la estabilidad y la predisposición de tu entorno antes de una actualización, y te ayuda a realizar varias operaciones tras la instalación. Platform Configuration Tool documentation and download.
Detención de Orchestrator	Las actualizaciones de Orchestrator deberán llevarse a cabo con la aplicación detenida. Realizar cualquier actualización mientras se ejecuta la aplicación puede originar errores y no es posible.

Actualización directa de Orchestrator

Estos artefactos de instalación se incluyen con tu compra de Orchestrator, o por medio de tu gestor de satisfacción del cliente o de nuestro equipo de soporte. Hay varias formas de actualizar directamente:

Utilizando el instalador de Windows

UiPathOrchestrator.msi realiza una actualización local que copia toda tu configuración y crea una carpeta de copia de seguridad para la versión anterior. Es perfecto tanto para la arquitectura de un solo nodo como para la multinodo. Alguna configuración de web.config no se copiará si la versión desde la que actualizas se instaló utilizando scripts en desuso. La funcionalidad de reparación del instalador de Windows no es compatible.

Descubre cómo actualizar utilizando el instalador de Windows.

Uso del script de Azure

Una actualización compleja de Orchestrator y sus componentes en uno o múltiples nodos, en el portal de Azure.

Descubre cómo actualizar utilizando el script de Azure.

Funcionamiento del instalador de UiPathPlatform

Un archivo ejecutable que te permite actualizar Orchestrator, UiPath Robot y Studio. Es adecuado para arquitecturas de un solo nodo. Los procesos son los mismos que los que realizarías al utilizar instaladores de Windows, UiPathStudio.msi y UiPathOrchestrator.msi.

A diferencia de UiPathStudio.msi y UiPathOrchestrator.msi, UiPathPlatformInstaller.exe no acepta argumentos de línea de comandos.

Consideraciones para la actualización

Cifrado

During an Orchestrator update, the installer cannot read an encrypted SecureAppSettings section within web.config . In order to read the EncryptionKey from Orchestrator's web.config and then migrate it into Identity Server's appsettings.Production.json, the key must be plain text. You need to manually decrypt the section before updating Orchestrator. After the Orchestrator update process was finalized, remember to re-encrypt the SecureAppSettings section in web.config.

Certificados

Note the new certificate requirements. If your existing certificate doesn't meet them, here is how to get a valid certificate and how to replace it in the existing Orchestrator instance, before upgrading.

For security reasons, for the certificate used to sign the access tokens generated by the Identity Server, make sure to use a public key on 2048 bits. The certificate's location has to be set within appsettings.Production.json's Signing Credential section.

Base de datos

Independientemente de cómo actualices, si la base de datos a la que apuntas no existe, esta se creará automáticamente mientras se ejecuta la actualización. Si apuntas a una base de datos existente, esta se actualizará durante el mismo proceso. La base de datos SQL de Orchestrator está configurada automáticamente para que no distinga entre mayúsculas y minúsculas en la instalación ("OrchDB" = "orchdb").

Proveedores externos

Mientras realizas la actualización, si tienes algún proveedor externo habilitado en web.config, se te avisará de los cambios manuales que deberás llevar a cabo en tus proveedores externos preexistentes.

Problemas conocidos

Errores de tiempo de espera de la base de datos al actualizar a 2023.10+

Tener más de 100 000 grupos en Orchestrator puede provocar un error de tiempo de espera al actualizar a 2023.10+.

Para solucionarlo, ejecuta el siguiente script directamente en tu base de datos y vuelve a intentar la actualización:

-- 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 antivirus

Algunos programas antivirus pueden evitar que los scripts de migración de datos funcionen correctamente durante una actualización.

Problemas con los intentos de inicio de sesión

Después de actualizar tu Orchestrator desde la versión 2019.10 o anterior, la página Perfil no mostrará los intentos de inicio de sesión anteriores a esa actualización.

Actualización de tu licencia después de la instalación

After you upgrade or migrate Orchestrator, we recommend that you update your license information from the Licenses page using either online or offline activation.

Importante:

Si actualizas o migras desde una versión anterior a la 2019.10, debes actualizar la información de tu licencia, de lo contrario no te beneficiarás del período de gracia al vencimiento de la licencia, lo que puede causar la interrupción del servicio.

Migración de paquetes

In v2020.10+, Legacy is no longer a supported NuGet repository type. Packages previously residing in a Legacy repository are migrated to a Composite repository. For composite repositories, package location is configured using the Storage.Type and Storage.Location parameters in UiPath.Orchestrator.dll.config. After the upgrade, all Legacy-related app settings become deprecated and no longer have an effect:

• NuGet.Packages.Path
• NuGet.Activities.Path
• Nuget.EnableRedisNodeCoordination
• Nuget.EnableNugetServerLogging
• NuGet.EnableFileSystemMonitoring
• NuGet.Repository.Type

La nueva ubicación del paquete depende de cómo configuraste los parámetros NuGet.Packages.Path y NuGet.Activities.Path en web.config para la versión anterior de Orchestrator.

Ubicación predeterminada

Si almacenaste los paquetes en las ubicaciones predeterminadas (~/NuGetPackages y ~/NuGetPackages/Activities), la nueva ubicación del paquete se convierte en RootPath=.\Storage.

Valores predeterminados Pre 2020.10: web.config	2020.10 Claves predeterminadas - UiPath.Orchestrator.dll.config
<add key="NuGet.Packages.Path" value="~/NuGetPackages" /> <add key="NuGet.Packages.Path" value="~/NuGetPackages/Activities" />	<add key="Storage.Type" value="FileSystem" /> <add key="Storage.Location" value="RootPath=.\Storage" />

Ubicación personalizada

Si almacenaste los paquetes en una ubicación personalizada, durante la instalación se te pedirá que indiques una nueva ubicación de almacenamiento. Para las instalaciones silenciosas, los parámetros STORAGE_TYPE y STORAGE_LOCATION se harán obligatorios, a menos que los añadas específicamente en web.config (Storage.Type y Storage.Location) antes de la actualización.

Matriz de migración de paquetes

La matriz que aparece a continuación describe cuándo se solicitan o se ignoran los parámetros STORAGE_TYPE y STORAGE_LOCATION durante una actualización. La matriz tiene en cuenta la versión desde la que te actualizas, además de la personalización de la ubicación del paquete tanto en la versión anterior como en la versión 2020.10 y posteriores.

Por ejemplo, en función de esta combinación de características, la matriz muestra que se solicitan los dos parámetros (señalados con una marca de verificación) en Modo silencioso en los siguientes casos:

• Para una actualización desde la versión 2018.4, si el paquete se ha almacenado en una ubicación personalizada

• Para una actualización desde la versión 2019.4+, si el paquete se ha almacenado en una ubicación personalizada pero su nueva ubicación de almacenamiento es una ubicación predeterminada

  Actualizar desde	Ubicación anterior heredada	Nueva ubicación compuesta	Parámetros solicitados en la ventana de almacenamiento	Parámetros solicitados en el modo silencioso	Parámetros ignorados desde CMD
  2018.4	Predeterminado
  2018.4	Personalizar
  2019.4+	Predeterminado	Predeterminado
  2019.4+	Predeterminado	Personalizar
  2019.4+	Personalizar	Predeterminado
  2019.4+	Personalizar	Personalizar

Errores de migración

Si, por cualquier motivo, la migración de paquetes da un error, se te mostrarán las siguientes opciones:

• Reintentar: se reinicia la migración de paquetes. Se omitirán los paquetes que ya se hayan migrado.
• Abortar: se reinicia la instalación. Durante el paso de migración, los paquetes que ya se hayan migrado no se omitirán y se migrarán de nuevo. Por ello, puede que encuentres archivos duplicados en diferentes contenedores. Esto solo se produce al migrar desde versiones anteriores a la versión 2019.4.
• Continuar: se continúa con la migración.

Actualizaciones a partir de 2019.10

La migración, como parte de una actualización desde la versión 2019.10, puede hacer que cambien los nombres de los paquetes y dejarían de estar disponibles en Orchestrator. Si esto sucede, te recomendamos cargar manualmente cualquier paquete afectado.