- Primeros pasos
- Requisitos
- Mejores prácticas
- Instalación
- Actualizando
- Servidor de identidad
- Complemento de alta disponibilidad
Guía de instalación de Orchestrator
Sobre actualizar y migrar
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.
Antes de ponerse con una actualización o instalación de Orchestrator, repasa la siguiente lista de tareas:
|
Descripción |
Detalles |
|---|---|
|
|
Asegúrate de cumplir los requisitos previos, y los requisitos de hardware y software para la versión que quieres instalar. |
|
|
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. |
|
|
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. |
|
|
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. |
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:
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.
Una actualización compleja de Orchestrator y sus componentes en uno o múltiples nodos, en el portal de Azure.
UiPathStudio.msi y UiPathOrchestrator.msi.
UiPathStudio.msi y UiPathOrchestrator.msi, UiPathPlatformInstaller.exe no acepta argumentos de línea de comandos.
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.
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.
appsettings.Production.json.
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").
web.config, se te avisará de los cambios manuales que deberás llevar a cabo en tus proveedores externos preexistentes.
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);-- 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.
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.
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.PathNuGet.Activities.PathNuget.EnableRedisNodeCoordinaciónNuget.EnableNugetServerLoggingNuGet.EnableSystemMonitoringNuGet.Repositorio.Tipo
NuGet.Packages.Path y NuGet.Activities.Path en web.config para la versión anterior de Orchestrator.
~/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 |
|---|---|
|
|
|
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.
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
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.
- Información general
- Lista de comprobación previa a la instalación
- Actualización directa de Orchestrator
- Utilizando el instalador de Windows
- Uso del script de Azure
- Funcionamiento del instalador de UiPathPlatform
- Consideraciones para la actualización
- Cifrado
- Certificados
- Base de datos
- Proveedores externos
- Problemas conocidos
- Actualización de tu licencia después de la instalación
- Migración de paquetes
- Ubicación predeterminada
- Ubicación personalizada
- Matriz de migración de paquetes
- Errores de migración
