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.

Para ver si tu versión antigua de Orchestrator puede actualizarse a una más reciente, comprueba la matriz Rutas de actualización de Orchestrator en nuestra Guía general.

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. Documentación y descarga de la herramienta de configuración de la plataforma.
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.

Si la versión de Orchestrator que quieres actualizar se instaló utilizando el ya obsoleto UiPathPlatformInstaller.exe, utiliza el instalador de Windows para actualizar a esta versión.

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.

Consideraciones para la actualización

Cifrado

Durante una actualización de Orchestrator, el instalador no puede leer una sección cifrada dentro web.configde . Para leer EncryptionKey desde web.config de Orchestrator y luego migrarlo a appsettings.Production.json de Identity Server, la clave debe ser texto sin formato. Tendrás que descifrar manualmente la sección antes de actualizar Orchestrator. Una vez finalizado el proceso de actualización de Orchestrator, recuerda volver a cifrar la sección SecureAppSettings en web.config.

Certificados

Ten en cuenta los nuevos requisitos de certificación. Si tu certificado existente no los cumple, aquí puedes ver cómo obtener un certificado válido y cómo reemplazarlo en la instancia de Orchestrator existente antes de actualizar.

Por motivos de seguridad, asegúrate de usar una clave pública en 2048 bits para el certificado utilizado para firmar los tokens de acceso generados por Identity Server. La ubicación del certificado debe establecerse dentro de la sección Credencial de firma de appsettings.Production.json.

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.

Usuarios

Al actualizar a la última versión de Orchestrator, todas tus cuentas locales se migran automáticamente de Orchestrator a Identity Server y se convierten al formato requerido.

Este cambio no afecta a tus robots.

Nota: Si alguna vez tuvo la versión 2018.4 y no completó la conversión de las cuentas de usuario importadas de Active Directory en cuentas de directorio (o no convirtió a todos los usuarios importados), las cuentas de directorio que no se convirtieron deben iniciar sesión interactivamente en Orchestrator al menos una vez para finalizar la conversión. Iniciar sesión en el portal de Administración de identidades o iniciar sesión desde UiPath Studio o UiPath Assistant no completa la conversión de la cuenta.

Una vez completada la conversión, ya no podrás usar la autenticación básica para iniciar la sesión con los respectivos usuarios.

Identidades del grupo de aplicaciones

Cuando actualices a la versión más reciente de Orchestrator, recomendamos encarecidamente que utilices el mismo tipo de identidad del grupo de aplicaciones para Identity Server y Webhooks que hayas utilizado para Orchestrator durante la instalación original.

Por ejemplo, si estableces el tipo de identidad del grupo de aplicaciones como cuenta personalizada, durante la instalación de Orchestrator v2020.10, al actualizar a la versión 2021.10, selecciona el mismo tipo de identidad del grupo de aplicaciones (por ejemplo, cuenta personalizada) tanto para la aplicación de Identity Server como para la de Webhooks. De lo contrario, el acceso al servidor SQL podría quedar bloqueado.

Azure Key Vault

Cuando accedes a un almacén de claves de Azure desde una nube diferente a la pública, debes establecer la variable de entorno AZURE_AUTHORITY_HOST en el valor correspondiente (es decir, "AZURE_AUTHORITY_HOST": "https://login.microsoftonline.us/"). Para obtener más información sobre los valores, consulta la documentación de la autenticación de Microsoft Entra y las nubes nacionales: plataforma de identidad de Microsoft .

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

Después de actualizar o migrar Orchestrator, te recomendamos actualizar la información de tu licencia desde la página Licencias utilizando la activación con o sin conexión.Para obtener instrucciones, consulta Activar tu licencia.

Importante: si actualizas o migras desde una versión anterior a la 2019.10, debe actualizar la información de su licencia; de lo contrario, no se beneficiará del período de gracia al caducar la licencia, lo que puede provocar la interrupción del servicio.

Migración de paquetes

En v2020.10+, Legacy ya no será un tipo de repositorio NuGet compatible. Los paquetes que residían anteriormente en un repositorio Legacymigrarán a un repositorio .Composite Para los repositorios compuestos, la ubicación del paquete se configura utilizando los parámetros Storage.Type y Storage.Location en UiPath.Orchestrator.dll.config. Después de la actualización, toda la configuración de la aplicación relacionada con Legacyquedará obsoleta y ya no surtirá efecto:

• NuGet.Packages.Path
• NuGet.Activities.Path
• Nuget.EnableRedisNodeCoordinación
• Nuget.EnableNugetServerLogging
• NuGet.EnableSystemMonitoring
• NuGet.Repositorio.Tipo

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	Valores predeterminados 2020.10+: UiPath.Orchestrator.dll.config
<add key="NuGet.Packages.Path" value="~/NuGetPackages" /> <add key="NuGet.Activities.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 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
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.