- Primeros pasos
- Requisitos
- Mejores prácticas
- Instalación
- Actualizando
- Servidor de identidad
- Solución de problemas de errores de inicio
Sobre actualizar y migrar
Puedes actualizar directamente Orchestrator a 2022.4 si actualmente usas cualquiera de las siguientes versiones:
- 2021.x
- 2020.x
-
2019.x
Importante:Si usas la versión 2018.4, debes actualizar a 2019.x o 2020.x o 2021.x y luego pasar a 2022.4.
Si usas una versión inferior a la versión 2018.4, necesitas actualizarte a la versión 2018.4 o a la versión 2019.x o 2020.x, y luego pasa a 2022.4.
Recomendamos usar la versión 2019.10 como versión intermedia.
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 |
---|---|
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. |
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. |
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. |
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. |
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.
UiPathPlatformInstaller.exe
, utiliza el instalador de Windows para actualizar a esta versión.
Una actualización compleja de Orchestrator y sus componentes en uno o múltiples nodos, en el portal de Azure.
web.config
de . 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.
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.
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.
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.
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.Para obtener instrucciones, consulta Activar tu licencia.
Legacy
ya no será un tipo de repositorio NuGet compatible. Los paquetes que residían anteriormente en un repositorio Legacy
migrará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 Legacy
quedará obsoleta y ya no surtirá efecto:
NuGet.Packages.Path
NuGet.Activities.Path
Nuget.EnableRedisNodeCoordinación
Nuget.EnableNugetServerLogging
NuGet.EnableSystemMonitoring
NuGet.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 |
Valores predeterminados 2020.10+: 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 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 |
|
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
- Consideraciones para la actualización
- Cifrado
- Certificados
- Base de datos
- Proveedores externos
- Usuarios
- Identidades del grupo de aplicaciones
- 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