- Primeros pasos
- Requisitos
- Mejores prácticas
- Instalación
- Consideraciones sobre la instalación
- Acerca de la instalación
- Despliegue de Azure Marketplace
- Implementación de AWS
- Herramienta de configuración de la plataforma
- Webhooks AppSettings.json
- Deshabilitar la telemetría
- Actualizando
- Servidor de identidad
- Solución de problemas de errores de inicio
Herramienta de configuración de la plataforma
La herramienta de configuración de la plataforma UiPath 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.
UiPathOrchestrator.msi
. El script agrupado se puede encontrar en la carpeta Tools
del directorio de instalación de Orchestrator, C:\Program Files (x86)\UiPath\Orchestrator\
de forma predeterminada. El script comprueba la máquina de Orchestrator. En caso de una instalación multinodo, es suficiente con ejecutar la herramienta en un solo nodo.
UiPathOrchestrator.msi
, y puede actualizarse fuera del ciclo de lanzamiento del producto. Recomendamos que descargues y utilices siempre la última versión de la herramienta, disponible a continuación.
El script consiste en tres cmdlets diseñados para realizar funciones específicas. Puede introducirse un comando de invocación de cmdlet junto a sus correspondientes parámetros en la línea de comandos para su ejecución inmediata.
Cmdlet |
Descripción |
---|---|
|
Se invoca usando el comando
-Readiness
Comprueba la estabilidad y la predisposición de tu entorno antes de una actualización, y los requisitos del certificado tras la instalación. |
|
Se invoca usando el comando
UpdateUiPathUrl
Actualiza la dirección pública de Orchestrator. |
|
Se invoca usando el comando
UpdateUiPathCertificate
Actualiza el certificado SSL de Orchestrator o el certificado de firma por token de Identity Server. |
|
Se invoca usando el comando
AddHostAdmin
Añade un administrador del sistema al tenant del host. |
Comprueba si el módulo IIS v3.1.x+ de ASP.NET Core está instalado y funciona. Si no lo está, se te insta a desinstalar y volver a instalar el ASP.Net Core Hosting Bundle.
C:\Program Files (x86)\CyberArk
. Si no lo está, se insta al usuario a añadir CLIPasswordSdk.exe
en el archivo UiPath.Orchestrator.dll.config
utilizando la clave Plugins.SecureStores.CyberArk.CLIPasswordSDKExePath
después de la instalación.
UiPath.Orchestrator.dll.config
.
web.config
está descifrado. Si lo está, deberás descifrarlo manualmente antes de actualizar. Tras la actualización, la mayoría de los ajustes de configuración de Orchestrator se trasladarán a UiPath.Orchestrator.dll.config
.
<system.webServer>
contiene alguna sección bloqueada. Si tales secciones existen, deberás desbloquearlas manualmente en IIS.
Comprueba si se utiliza el Scaleout de SQL Server. Debes saber que, durante la instalación, se habilita el Scaleout de Redis.
Comprueba que los complementos de almacén de credenciales externos apuntan a un marco compatible.
Comprueba que los complementos de NLog se dirigen a un marco compatible.
Buckets.FileSystem.Allowlist
de la aplicación está presente en las versiones de Orchestrator a partir de la v2020.4. Esto abarca tanto las comprobaciones previas a la instalación (Orchestrator v2022.4) como a comprobaciones posteriores (Orchestrator v2022.4). Las versiones de Orchestrator anteriores a la v2020.4 omiten esta comprobación.
-
Para realizar las siguientes comprobaciones, deberás desencriptar las secciones de configuración
connectionStrings
yappSettings
. Si alguna de estas secciones de configuración está cifrada, recibirás un aviso en el terminal y se omitirán las demás validaciones de depósito.Could not determine if any buckets with file system provider are in use. Config section 'connectionString' is encrypted, could not find the sql connection string to the UiPath database.
Could not determine if any buckets with file system provider are in use. Config section 'connectionString' is encrypted, could not find the sql connection string to the UiPath database. -
Si por cualquier razón, los depósitos no pudieran ser recuperados de la base de datos, aparecerá una advertencia en el terminal, y se omitirán también el resto de validaciones.
Could not determine if any buckets with file system provider are in use. Could not connect to the UiPath Database.
Could not determine if any buckets with file system provider are in use. Could not connect to the UiPath Database. - Esta validación se realiza en las rutas raíz de los depósitos recuperados de la tabla de depósitos de la base de datos de Orchestrator. Si hubiera alguna ruta descalificada, te aparecería una alerta en el terminal. Se realiza una comprobación similar para las rutas no cualificadas en las rutas de los ajustes de la aplicación
Buckets.FileSystem.Allowlist
en el archivo de configuración. - Si alguna de las rutas en las dos fuentes no fuera válida o resultara descalificada, no se tendrá en cuenta para el resto de las validaciones descritas a continuación.
-
Si la configuración de la aplicación
Buckets.FileSystem.Allowlist
no está establecida en el archivo de configuración, el terminal indicará error pidiéndote que la añadas al listado de permisos en el archivo de configuración. Las rutas sugeridas son la ruta raíz de los depósitos que hacen uso del proveedor del sistema de archivos.All storage buckets using the file system provider are not on the allowed list. Add the following setting in the configuration file to allow all exiting buckets root paths: <add key="Buckets.FileSystem.Allowlist" value="C:\work\stuff\Bucket\|C:\work\stuff\Bucket1\" />
All storage buckets using the file system provider are not on the allowed list. Add the following setting in the configuration file to allow all exiting buckets root paths: <add key="Buckets.FileSystem.Allowlist" value="C:\work\stuff\Bucket\|C:\work\stuff\Bucket1\" /> -
Si la configuración de la aplicación
Buckets.FileSystem.Allowlist
está establecida en el archivo de configuración, se realiza una validación en la ruta raíz de los depósitos que hacen uso del proveedor del sistema de archivos. Si la ruta raíz de un depósito no es una subruta de ninguna de las rutas definidas en la lista de permisos, una alerta te instará en el terminal a que añadas la ruta raíz del depósito aBuckets.FileSystem.Allowlist
.There are some storage buckets using the file system provider that are not on the allowed list. The buckets feature will not work for buckets with root paths that are not on the allowed list. Check if any of the following paths are required to be on the allowed list and add them to the 'Buckets.FileSystem.Allowlist' key in configuration file: |C:\work\stuff\Buckets\|C:\work\stuff\Bucket1\
There are some storage buckets using the file system provider that are not on the allowed list. The buckets feature will not work for buckets with root paths that are not on the allowed list. Check if any of the following paths are required to be on the allowed list and add them to the 'Buckets.FileSystem.Allowlist' key in configuration file: |C:\work\stuff\Buckets\|C:\work\stuff\Bucket1\ -
De lo contrario, si cada ruta raíz del depósito es una subruta de cualquiera de las rutas en el listado de permisos, el terminal mostrará un mensaje de confirmación.
All storage buckets using file system provider have the root path on the allow list in the configuration file.
All storage buckets using file system provider have the root path on the allow list in the configuration file.
Comprueba que tu instancia de Orchestrator cumple con todos los requisitos de los certificados tras cualquier actualización.
Comprobaciones de los certificados SSL
- el
hostname
del sitio de Orchestrator coincide con el Sujeto o con un Nombre Alternativo del Sujeto (incluyendo comodines) en el certificado. - tiene una cadena de confianza válida, y
- no ha caducado.
Comprobaciones de los certificados de firma por token de Identity Server
- El certificado tiene el tamaño de clave adecuado (
2048
bits o más), - tiene una clave privada accesible por el usuario de AppPool, y
- no ha caducado.
Consulta la documentación sobre las consideraciones acerca de la instalación para conocer las demás áreas afectadas por cualquier actualización a la versión 2022.4 que debas tener en cuenta.
Comandos y parámetros |
Descripción |
---|---|
|
Comprueba la estabilidad y la predisposición de tu entorno antes de una actualización, y los requisitos del certificado tras la instalación. Parámetros:
|
|
Actualiza la dirección pública de Orchestrator. Parámetros:
Importante: Para utilizar este comando se necesita el módulo PowerShell de SQL Server. El módulo se instala de forma predeterminada con SQL Server. Si trabajas en una máquina que no tenga el módulo instalado, consulta aquí cómo instalarlo.
Importante: Utiliza este comando con precaución, ya que no tiene un mecanismo de reversión si un paso falla durante la ejecución.
|
|
Actualiza el certificado SSL de Orchestrator o el certificado de firma por token de Identity Server. Utilízalo en combinación con el comando
-readiness para comprobar la validez de los nuevos certificados.
Parámetros:
|
|
Si se pierde el acceso a la organización del host (por ejemplo, si perdemos la contraseña para el administrador del sistema o los únicos usuarios con cuentas de administrador del sistema abandonan la empresa), puedes utilizar este comando para añadir o restaurar un administrador del sistema. Parámetros:
|
Parámetro |
Descripción |
---|---|
|
Opcional. El nombre del sitio web de Orchestrator en la máquina de destino. Será
"UiPath Orchestrator" de forma predeterminada. -InstallationDirectory y SiteName son mutuamente excluyentes.
|
|
Opcional. Muestra información sobre las opciones de la herramienta o los comandos disponibles, tales como la sintaxis de los comandos o las comprobaciones que realiza. |
|
Opcional. La ruta del directorio de instalación de Orchestrator. Por lo general
C:\Program Files (x86)\UiPath\Orchestrator\ . -InstallationDirectory y SiteName son mutuamente excluyentes.
Nota: asegúrate de que la ruta del directorio de instalación finaliza con una barra final (
\ ).
|
|
Obligatorio. La nueva dirección pública de Orchestrator. |
|
Opcional. Cadena de conexión de la base de datos de UiPath. Si se deja vacío, el valor se lee desde el archivo
appsettings.Production.json .
|
|
Opcional. La huella digital del nuevo certificado de firma de token utilizado por el servidor de identidad de Orchestrator. |
|
Opcional. La huella digital del nuevo certificado SSL utilizado por la aplicación web de Orchestrator. |
|
Solo es obligatorio cuando utilices el comando
-AddHostAdmin . Nombre de usuario del usuario administrador del host a crear o restaurar.
|
|
Correo electrónico del usuario administrador del host a crear o restaurar cuando utilices el comando
-AddHostAdmin . Solo es obligatorio si utilizas estos proveedores de identidades externos:
|
|
Contraseña del usuario administrador del host a crear cuando utilices el comando
-AddHostAdmin . La contraseña solo es obligatoria si el usuario es un usuario de autenticación básico. La contraseña deberá cambiarse en el primer inicio de sesión.
|
Para trabajar con el script de la herramienta de configuración de la plataforma, abre un script PowerShell de administrador.
Localiza el directorio donde hayas descomprimido el archivo de la herramienta de configuración de la plataforma y cambia el directorio a esa ubicación:
cd "C:\Program Files (x86)\UiPath\Orchestrator\Tools\PlatformConfiguration"
cd "C:\Program Files (x86)\UiPath\Orchestrator\Tools\PlatformConfiguration"
-verbose
.
.\Platform.Configuration.Tool.ps1 `
-Readiness `
-SiteName "UiPath Orchestrator"
.\Platform.Configuration.Tool.ps1 `
-Readiness `
-SiteName "UiPath Orchestrator"
Valores de salida exitosos tras las comprobaciones previas a la instalación.
Validating 22.4 pre-installation requirements... Checking AspNetCore hosting module... AspNetCore hosting module is installed. Checking CyberArk CLIPasswordSDK.exe path... CyberArk CLIPasswordSDK.exe was found at the default installation path 'C:\Program Files (x86)\CyberArk\ApplicationPasswordSdk\CLIPasswordSDK.exe'. Checking Web.config sections encryption... Web.config sections are not encrypted. Checking IIS configuration locked sections... Configuration sections are not locked. Checking Orchestrator ssl certificate subject alternative names... Orchestrator host name is valid for the ssl certificate subject alternative names. Checking sql server scaleout use... Sql server scaleout is not used. Checking external credential store plugins target framework... Credential stores plugins validation is finished. Checking external NLog plugins target framework... NLog plugins validation is finished. Checking buckets with file system storage provider... All storage buckets using file system provider have the root path on the allowed list in the configuration file. Checking platform certificates... Platform certificates validation is finished. All 22.4 pre-installation checks are done. Platform readiness validations: 10 succeeded, 0 failed and 0 warning(s).
Validating 22.4 pre-installation requirements... Checking AspNetCore hosting module... AspNetCore hosting module is installed. Checking CyberArk CLIPasswordSDK.exe path... CyberArk CLIPasswordSDK.exe was found at the default installation path 'C:\Program Files (x86)\CyberArk\ApplicationPasswordSdk\CLIPasswordSDK.exe'. Checking Web.config sections encryption... Web.config sections are not encrypted. Checking IIS configuration locked sections... Configuration sections are not locked. Checking Orchestrator ssl certificate subject alternative names... Orchestrator host name is valid for the ssl certificate subject alternative names. Checking sql server scaleout use... Sql server scaleout is not used. Checking external credential store plugins target framework... Credential stores plugins validation is finished. Checking external NLog plugins target framework... NLog plugins validation is finished. Checking buckets with file system storage provider... All storage buckets using file system provider have the root path on the allowed list in the configuration file. Checking platform certificates... Platform certificates validation is finished. All 22.4 pre-installation checks are done. Platform readiness validations: 10 succeeded, 0 failed and 0 warning(s).
El siguiente ejemplo te permite actualizar los certificados SSL de Orchestrator y los certificados de firma por token de Identity Server.
.\Platform.Configuration.Tool.ps1 `
-UpdateUiPathCertificate `
-SiteName "UiPath Orchestrator" `
-NewSSLThumbprint "a1b2c3d4" `
-NewTokenSigningThumbprint "z6y5x4v3"
.\Platform.Configuration.Tool.ps1 `
-UpdateUiPathCertificate `
-SiteName "UiPath Orchestrator" `
-NewSSLThumbprint "a1b2c3d4" `
-NewTokenSigningThumbprint "z6y5x4v3"
- Cualquier archivo
appsettings
debe descifrarse antes de utilizar el script. - Si tienes varios nodos de Orchestrator, asegúrate de actualizar el certificado en todos los nodos del servidor.
- Asegúrate de que los certificados tengan los permisos apropiados para evitar un error interno del servidor. Para obtener más detalles consulta Resolución de problemas con los certificados.
El siguiente ejemplo te permite actualizar la URL de Orchestrator.
.\Platform.Configuration.Tool.ps1 `
-UpdateUiPathUrl `
-OrchestratorUrl "https://mydomainname" `
-SiteName "UiPath Orchestrator" `
-SqlConnectionString "Server=myServerName\myInstanceName;Database=myDataBase;User Id=myUsername;Password=myPassword;"
.\Platform.Configuration.Tool.ps1 `
-UpdateUiPathUrl `
-OrchestratorUrl "https://mydomainname" `
-SiteName "UiPath Orchestrator" `
-SqlConnectionString "Server=myServerName\myInstanceName;Database=myDataBase;User Id=myUsername;Password=myPassword;"
hostlogin
.
.\Platform.Configuration.Tool.ps1 <code> `
-AddHostAdmin </code> `
-SiteName "UiPath Orchestrator" <code> `
-HostAdminUsername someuser </code> `
-HostAdminPassword som3pwd! `
-HostAdminEmail testemail@company.com
.\Platform.Configuration.Tool.ps1 <code> `
-AddHostAdmin </code> `
-SiteName "UiPath Orchestrator" <code> `
-HostAdminUsername someuser </code> `
-HostAdminPassword som3pwd! `
-HostAdminEmail testemail@company.com
Los valores de salida están codificados por colores.
Color |
Descripción |
---|---|
Rojo |
Bloqueadores Los elementos no están configurados y esto evitará la instalación. |
Amarillo |
Advertencias Puedes instalar Orchestrator, pero no se podrán proporcionar beneficios adicionales. |
Verde |
Mensajes El entorno está listo para la instalación. |
- Información general
- Requisitos previos
- Cmdlets del script
- Comprobaciones previas a la instalación
- Asp.Net Core
- CyberArk AIM
- Cifrado de web.config
- Secciones bloqueadas en web.config
- Scaleout de SQL Server
- Complementos del almacén de credenciales
- Complementos de NLog
- Depósitos del Sistema de archivos
- Comprobaciones posteriores a la instalación
- Requisitos de los certificados
- Otras consideraciones
- Ejecutar el script
- Referencia de los comandos
- Parámetros de los scripts
- Ejemplos
- Realizar una comprobación de la predisposición
- Cambiar los certificados después de la instalación
- Cambiar la URL de Orchestrator
- Crear un nuevo administrador del sistema
- Salida