- Primeros pasos
- Requisitos
- Mejores prácticas
- Instalación
- Actualizando
- Servidor de identidad
- Solución de problemas de errores de inicio
Consideraciones sobre la instalación
Este artículo identifica las principales áreas afectadas que debes tener en cuenta en cualquier nueva implementación de Orchestrator. Algunos de los elementos tratados en este artículo deben ser atendidos antes de cualquier actualización/instalación. Varios de ellos son validados por el instalador o por la Herramienta de configuración de la plataforma, en caso de que decidas utilizarla. Te recomendamos encarecidamente que descargues y utilices la Herramienta de configuración de la plataforma para validar tu entorno antes de una actualización.
TargetFramework
debe actualizarse desde el .NET Framework 4.7.2 anterior a un marco de trabajo de destino compatible. El marco de destino tanto de los almacenes de credenciales como de las extensiones NLog es comprobado por el instalador UiPathOrchestrator.msi
.
Esta restricción también afecta a cualquier referencia que pueda tener un complemento o una extensión de NLog.
Marcos de destino compatibles | Versiones compatibles |
---|---|
Estándar .NET |
1.0 - 1.6 |
Estándar .NET |
2.0 (recommended) |
.NET |
8.0 |
Puede que necesites recompilar cualquier complemento del almacén de credenciales y las extensiones NLog que hayas desarrollado por tu cuenta.
.dll
destinados a los marcos de destino especificados. La mayoría de los destinos NLog son compatibles con los marcos de destino especificados. No obstante, debes asegurarte de copiar el .dll
correcto. Por ejemplo, en caso de utilizar ,, es necesario que descargues el .nupkg
archivo , que lo abras como .zip
, navegues hasta la carpeta lib\) etstandard2.0
y utilices el .dll
archivo desde allí.
CLIPasswordSDK64.exe
que viene con CyberArk AIM.
CLIPasswordSDK64.exe
en la ruta de instalación predeterminada de CyberArk AIM, es decir, en: C:\Program Files(x86)\CyberArk\ApplicationPasswordSdk\CLIPasswordSDK64.exe. Si CyberArk AIM no se ha instalado en la ruta predeterminada, debe añadirse una entrada de configuración en UiPath.Orchestrator.dll.config, para indicar la ruta correcta. La ruta puede especificarse en la sección appSettings
en web.config
antes de la instalación o bien el UiPath.Orchestrator.dll.config
tras ella.
Ejemplo:
<add key="Plugins.SecureStores.CyberArk.CLIPasswordSDKExePath" value="D:\CustomFolder\CLIPasswordSDK64.exe" />
<add key="Plugins.SecureStores.CyberArk.CLIPasswordSDKExePath" value="D:\CustomFolder\CLIPasswordSDK64.exe" />
En .NET Core hay dos mecanismos para especificar el proxy:
Utilizar variables de entorno
web.config
utilizando la siguiente sintaxis: <environmentVariable name="[insert_variable_here]" value="[insert_address_here]" />
, por ejemplo <environmentVariable name="HTTP_PROXY" value="http://127.0.0.1:8080" />
.
Variable | Descripción |
---|---|
HTTP_PROXY | El servidor proxy utilizado en las solicitudes HTTP. |
HTTPS_PROXY | El servidor proxy utilizado en las solicitudes HTTPS. |
ALL_PROXY | El servidor proxy utilizado en las solicitudes HTTP o HTTPS en el caso de que HTTP_PROXY o HTTPS_PROXY no hayan sido definidos.
|
NO_PROXY | Una lista de los nombres de host, separados por comas, que deben excluirse del proxy. |
Ejemplos:
- Sin autenticación:
ALL_PROXY=http://localhost:8888
- Con autenticación:
ALL_PROXY=http://user:password@localhost:8888
Utilizando el sistema proxy predeterminado (en ajustes de IE o ajustes de Windows proxy), si las variables del entorno no han sido establecidas
Consulta la documentación oficial de Microsoft aquí.
web.config
utilizando la etiqueta <defaultProxy>
. Ejemplo de configuración que ya no es compatible:
<system.net>
<defaultProxy>
<proxy usesystemdefault="True" proxyaddress="http://<ip>:<port>" bypassonlocal="True" />
</defaultProxy>
</system.net>
<system.net>
<defaultProxy>
<proxy usesystemdefault="True" proxyaddress="http://<ip>:<port>" bypassonlocal="True" />
</defaultProxy>
</system.net>
web.config
a UiPath.Orchestrator.dll.config
: El nuevo archivo conserva la misma estructura que el antiguo archivo web.config
y está ubicado en el mismo directorio. Recuerda que cambiar el archivo UiPath.Orchestrator.dll.config
no hace que IIS se reinicie. Las siguientes secciones se han trasladado:
- cadenas de conexión
- Ajustes de la aplicación
- Configuración NLog
- Configuración de Quartz
- la clave de cifrado
web.config
ha sido rediseñada para que contenga solo la configuración utilizada por IIS. Al actualizar, el instalador trasladará automáticamente las secciones mencionadas anteriormente al nuevo archivo de configuración. Transformará la configuración que se ha dejado en web.config
para que coincida con lo que sea necesario para la versión más reciente de Orchestrator. La personalización del cliente, incluidos los verbos deshabilitados, los módulos habilitados/deshabilitados, las reglas de reescritura personalizadas, se conservan.
Consulta la documentación de web.config.
Consulta la documentación de UiPath.Orchestrator.dll.config.
Las cadenas de conexión y los ajustes de la aplicación ya no serán visibles en el administrador de IIS. No se ofrece soporte para la utilización del administrador de IIS para editar las cadenas de conexión de Orchestrator.
connectionStringName
ha sido reemplazada por connectionString
. Su valor debe seguir la siguiente sintaxis: connectionString="${ui-connection-strings:item=Default}"
, donde Default
es el nombre de la cadena de conexión que deseas utilizar de la sección <connectionStrings>
.
Consulta la documentación sobre Destinos de los registros de ejecución de Orchestrator.
Database
, la propiedad connectionStringName
se cambia automáticamente a connectionString
durante la actualización. Si introduces manualmente el destino en el archivo de configuración después de la instalación/actualización, utiliza la nueva propiedad con el valor correcto.
Hemos actualizado la biblioteca SignalR a una versión más nueva que no es compatible con los clientes antiguos de UiPath Robot. Para seguir notificando a los Robots desatendidos cuando haya trabajos disponibles, se implementó un mecanismo de compatibilidad para simular el antiguo protocolo SignalR sobre Long Polling. Los Robots anteriores a 2020.10 se conectan a Orchestrator solo a través de Long Polling.
Los scaleouts de SignalR requieren sesiones sticky para todos los protocolos que no sean WebSocket (por ejemplo, SSE y Long Polling).
Solo se habilita el transporte WebSocket de forma predeterminada, ya que Orchestrator da por hecho que las sesiones sticky no están habilitadas en el equilibrador de carga del cliente.
<add key="Scalability.SignalR.RequireStickySessions" value="true" />
en UiPath.Orchestrator.dll.config
para habilitar las sesiones adhesivas. Si se establece como true
, se habilitan todos los transportes y Orchestrator supone que las sesiones sticky del equilibrador de carga están habilitadas. Habilitar las sesiones sticky en UiPath.Orchestrator.dll.config
, sin habilitarlas en el equilibrador de carga, dará como resultado conexiones de SignalR fallidas.
Scalability.SignalR.AuthenticationEnabled
ha sido descartado.
Puedes sufrir retrasos de hasta 30 segundos si utilizas una actividad Elemento en la cola de espera anterior a 2020.10.
Hemos actualizado el protocolo interno de las fuentes NuGet de la v2 a la v3.
Legacy
ya no será un tipo de repositorio NuGet compatible. Al actualizar, todos los repositorios de tipo Legacy
se migrarán a Composite
.
NuGet.Packages.Path
y NuGet.Activities.Path
en web.config
para la versión anterior de Orchestrator.
- Si almacenaste los paquetes en las ubicaciones predeterminadas (
~/NuGetPackages
y~/NuGetPackages/Activities
), la nueva ubicación del paquete se convierte enRootPath=.\Storage
. - Si almacenaste los paquetes en una ubicación personalizada, durante la instalación se te pedirá que indiques una nueva ubicación de almacenamiento. En instalaciones silenciosas, los parámetros
STORAGE_TYPE
ySTORAGE_LOCATION
se vuelven obligatorios, a no ser que los especifiques enweb.config
antes de la actualización.
UiPath.Orchestrator.dll.config
. Tras la actualización, todos los ajustes de la aplicación relacionados con Legacy
quedarán obsoletos y ya no tendrán ningún efecto.
NuGet.Packages.Path
NuGet.Activities.Path
Nuget.EnableRedisNodeCoordinación
Nuget.EnableNugetServerLogging
NuGet.EnableSystemMonitoring
NuGet.Repositorio.Tipo
Composite
repositorios.
swagger.json
, que describe la API de Orchestrator. Si confías en un generador de bibliotecas cliente que utilice la descripción de la API en el archivo Swagger (por ejemplo, AutoRest, Swagger Codegen), el código generado será significativamente diferente.
- .NET Core 3.1
- Marco de destino
- Complementos del almacén de credenciales - CyberArk
- Configuración de proxy
- Archivos de configuración
- web.config
- IIS Manager
- Objetivos NLog
- Protocolo SignalR
- SignalR con WebSockets
- Sesiones Sticky de Scaleouts de SignalR
- Escalamiento de servidor SQL SignalR
- Actividad de los elementos en la cola de espera
- Infraestructura NuGet
- Repositorios heredados
- Biblioteca Swagger
- Cambios en la API
- API con parámetros POST de formulario