Requisitos previos para la instalación

Completa todos los requisitos previos antes de instalar Orchestrator, incluida la versión del sistema operativo, PowerShell y los requisitos del certificado.

Servidor de Orchestrator

• Sistema operativo Windows Server : versión mínima necesaria: 2016. Consulta los requisitos de software para las otras versiones compatibles.

• Windows PowerShell : versión mínima necesaria: 5.1. Para descargar la versión 5.1 de Windows PowerShell, visita este enlace e instala Windows Management Framework 5.1. Para obtener ayuda adicional, consulta la documentación de instalación de Windows PowerShell 5.1.

• .NET Framework : versión mínima necesaria: 4.7.2 Para saber qué versión de .NET está instalada en tu ordenador, consulta Encontrar la versión de .NET instalada.

• IIS : versión mínima requerida: 10. Esto forma parte del rol del servidor web (IIS) y se habilita automáticamente mediante el script InstallRolesAndFeatures.ps1proporcionado, que se puede encontrar aquí.

• Módulo ASP.NET Core IIS : versión 6.0.x (disponible aquí) o 8.0.x (disponible aquí). Está disponible como parte del paquete de alojamiento. Para descargarlo, asegúrate de hacer clic en la opción Paquete de alojamiento .

  Nota:

  Solo se necesita el módulo Núcleo, y este puede instalarse sin tiempos de ejecución utilizando el parámetro OPT_NO_RUNTIME=1 de la línea de comandos.

• Reescritura de URL : versión mínima requerida 2.1. Permite que el sitio web redirija las llamadas a HTTPS (https://servername), en lugar de HTTP (http://servername). Descargue e instale URL Rewrite accediendo a este enlace.

• Roles y características del servidor. Proporcionamos un script de PowerShell que añade automáticamente los roles y características necesarios a los servidores de la aplicación. La lista de roles y características se presenta en Roles y características del servidor. Ten en cuenta que este capítulo solo tiene fines informativos.

• Extensión Web-Deploy : versión mínima necesaria: 3.6, versión de 64 bits. Ten en cuenta que esto solo es necesario para las instalaciones de scripts de PowerShell, como el de Azure. Te permite implementar un sitio web.

• Web.Config : el elemento <system.webServer> en web.config no debe contener ninguna sección bloqueada. Si tales secciones existen, debes desbloquearlas manualmente en IIS.

• El usuario del grupo de aplicaciones debe tener los siguientes derechos en la directiva de equipo local:

  • Inicia sesión como un trabajo por lotes.

• Debes habilitar la autenticación anónima.

  

  Importante:

  Asegúrate de que el usuario que ejecuta la instalación es un Usuario de dominio.

Certificados web (certificado SSL)

El protocolo HTTPS es obligatorio para todas las comunicaciones entre UiPath Robots y Orchestrator en todos los navegadores en los que los usuarios tienen acceso a la aplicación web.

Se pueden utilizar los tres siguientes tipos de certificados web.

• Un certificado web emitido por una entidad de certificación de confianza, como GoDaddy, VeriSign, etc. El certificado web debe importarse a Certificados de servidor en IIS. Debes conocer el nombre de la entidad "Emitido para", que debe proporcionarse cuando lo solicite el instalador de Windows.
• Eres una autoridad de certificación que puede emitir certificados de confianza en el dominio de Windows. Consulta Utilizar un certificado para el protocolo HTTPS.
• Un certificado autofirmado, que no se recomienda para Producción. El certificado no es de confianza dentro del dominio. Por tanto, debes exportar su clave pública y luego importarlo en todas las máquinas de UiPath Robot. Consulta Utilizar un certificado para el protocolo HTTPS para obtener más información.

El nombre del certificado que proporcionas cuando lo pide el instalador de Windows, o el que se menciona en la línea de comandos mediante -sslCertificate es el mismo que aparece en la columna Emitido para en Certificados de servidor en IIS.

Figura 1. Certificados de servidor

Importante:

Por motivos de seguridad, el certificado utilizado por Identity Server debe:

• tener una clave pública en al menos 2048 bits,
• sea capaz de firmar,
• tener una clave privada accesible por el usuario de AppPool,
• estar en su período de validez (no caducado). La ubicación del certificado se establece en el archivo de configuración de Identity Server appsettings.Production.json, en la sección Credencial de firma . Si se utiliza un certificado autofirmado, este también debe colocarse en el almacén de certificados de la entidad de certificación raíz de confianza (junto a la ubicación personal habitual). El certificado se utiliza para firmar tokens de acceso OpenID que se utilizan para la identificación del usuario a través del navegador y para la comunicación de servicio a servicio entre Orchestrator e Identity Server. Haz clic aquí para obtener más información sobre OpenID Connect.

Servidor SQL

• El producto de SQL Server se puede instalar en el mismo equipo que el servidor de aplicaciones (no recomendado para el entorno de producción) o facilitado en un equipo independiente. El equipo de SQL Server puede compartirse con otras aplicaciones. No es necesario que esté dedicado a Orchestrator. Haz clic aquí para ver los prerrequisitos, restricciones y recomendaciones sobre cómo implementar los grupos de disponibilidad AlwaysOn y aquí para obtener más información sobre las opciones de implementación físicas.
• Si quieres conectar Orchestrator a la base de datos utilizando un usuario de SQL Server, habilita el modo de autenticación de Windows y SQL Server. De lo contrario, el "modo de autenticación de Windows" será suficiente. Si SQL Server ya está instalado, selecciona esta opción como se muestra en las siguientes imágenes:
  Nota:

  El usuario de SQL Server debe tener acceso al nivel de servidor; el acceso a los niveles de la base de datos no es suficiente para una instalación correcta.

Figura 2. Opción de propiedades

Figura 3. Propiedades del servidor

• La secuencia de intercalación debe ser la predeterminada (Latin1_General_CI_AS).
• SQL Server Management Studio es necesario para configurar el inicio de sesión del usuario del dominio que accede a SQL Server. El grupo de aplicaciones se ejecuta en el servidor de la aplicación con el nombre del usuario del dominio.
• Si estás contemplando la posibilidad de instalar Insights, asegúrate de que tu base de datos admite tanto los índices de almacén de columnas como las funciones JSON.

Configuración de SQL Server

Antes de instalar Orchestrator, es necesario configurar la instancia de SQL Server que quieres utilizar.

Nota:

La base de datos SQL de Orchestrator no distingue mayúsculas de minúsculas ("OrchDB" = "orchdb"). Si se crea durante el proceso de instalación de Orchestrator, se establece automáticamente de esta forma. Si no, deberás configurarlo manualmente para que no distinga mayúsculas de minúsculas.

Requisitos:

• el nombre del equipo de SQL Server;
• el nombre de la instancia, si no es la instancia predeterminada;
• el valor del puerto TCP, si no es el puerto predeterminado (1433);
• el puerto de SQL Server está abierto en el firewall del equipo de SQL Server;
• el protocolo TCP en el administrador de configuración de SQL Server debe estar habilitado;
• el servicio de SQL Server debe escuchar en un puerto fijo y no en uno asignado de forma dinámica;
• se requiere acceso público a la base de datos maestra SQL para la cuenta de servicio que ejecuta Orchestrator. Esto es necesario tanto para la instalación como para futuras actualizaciones.
  Importante:

  Para aumentar el rendimiento, evitar bloqueos y evitar lecturas sucias en SQL, asegúrate de que la opción READ_COMMITTED_SNAPSHOT está establecida en ON. Para procesar la misma cola con varios robots y el aislamiento de instantáneas está activado, asegúrate de que la opción ALLOW_SNAPSHOT_ISOLATION está establecida en ON.

Utiliza esta consulta para comprobar si READ_COMMITTED_SNAPSHOT está habilitado o deshabilitado:

SELECT is_read_committed_snapshot_on FROM sys.databases
   WHERE name= 'UiPath'

Si está habilitado, el valor devuelto será 1.

Si está deshabilitado, el valor devuelto será 0. Utiliza esta consulta para habilitarlo:

ALTER DATABASE UiPath
SET READ_COMMITTED_SNAPSHOT ON

• Si usas diferentes bases de datos para Probar automatización y/o Actualizar servidor, READ_COMMITTED_SNAPSHOT debe estar habilitado también en ellas.

Selecciona una de las siguientes opciones mediante la que Orchestrator pueda conectarse a la base de datos de SQL Server.

Autenticación integrada de Windows

Para esta opción, se necesita un nuevo inicio de sesión para SQL Server como cuenta de servicio. La cuenta de servicio debe ser un usuario de dominio cuya contraseña nunca caduque.

Para crear un nuevo inicio de sesión en SQL Server Management Studio:

1. En el panel Explorador de objetos, ve a Seguridad > Inicios de sesión.
2. Selecciona con el botón derecho la carpeta Inicios de sesión y selecciona Nuevo inicio de sesión. Se mostrará la ventana Inicio de sesión: nuevo .
3. Selecciona la opción Autenticación de Windows. La ventana se actualizará en consecuencia.

Figura 4. Iniciar sesión: nueva ventana

4. En el campo Nombre de inicio de sesión , introduce el dominio de usuario que deseas utilizar como cuenta de servicio.
5. En la lista de Idioma predeterminado, selecciona Inglés.
   Importante:

   Asegúrate de que el idioma predeterminado esté establecido en inglés. Si no lo está, el sitio web no se podrá iniciar y el visor de eventos del equipo en el que Orchestrator está instalado mostrará el siguiente mensaje de error: "La conversión de un tipo de datos varchar a un tipo de datos datetime dio como resultado un valor de fuera de rango".

6. Selecciona Aceptar. Sus configuraciones se guardan. Si la cuenta de servicio ya se ha creado y añadido a la sección Seguridad > Inicios de sesión de SQL Server, comprueba si el idioma predeterminado de esa cuenta SQL está establecido en inglés. Si no es así, realiza los ajustes necesarios.

Nombre de usuario y contraseña de SQL Server

En este caso, se necesita un usuario de SQL Server. Te recomendamos encarecidamente que no utilices una cuenta de sa.

Para crear un nuevo usuario SQL en SQL Server Management Studio:

a. En el panel Explorador de objetos, ve a Seguridad > Inicios de sesión.

b. Haz clic derecho en la carpeta Inicios de sesión y selecciona Nuevo inicio de sesión. Se mostrará así la ventana Inicio de sesión: nuevo.

c. Selecciona la opción Autenticación de SQL Server. La ventana se actualizará en consecuencia.

Figura 5. Iniciar sesión: nueva ventana

d. Rellena los campos Nombre de inicio de sesión, Contraseña y Confirmar contraseña como corresponda.

e. Asegúrate de que las opciones Aplicar la expiración de contraseña y El usuario debe cambiar la contraseña en el próximo inicio de sesión no están seleccionadas.

Importante:

Asegúrate de que el idioma predeterminado esté establecido en inglés. Si no lo está, el sitio web no se podrá iniciar y el visor de eventos del equipo en el que Orchestrator está instalado mostrará el siguiente mensaje de error: "La conversión de un tipo de datos varchar a un tipo de datos datetime dio como resultado un valor de fuera de rango".

Si la cuenta de SQL Server ya se ha creado y añadido a la sección Seguridad > Inicios de sesión de SQL Server, comprueba que el campo Idioma predeterminado esté establecido en inglés. Si no lo está, realiza los ajustes necesarios.

Independientemente del tipo de usuario (dominio o SQL) que quieras conectar a SQL Server, ten en cuenta que debes asignarle elrol de servidordbcreator ANTES de instalar Orchestrator, ya que la base de datos se crea durante este proceso de instalación.

Si las restricciones de seguridad no permiten el uso del rol de servidor dbcreator en la cuenta de servicio, crea la base de datos vacía en SQL Server.

El instalador de Windows se conecta a SQL Server para verificar la existencia de la base de datos.

Después de crear la base de datos, deberás proporcionar el usuario que se conecta a la base de datos SQL con el rol de asignación de usuario db_owner, como se muestra en la siguiente captura de pantalla.

Figura 6. Propiedades de inicio de sesión

Si las restricciones de seguridad no te permiten utilizar el rol de asignación de usuario db_owner con el inicio de sesión de UiPath, confirma lo siguiente:

• db_datareader
• db_datawriter
• db_ddladmin1
• EXECUTE permiso en el esquema dbo

Figura 7. Propiedades de inicio de sesión

¹ El rol db_ddladmin solo es necesario durante la instalación o la migración. Por razones de seguridad, te recomendamos que lo elimines después de la instalación o la migración (usando ALTER ROLE db_ddladmin DROP MEMBER [SQLReadWrite]), y que lo vuelvas a añadir antes de la actualización (usando ALTER ROLE db_ddladmin ADD MEMBER [SQLReadWrite]).

[block:image] { "images": [ { "image": [] } ] } [/block]

Debe otorgarse el permiso EXECUTE utilizando el comando SQL GRANT EXECUTE, como se muestra a continuación.

• si se utiliza la autenticación integrada de Windows:

  USE UiPath
  GO
  GRANT EXECUTE ON SCHEMA::dbo TO [domain\user]
  GO
  

• si se utiliza la autenticación de SQL Server:

  USE UiPath
  GO
  GRANT EXECUTE ON SCHEMA::dbo TO [sql_user]
  GO
  

Autenticación de Azure AD

Para usar autenticación de Azure AD con SQL Server debes instalar Orchestrator en un servicio de aplicaciones de Azure o en una VM de Azure.

Orchestrator se ejecuta en Azure App Service

1. Crea una nueva identidad administrada por usuario en el grupo de recursos y copia la ID de cliente para su uso posterior.

Figura 8. ID de cliente

2. Añade Identidad a la lista de identidades asignadas al usuario para Orchestrator, Identity Server y Servicios de aplicaciones de Webhooks.

Figura 9. Añadir identidad

3. Habilita el administrador de Azure Active Directory para el servidor SQL donde está hospedada la base de datos de Orchestrator.

Figura 10. Establecer administrador

4. Crea el inicio de sesión de SQL para la identidad creada en el paso 1 para la base de datos de Orchestrator y la base de datos maestra. Inicia sesión en la base de datos con la cuenta de administrador establecida en el paso 3 y ejecuta el siguiente comando

   CREATE USER [SQLReadWrite] FROM EXTERNAL PROVIDER
   

5. Añade roles de usuario en la base de datos de Orchestrator (no es necesario realizar esta operación también en la base de datos maestra):
   • Si el rol db_owner no está restringido, añade el rol: ALTER ROLE db_owner ADD MEMBER [SQLReadWrite]
   • Si el rol db_owner no está disponible, añade los roles siguientes, donde SQLReadWrite es el nombre de identidad creado en el paso 3:

     ALTER ROLE db_datareader ADD MEMBER [SQLReadWrite]
     ALTER ROLE db_datawriter ADD MEMBER [SQLReadWrite]
     ALTER ROLE db_ddladmin ADD MEMBER [SQLReadWrite]
     GRANT EXECUTE ON SCHEMA::dbo TO [SQLReadWrite]
     

El rol db_ddladmin solo es necesario durante la instalación o la migración. Por razones de seguridad, te recomendamos que:

• Lo elimines después de la instalación o la migración

  ALTER ROLE db_ddladmin DROP MEMBER [SQLReadWrite]
  

• Lo vuelvas a añadir antes de la actualización

  ALTER ROLE db_ddladmin ADD MEMBER [SQLReadWrite]
  

Actualiza la cadena de conexión en Orchestrator, Identity Server y Servicio de aplicaciones Webhooks en Configuración - Variables de entorno - Cadenas de conexión. La cadena de conexión debe ser:

Server=tcp:http://aad-paas-sql.database.windows.net|aad-paas-sql.database.windows.net,1433;Initial Catalog=UiPath;Persist Security Info=False;User ID=7e8df0ba-bc41-46d1-bd46-6101e45200a8;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Authentication=Active Directory Managed Identity;

Nota:

• Establece USER ID como el valor de la ID de cliente creada en el paso 1.
• Asegúrate de utilizar Authentication=Active Directory Managed Identity.
• No hace falta ninguna contraseña ni token.

Orchestrator se ejecuta en Azure VM

1. Crea una nueva identidad administrada de usuario en el grupo de recursos y copia la ID de cliente para su uso posterior.

Figura 11. ID de cliente

2. Añade la identidad a las identidades asignadas por usuario para la VM que ejecuta Orchestrator.

Figura 12. Añadir identidad

3. Habilita el administrador de Azure Active Directory para el servidor SQL donde se hospeda la base de dato de Orchestrator.

Figura 13. Establecer administrador

4. Crea el inicio de sesión de SQL para la identidad creada en el paso 1 para la base de datos de Orchestrator y la base de datos maestra. Inicia sesión en la base de datos con la cuenta de administrador establecida en el paso 3 y ejecuta el siguiente comando:

   CREATE USER [SQLReadWrite] FROM EXTERNAL PROVIDER
   

5. Añade roles de usuario en la base de datos de Orchestrator (no es necesario realizar esta operación también en la base de datos maestra):
   • Si el rol db_owner no está restringido, añade el rol: ALTER ROLE db_owner ADD MEMBER [SQLReadWrite]
   • Si el rol db_owner no está disponible, añade los roles siguientes, donde 1SQLReadWrite1 es el nombre de identidad creado en el paso 3.

     ALTER ROLE db_datareader ADD MEMBER [SQLReadWrite]
     ALTER ROLE db_datawriter ADD MEMBER [SQLReadWrite]
     ALTER ROLE db_ddladmin ADD MEMBER [SQLReadWrite]
     GRANT EXECUTE ON SCHEMA::dbo TO [SQLReadWrite]
     

El rol db_ddladmin solo es necesario durante la instalación o la migración. Por razones de seguridad, te recomendamos que:

• Lo elimines después de la instalación o la migración

  ALTER ROLE db_ddladmin DROP MEMBER [SQLReadWrite]
  

• Lo vuelvas a añadir antes de la actualización

  ALTER ROLE db_ddladmin ADD MEMBER [SQLReadWrite]
  

Actualiza la cadena de conexión en Orchestrator:

<add name="Default" providerName="Microsoft.Data.SqlClient" connectionString="Data Source=aad-paas-sql.database.windows.net;Initial Catalog=UiPath;User ID=7e8df0ba-bc41-46d1-bd46-6101e45200a8;Authentication=Active Directory Managed Identity;" />

Nota:

• Asegúrate de establecer USER ID con el valor de la ID de cliente creada en el paso 1.
• Asegúrate de utilizar Authentication=Active Directory Managed Identity.
• No hace falta ninguna contraseña ni token.

High Availability Add-on

El High Availability Add-on (HAA) para Orchestrator es una base de datos en memoria que se utiliza para la caché y se comparte entre los nodos de Orchestrator, lo que proporciona una sincronización casi instantánea.

Importante:

HAA es obligatorio en un entorno de grupo. Las implementaciones de Orchestrator multinodo utilizan el protocolo RESP (protocolo de serialización de REdis) para las comunicaciones y, por ello, puede configurarse utilizando cualquier solución que se base en este protocolo. Sin embargo, HAA es la única solución de este tipo compatible con UiPath.

La siguiente información se almacena en HAA:

• estado de la sesión: establecido automáticamente al instalar Orchestrator en múltiples nodos
• sesiones de usuario desde el navegador
• caché de los latidos del UiPath Robot
• asociaciones entre usuarios y roles
• asociaciones entre usuarios y unidades de organización
• Información de licencia
• Configuración

Orchestrator utiliza HAA como caché compartido para todos sus nodos. El siguiente ejemplo describe cómo se utiliza la caché para coordinarse en todos los nodos de Orchestrator:

• Ejemplo: un usuario inicia manualmente un trabajo de UiPath Robot en un nodo de Orchestrator.Puede que este nodo en particular no sepa a qué nodo de Orchestrator está conectado el UiPath Robot.El nodo desde el que se inició el trabajo reenvía la solicitud a HAA que, a su vez, sincroniza la información. El nodo de Orchestrator con una conexión establecida al UiPath Robot en cuestión le enviará el comando de inicio.Los demás nodos de Orchestrator que no estén conectados a nuestro UiPath Robot simplemente ignorarán el comando.

También es posible habilitar las conexiones cifradas SSL entre los nodos de Orchestrator y el servicio HAA a través del parámetro LoadBalancer.Redis.ConnectionString en UiPath.Orchestrator.dll.config. Para obtener más información, consulta esta página.

Equilibrador de carga de red

Un equilibrador de carga de red te permite distribuir la carga en múltiples nodos y, por tanto, permite un mejor rendimiento global de tu instancia de Orchestrator. Además, si uno de los nodos falla, el resto recoge la carga y garantiza que no exista tiempo de inactividad.

Importante:

Es necesario un equilibrador de carga de red si quieres implementar Orchestrator en un grupo y aprovechar un modelo de alta disponibilidad.

Te recomendamos que utilices un equilibrio de carga F5 con un algoritmo predictivo, ya que la carga se distribuye en nodos que funcionan mejor y, por tanto, ofrece un mejor rendimiento general de Orchestrator. Para obtener más información sobre los algoritmos, echa un vistazo aquí.

Servidor Elasticsearch

Elasticsearch es opcional y se utiliza para almacenar los mensajes registrados por los Robots. Los registros pueden enviarse a ElasticSearch y/o a una base de datos SQL local, lo que te permite tener registros sin rechazo. Cuando se utilizan tanto ElasticSearch como SQL, no se afectan mutuamente si uno de ellos encuentra un problema.

Estos parámetros se pueden cambiar desde el archivo UiPath.Orchestrator.dll.config (C:\Program Files (x86)\UiPath\Orchestrator). Para obtener más información, consulta Configuración de registro.

Si decides utilizar ElasticSearch, ten en cuenta que, aunque se trata de un producto multiplataforma que se ejecuta en Windows, Linux o Unix, este requiere Java. Puedes utilizar OpenJDK u Oracle JRE. Elasticsearch facilita una matriz de compatibilidad aquí.

Nota:

Ten en cuenta que, a partir del 16 de abril de 2019, Oracle ha cambiado su modelo de licencias. La información relacionada con los cambios está disponible aquí.

Si los equipos están en un dominio, deberás asegurarte de que se añaden en la sección Equipos del servidor de dominio, en Usuarios y equipos de Active Directory. Este paso es necesario porque el nombre del equipo se utiliza durante el proceso de instalación. Por ejemplo, se utiliza http://computername.domain.name o http://computername en en lugar de http://localhost.

Si esto no es posible, tendrás que utilizar el nombre del equipo o la dirección IP durante el proceso de instalación.

Instalar Elasticsearch

1. Descarga Elasticsearch.
2. Selecciona dos veces el instalador de Windows de Elastic Search. Se muestra el asistente de Elastisearch, en el paso Ubicaciones .

Figura 14. Instalador de Elasticsearch

3. Utiliza los directorios predeterminados para la instalación, los datos, la configuración y los registros, o selecciona ubicaciones personalizadas para cada uno.
   Nota:

   Si tienes otro disco que no sea en el que está instalado Elasticsearch, puedes configurar Elasticsearch para almacenar los datos en el disco con más espacio libre.

4. Selecciona Siguiente. Se mostrará así el paso Servicio.

Figura 15. Instalador de Elasticsearch

5. Asegúrate de que las siguientes opciones están seleccionadas:
   • Instalar como un servicio
   • Iniciar el servicio una vez finalizada esta instalación
   • Iniciar el servicio cuando inicie Windows (automático)
6. Selecciona Siguiente. Se mostrará así el paso Configuración.
7. Configura las siguientes opciones como desees:
   • Nombre de grupo: cambia el valor a algo que refleje el propósito de esta instalación de Elasticsearch. Esto es importante si tienes varios servidores con Elasticsearch en tu intranet, para evitar la detección automática.
   • Nombre de nodo: un nombre intuitivo para tu nodo.
   • Roles: se recomiendan las opciones predeterminadas.
   • Memoria - se recomiendan las opciones por defecto.
   • Host de red: hostname/dirección IP del equipo (puedes obtener el nombre del equipo en el símbolo del sistema ejecutando el comando hostname).
   • Puerto HTTP: el puerto predeterminado para Elasticsearch es 9200
   • Detección: habilita la detección.Este es el primer maestro de la casilla de verificación de un nuevo grupo para el primer nodo del grupo.

Figura 16. Campo de descubrimiento

:::important Si Orchestrator está instalado en una máquina diferente, recuerda abrir el puerto 9200 en el Firewall de la máquina donde está instalado Elasticsearch. :::

8. Selecciona Siguiente. Se mostrará así el paso Complementos.
9. (Opcional) Selecciona complementos adicionales para Elasticsearch, como X-Pack para la seguridad.

Figura 17. Complemento X-Pack

10. Selecciona Instalar. Ya está instalado ElasticSearch.

Reducir el número de fragmentación del índice

De forma predeterminada, los índices de Elasticsearch recientemente creados tienen cinco fragmentos. No obstante, para lograr un mayor rendimiento, se recomienda reducir este número a dos. Para obtener más información, consulta la documentación oficial de Elasticsearch.

Para llevar a cabo este cambio, todo lo que tienes que hacer es una solicitud PUT en la URL de tu instancia de Elasticsearch en el formato elasticUrl/_template/uipath_logs, con el siguiente cuerpo:

{
    "template": "*",
    "order": 1,
    "settings": {
        "number_of_shards": 2
    }
}

Para probar tu conexión de ElasticSearch, utiliza cualquier navegador para abrir la siguiente URL: http://computername:9200/. Computername se refiere al nombre del equipo en el que está instalado Elasticsearch. El navegador debería pedirte que descargues un archivo .json o abrir y mostrar el archivo, como podrás ver en la siguiente imagen.

Figura 18. Probando la conexión de Elasticsearch

Kibana

Kibana se utiliza en combinación con Elasticsearch y te ayuda a crear vistas personalizadas en función de los registros que envías a Elasticsearch, en nuestro caso, las que envían los UiPath Robots.

Instalar Kibana

Nota:

Kibana no necesita Java para ejecutarse. Si Kibana está instalado en un equipo diferente al de Elasticsearch, no tendrás que instalar Java para que Kibana funcione.

1. Descarga Kibana.
2. Descomprime el paquete de Kibana.
   Nota:

   Descomprime en C:\ o D:\ . No tienes que crear una nueva carpeta con el nombre kibana-x.y.z-windows, ya que los archivos del documento ya están ubicados en una carpeta con ese nombre.

3. Edita el archivo de configuración de Kibana (C:\kibana-x.y.z-windows-x86\config\kibana.yml), como se muestra a continuación:
   Nota:

   En primer lugar, abre el archivo con Wordpad y guárdalo para convertir los caracteres de avance de línea (LF) en caracteres de retorno de carro con avance de línea (CRLF). Después, abre el archivo con Notepad.

   1. Quita el comentario de la línea que contiene server.port. El valor predeterminado es 5601. No es necesario cambiarlo a menos que quieras que Kibana se ejecute en un puerto diferente.
   2. Quita el comentario de la línea que contiene server.host. Cambia el valor al nombre del equipo.
   3. Elimina el comentario de la línea que contiene elasticsearch.url. Cambia el valor a la URL de Elasticsearch, utilizando el nombre del equipo en el que está instalado Elasticsearch. Por ejemplo, http://computername:9200. Nota: para Kibana 6.6.0 o posterior, esta línea se ha reemplazado por elasticsearch.hosts. La siguiente captura de pantalla muestra un ejemplo de un archivo de configuración de Kibana en el que los nombres de los equipos tanto de Kibana como de Elasticsearch son JLTSQL: Figura 20. Configuración de Kibana
      
   4. Guarda el archivo.
4. Descarga el archivo setup-kibana-service.zip.
5. Copia los archivos nssm.exe y setup_kibana.bat del archivo setup-kibana-service.zip en C:\kibana-x.y.z-windows-x86\bin.
6. Abre el archivo setup_kibana.bat para comprobar que Kibana está instalado de acuerdo con la ubicación establecida en la variable KIBANA_HOME del archivo BAT. Si extrajiste Kibana en una ubicación diferente, realiza los cambios necesarios.
7. Abre el símbolo del sistema como administrador y cambia la carpeta a C:\kibana-x.y.z-windows-x86\bin.
8. Ejecuta setup_kibana.bat para instalar Kibana.
9. Prueba si Kibana responde escribiendo http://computername:5601 en cualquier navegador web. computername representa el nombre del equipo en el que instalaste Kibana.
   Importante:

   Abre el puerto 5601 en el firewall del equipo en el que está instalado Kibana.

10. Añadir un mensaje de prueba en la base de datos de Elasticsearch utilizando Kibana:
    1. En Kibana, ve a la pestaña Herramientas de desarrollo.
    2. Enviar una solicitud POST en el formato que se muestra a continuación. Si no recibes ningún error, se creará el índice de Elasticsearch llamado default-yyyy.mm y se añadirá el mensaje.

Importante:

Cada vez que se añade un nuevo tenant, debería crearse un patrón de índice correspondiente en Kibana, empezando con el nombre del tenant. yyyy se refiere al año en que se añadió el mensaje. mm se refiere al mes en que se añadió el mensaje. Lee Crear un patrón de índice para conectar Elasticsearch para descubrir cómo crear un patrón de índice en Kibana.

Sincronización de la hora

Piensa que, independientemente del tipo de instalación que elijas, para que las características de programación funcionen correctamente, deberás asegurarte de que:

• en el modo agrupado, los relojes de todos los equipos deben sincronizarse con un margen de menos de un segundo;
• los relojes de la base de datos y del equipo de Orchestrator también deben sincronizarse;
• si la base de datos SQL entra en un estado defectuoso, se recomienda reiniciar el servidor web de Orchestrator desde IIS. Si te encuentras en un entorno de NLB, reinicia todos los servidores web.