Instalación

Importante:

Ten en cuenta que se trata de un cambio con respecto a nuestras especificaciones de HW/SW de Insights 2021.10. Insights 2021.10 requiere una sola máquina Windows, mientras que Insights 2024.10 requiere una máquina Windows y una máquina Linux con RHEL.

En 2021.10, la máquina Windows Insights se ejecutó en el Docker que aloja el contenedor Looker Linux. A partir de Windows 2022, el controlador usado para anidar contenedores Linux en Windows (llamado lcow) ya no es compatible con Microsoft para aplicaciones empresariales. En consecuencia, tuvimos que cambiar nuestra arquitectura de implementación para requerir dos máquinas: una máquina Windows para ejecutar los componentes de UiPath Insights y una máquina Linux para ejecutar el contenedor Looker. Con este cambio, los proveedores de SO pueden ofrecer asistencia para los componentes necesarios para ejecutar productos UiPath. Las versiones compatibles del SO Linux son las mismas que para Automation Suite.

Las instalaciones en versiones no compatibles de RHEL están bloqueadas y debes actualizar a una versión compatible. Consulta Sistema operativo para conocer las versiones compatibles.

Importante: Insights no debe instalarse en una carpeta /tmp , ya que esto puede crear problemas después de un reinicio. La instalación debe realizarse en un directorio persistente.

Nota:

Tanto la versión principal de Orchestrator como la de Insights deben coincidir. Por ejemplo, si has actualizado Orchestrator a 2024.10.X, debes ejecutar una versión 2024.10.X de Insights para establecer una comunicación adecuada entre los dos productos de UiPath.

Nota: No se admite una instalación multinodo, pero después de la instalación, Insights puede habilitarse en una instalación existente de Orchestrator multinodo.

Información general

Para instalar Insights Standalone v2024.10, debes seguir estos procedimientos en el orden que se muestra a continuación:

1. Preparar las máquinas Windows y Linux de Insights
2. Iniciar Looker en la máquina Linux de Insights
3. Instalar Insights

Preparar la máquina Windows de Insights y la máquina Linux de Insights

Paso 1

Prepara los certificados para habilitar SSL para ambas máquinas. Para obtener más información, haz clic aquí.

Nota: Asegúrate de importar los certificados de Looker e Insights a la máquina en la que deseas acceder a Insights.

El certificado para la máquina Linux de Insights debería instalarse en la máquina Windows de Insights porque el archivo LookerPreinstallationtool.exe exportará el certificado de la máquina Windows de Insights a la máquina Linux de Insights.

Tanto la máquina de Windows como la máquina de Linux darán servicio a la solicitud HTTPS. Por ello, ambos utilizarán un certificado para las conexiones HTTPS. Como requisito previo, asegúrate de tener un certificado que sea válido para el servidor de Linux y un certificado que sea válido para la máquina de Windows.

Paso 2

Configure dos máquinas que cumplan con los requisitos de hardware y software.

Importante:

• Asegúrate de seleccionar el rol db_owner, ya que es imprescindible al añadir el rol de propietario de la base de datos durante la configuración de la máquina SQL de Insights.
• Tanto la versión principal de Orchestrator como la de Insights deben coincidir. Por ejemplo, si has actualizado Orchestrator a 2023.4.X, debes ejecutar una versión 2023.4.X de Insights para establecer una comunicación adecuada entre los dos productos de UiPath.
• La base de datos de Insights debe apuntar a la misma base de datos que se creó al habilitar Insights durante la instalación de Orchestrator.
• Si tienes una gran base de datos, piensa en añadir manualmente los índices utilizando scripts SQL. La instalación de Orchestrator puede fallar durante la migración de la base de datos de Insights si tiene que indexar un conjunto de datos grande (consulta La migración de la base de datos falla durante la instalación).

Preparar una máquina Linux

Preparación de una máquina Linux de AWS EC2

Paso 1 Iniciar una instancia de Linux en AWS EC2

1. Inicia la instancia.
2. Seleccione la imagen de Red Hat Enterprise Linux 8
   Nota: Admitimos las versiones 8.2, 8.4 y 8.6. La compatibilidad con las versiones 8.8, 9.1 y 9.2 está disponible desde el parche de agosto y debería estar disponible para todas las versiones posteriores (23.4.2+, 22.10.5+, etc
3. Elige un tipo de instancia y configura los detalles de la instancia.
4. Añade almacenamiento a tu instancia y cambia el tamaño a 32.
5. Revisar e iniciar la instancia

   Para obtener más información, consulta Iniciar instancia en AWS.

Nota:

El script utiliza Sudo para realizar la inicialización y si el host Linux utiliza dzdo en lugar de Sudo, el script también utilizará dzdo.

Paso 2 Abrir puertos entrantes

Abre los puertos entrantes enumerados en la siguiente tabla siguiendo las instrucciones aquí:

Tipo	Rango de puertos	Origen	Descripción
TCP personalizado	9999	Cualquier lugar-IPv4	Este es el puerto de Looker.
TCP personalizado	19999	Cualquier lugar-IPv4	Este es el puerto de la API de Looker.
TCP personalizado	29999	Cualquier lugar-IPv4	Este es el puerto de actualización de LookML.

Preparación de un entorno Linux de Microsoft Azure

Paso 1 Crear una máquina que ejecuta Linux

1. Ve a Servicios > Máquinas virtuales > Crear.
2. Ve a Ver todas las imágenes y selecciona Red Hat Enterprise Linux 8.2-8.6, o 9.0 en el Plan. Para el paquete RHEL sin conexión, haz clic aquí.
   
   

   

   
   
3. En la Cuenta de administrador, elige entre Clave pública SSH o Contraseña. Si utilizas una clave pública SSH, puedes generarla y elegir Usar clave existente almacenada en Azure.

Paso 2 Abrir los puertos entrantes a la máquina creada

Para abrir los puertos entrantes enumerados en la siguiente tabla, sigue las instrucciones aquí.

IntervalosDePuertoDeDestino	Nombre	Prioridad	Origen
9999	Looker_Port	310	Cualquiera
19999	LookerAPI_Port	320	Cualquiera
29999	LookMLUpdate_Port	330	Cualquiera

Para configurar ajustes adicionales, consulta Crear una regla de seguridad entrante.

Paso 3 Aumento de la asignación de almacenamiento para máquinas Linux de Azure

La asignación de almacenamiento predeterminada en una máquina Linux de Azure es de 8 GB y puede provocar errores de espacio al extraer imágenes, crear copias de seguridad o al utilizar varios paneles.

Importante: Para entornos aislados, se realiza una comprobación de espacio libre suficiente, pero asegúrate de que los volúmenes /var tienen al menos 10 GB de espacio libre (consulta Requisitos de hardware de la máquina Linux de Insights). Antes de ejecutar el script de implementación, sigue los siguientes pasos para aumentar la asignación de almacenamiento y evitar errores de falta de espacio:

1. Open a SSH client in the Linux machine by running the command below:

   ssh azureuser@<your-hostname>

   Donde hay que ajustar <your-hostname> para que refleje el nombre del host de tu máquina.
2. Change to root user by running the command below:

   sudo -i

3. Comprueba el tamaño del disco ejecutando el siguiente comando:

   lsblk -f

   Encontrarás que el punto de montaje /var está bajo el nombre sda2 > rootvg-varlv.

   
4. Comprueba el tamaño de /dev/sda2 ejecutando el siguiente comando:

   lsblk /dev/sda2

   Donde /dev/sda2 se recupera desde el paso 3. Ahora verás el tamaño de /var, que es 8 GB.

   
5. Next, check the available space by running the command below:

   vgdisplay rootvg

   
   

   

   
   

   Verás que PE libre/Tamaño será de alrededor de 40 GB.

6. Aumenta el tamaño de rootvg-varlv ejecutando el siguiente comando:
   Puedes cambiarlo a +10G o a un valor diferente que sea inferior al 40GB disponible (el tamaño de la memoria libre que ves en el paso 5).

   lvresize -r -L +10G /dev/mapper/rootvg-varlv

   Nota: para instalaciones con espacios abiertos, ejecuta el mismo comando en /home.
   
   

   

   
   
7. Comprueba si ha tenido éxito el redimensionamiento ejecutando el siguiente comando:

   lsblk /dev/sda2

Ahora tendrás suficiente espacio para docker (ubicado en /var/lib/docker).

Nota: Para entornos aislados, ejecuta los comandos de los pasos 1–6 para aumentar el tamaño de /home y garantizar así el espacio suficiente para la imagen sin conexión y el paquete de paquetes.

Preparar una máquina con Windows para alojar el servicio Insights

1. Configura una máquina Windows que cumpla los requisitos de hardware y de software.
2. Abre el puerto de entrada predeterminado 443. Para obtener más información e instrucciones sobre cómo abrir un puerto de entrada en AWS, consulta Autorización de acceso a una Instancia. Para ver instrucciones sobre cómo abrir un puerto de entrada en Azure, consulta Portal de inicio rápido de NSG.
3. Ejecuta el script Install-Prerequisites.ps1 para habilitar IIS 10+, instala .NET 6.0.5+, y luego reinicia el servicio IIS. También puedes instalar de forma manual los requisitos previos destacados en los pasos siguientes:
   1. Abre una sesión RDP en la máquina creada para instalar los requisitos previos.
   2. Habilita IIS 10+.
      Para habilitar IIS 10+, ve a Panel de control > Programas > Activar o desactivar características de Windows. Esto abrirá el Asistente para añadir roles y características. Sigue el asistente para habilitar el servidor web (IIS).

      
      

      

      
      
      Esto abrirá el Asistente para añadir roles y características. Sigue el asistente para habilitar el servidor web (IIS).

      
      

      

      
      

      Habilita los siguientes módulos Web Server (IIS):

      • Servidor web
        • Características HTTP comunes
          • Documento predeterminado
          • Navegar en el directorio
          • Errores HTTP
          • Contenido estático
        • Estado y diagnóstico
          • Registro HTPP
        • Rendimiento
          • Contenido estático
        • Seguridad
          • Solicitar filtrado
      • Herramientas de administración
        • Consola de administración de IIS
   3. Descargue e instale .NET Hosting Bundle versión 6.0.7+.
   4. En PowerShell, ejecuta los siguientes comandos:

      net stop was /y ; net start w3svc

4. Habilita HTTPS en tu máquina utilizando un certificado SSL. Prepara tu certificado utilizando un procedimiento similar al que se proporciona para Orchestrator. Consulta Uso de un certificado para el protocolo HTTPS.
5. Al especificar un nombre de host para Insights, asegúrate de que el nombre de host deseado se pueda resolver dentro de tu DNS.
6. Asegúrate de usar TLS 1.1 o 1.2.

Configuración de SQL Server

Antes de instalar Insights, tienes que configurar la instancia SQL Server de Insights que quieras utilizar.

Nota: La base de datos SQL de Insights no debe distinguir entre mayúsculas y minúsculas ("InsightsDB" = "insightsdb"). Si se crea durante el proceso de instalación de Insights, se establece así de forma automática. Si creas tu propia base de datos de Insights, establece la secuencia de colación en Latin1_General_CI_AS para configurarla manualmente para que no distinga entre mayúsculas y minúsculas.

Asegúrate de tener la siguiente información disponible, ya que es necesaria para ejecutar el instalador de Insights:

• El nombre de la máquina de SQL Server.
• El nombre de la instancia, en caso de no ser la instancia predeterminada.

Además, asegúrate de lo siguiente:

• El puerto de SQL Server está abierto en el cortafuegos de la máquina de SQL Server. Puedes usar SKIP_FIREWALL_RULE_CREATION=true` para omitir la creación de la regla del cortafuegos.
• El protocolo TCP en SQL Server Configuration Manager tiene que estar habilitado.
• El servicio de SQL Server ha de estar en modo escucha en un puerto fijo, no en uno asignado de forma dinámica.

Configura uno de los siguientes métodos de autenticación a través de los cuales Insights podrá conectarse a la base de datos de SQL Server:

• Autenticación integrada de Windows
• Autenticación 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. Looker, la plataforma de análisis utilizada por Insights, se ejecuta en un contenedor de Linux.

Importante: Para habilitar la autenticación de Windows, SQL Server debe admitir la autenticación mediante el protocolo Kerberos.

Para ver más detalles sobre cómo habilitar la autenticación Kerberos en SQL Server, consulta Registro de SPN manual.

Ejecuta el siguiente comando para comprobar el SPN en tu máquina Windows:

setspn -Q MSSQLsvc/<server name>:port

Ejecuta el siguiente comando para establecer el SPN:

setspn -S MSSQLsvc/<FQDN server name>:port [domain\<SQL service account>

Nota: Opcionalmente, puedes utilizar una cuenta de servicio como SPN. Esta debe ser la cuenta en la que se ejecuta el servicio de SQL Server.

Consideraciones a la hora de configurar la autenticación integrada de Windows

• Antes de configurar la autenticación de Kerberos, asegúrate de que el servidor de Insights puede acceder a tu Active Directory (AD) y a SQL Server. Puedes comprobarlo con tu administrador de TI.
• SQL Server debe añadirse a tu dominio de AD.
• La máquina de Insights tiene que estar en la misma red que el dominio AD y SQL Server.
• El DNS debe configurarse para que la máquina de Insights pueda resolver los nombres de dominio tanto para el dominio AD como para SQL Server.
• El usuario de AD debería existir y tener acceso a permisos de SQL Server y de BD tal y como se define en la sección Permisos. El dominio, nombre de usuario y contraseña para este usuario tiene que proporcionarse durante el proceso de instalación de Insights. Ten en cuenta que el nombre de usuario distingue entre mayúsculas y minúsculas y que esto también hace las veces de sAMAccountName del usuario.
  Abre cmd como administrador y ejecuta set user para obtener USERDNSDOMAIN y USERNAME.
• SQL Server tiene que tener entradas SPN en AD. Para obtener más información, consulta Registrar un nombre principal de servicio para conexiones de Kerberos.
  Importante: es fundamental que la máquina de Insights deba resolver los nombres de dominio tanto del dominio AD como de SQL Server. Puedes verificarlo ejecutando nslookup <your_AD_domain_name> y nslookup <your_SQL_server_domain_name> en la máquina host.

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. Haz clic con el botón derecho del ratón en la carpeta de Inicios de sesión y selecciona Nuevo inicio de sesión.
3. Selecciona la opción Autenticación de Windows. La ventana se actualizará en consecuencia.
   
   

   

   
   
4. En el campo Nombre de inicio de sesión, escribe el dominio de usuario que quieres utilizar como una cuenta de servicio.
5. En la lista de Idioma predeterminado, selecciona Inglés.
   Importante: asegúrate de que el idioma predeterminado es el inglés. Si no es así, el sitio web no podrá iniciarse, y el visor de eventos en la máquina en la que está instalado Insights mostrará el siguiente mensaje de error: The conversion of a varchar data type to a datetime data type resulted in an out-of range value.
6. Haz clic en Aceptar para guardar la configuración.

   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 que el idioma predeterminado de esa cuenta SQL esté establecido como inglés. Si no lo estuviera, tendrás que realizar los ajustes necesarios.

Autenticación de SQL Server

Para este método de autenticación, necesitas un usuario de SQL Server.

Importante: Por razones de seguridad, deberías utilizar una cuenta que no sea SA (administrador de sistema).

Crear un usuario SQL en SQL Server Management Studio

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

   

   
   
4. Rellena los campos Nombre de inicio de sesión, Contraseña y Confirmar contraseña adecuadamente.
5. Asegúrate de que las opciones Aplicar la caducidad de la 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 es el inglés. Si no es así, el sitio web no podrá iniciarse, y el visor de eventos en la máquina en la que está instalado Insights 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.

Permisos

Independientemente del tipo de usuario (dominio o SQL) que desee conectar a SQL Server, tenga en cuenta que debe asignarle el rol del servidordbcreator ANTES de instalar Insights, 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 de Orchestrator con el rol de asignación de usuario db_owner, como se muestra en la siguiente captura de pantalla:

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 Insights
  GO
  GRANT EXECUTE ON SCHEMA::dbo TO [domain\user]
  GO

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

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

  Nota: Para configurar el valor predeterminado de MAXDOP de tu base de datos, consulta Establecer la opción de configuración de grado máximo de paralelismo del servidor.

Instalar Orchestrator y habilitar la característica Insights

Esta sección es obligatoria para preparar la base de datos de Insights. Antes de poder seguir instalando Insights debes habilitar la característica Insights en Orchestrator, dependiendo de tu escenario.

Para versiones posteriores a 2021.10, Instalación nueva de Orchestrator e Insights o Añadir Insights a una instalación de Orchestrator existente: consulta el Paso 3 de la Instalación de nodo único de Orchestrator).

Nota: No se admite una instalación multinodo, pero después de la instalación, Insights puede habilitarse en una instalación existente de Orchestrator multinodo.

Orchestrator instalado como un servicio de aplicaciones en Azure: si ejecutas Orchestrator como un servicio de aplicaciones en Azure, puedes ejecutar un script para publicar Orchestrator y habilitar Insights mediante el parámetro -insightsFeatureEnabled.

Nota:

• Ambas versiones de Orchestrator e Insights deben coincidir. Por ejemplo, si ejecutas la versión 2023.4.0 de Orchestrator, debes ejecutar la misma versión de Insights para establecer una comunicación adecuada entre ambos productos de UiPath.
• La base de datos de Insights debe apuntar a la misma base de datos que se creó al habilitar Insights durante la instalación de Orchestrator.
• Si tiene una base de datos grande, considere agregar índices manualmente mediante scripts SQL . Puede que la instalación de Orchestrator falle durante la migración de la base de datos de Insights si tiene que indexar un conjunto de datos grande.

Iniciar Looker en la máquina Linux de Insights

Sigue el procedimiento para inicializar Looker en la máquina Linux de Insights.

Alternativamente, puedes usar el script de implementación:

1. Ejecuta la herramienta LookerPreinstallationTool.exe para generar un archivo ZIP para Looker. Esto generará archivos de Looker en la máquina Windows de Insights.
2. Copia los archivos de Looker a la máquina Linux de Insights para implementar Looker o usa el script Deploy-Looker.ps1 para copiar los archivos extraídos a la máquina Linux de Insights y luego inicializa Looker.
   Importante:

   El script Deploy-Looker.ps1 es compatible con la versión 2023.4.0 de LookerPreinstallationTool.exe.

   Para obtener información detallada, consulta Script de implementación automatizada.

Generar archivos de Looker en la máquina Windows de Insights

Aviso: Los ajustes SMTP se configuran automáticamente a partir de la versión 2023.4 2019.x

1. Descarga LookerPreinstallationTool.exe y ejecuta la herramienta en la máquina Windows de Insights.
   Nota:

   La versión de la herramienta debe coincidir exactamente con la misma versión de Ochestrator e Insights. Para descargar la versión necesaria de LookerPreinstallationTool, consulta la página Portal del cliente > Descarga del producto o pregunta al equipo de soporte.

2. Sigue los pasos iniciales para generar el archivo ZIP.
3. Selecciona el idioma.
   Importante: Si la consola no puede mostrar el chino/coreano/japonés de forma correcta, cambia la fuente de tu consola. Para Powershell, puedes hacer clic con el botón derecho sobre la barra de título, seleccionar Propiedades y seleccionar una fuente TrueType (p. ej., MS Gothic, MS Mincho o NSimSun).
4. Valida y exporta el certificado generado. Asegúrate de que el nombre de host está completamente cualificado y está cubierto por el certificado.
   Nota: El certificado debe colocarse en las carpetas personales y de Autoridades de certificación raíz de confianza .
   
   

   

   
   
5. (Opcional) Configura la autenticación de Windows, si la utilizas.
   Aviso: Si se actualiza desde 2021.10, debido al cambio de arquitectura a 2 máquinas virtuales en 2023.4, el instalador no transfiere automáticamente paneles, alertas y horarios de 2021.10 a 2023.4. Para evitar perder los paneles. alertas y programaciones, sigue el paso 6 para migrar este contenido a la nueva máquina Linux. Esto no es aplicable a actualizaciones desde 2022.4. Ten en cuenta que si este paso no se completa durante la actualización, todos los paneles, programaciones y alertas se borrarán y no estarán disponibles para exportarlas a la nueva máquina de Looker cuando la instalación mediante InsightsInstaller.msi se haya completado con éxito.
6. (Opcional) Exporta datos para continuar usando tus paneles, alertas y programaciones anteriores en la nueva versión. La herramienta puede detectar si se ejecuta looker_container en la máquina. Si mueves tus datos, se exportará y utilizará la contraseña actual de Looker almacenada en $Env:ProgramData\UiPath Insights en la nueva máquina Linux de Insights.
7. (Opcional) Cifra el archivo ZIP para proteger el Looker Secret. Si has completado el paso 4, considera usar una contraseña para proteger el archivo ZIP.
   
   

   

   
   
8. Escribe la ruta en la que deseas crear el archivo ZIP. De lo contrario, se creará en la ruta predeterminada que se mostrará en la consola.

Copiar los archivos de Looker en la máquina Linux de Insights

Copia el archivo ZIP en la máquina Linux de Insights.

1. Autentícate en tu máquina Linux de Insights.
2. Abre una sesión SCP y escribe un comando que incluya la ruta del archivo ZIP y el nombre de usuario y la contraseña utilizados como credenciales de la máquina Linux de Insights, ejecutando el siguiente comando:

   scp <path-to-Insights_Lookerfile>.zip <user@linuxhostname>:~/

   Nota: Piensa en utilizar Powershell 7 o superior; o Putty, ya que las versiones anteriores (Powershell 5.1) pueden experimentar problemas en la representación o una pantalla en blanco.

Iniciar Looker

1. Abre Powershell y ejecuta el siguiente comando para autenticar:

   ssh <username@hostname>

   Note: Una vez que inicies sesión en la máquina Linux de Insights, asegúrate de que la hora local del sistema es correcta. De lo contrario, Looker podría entrar en un bucle de actualización infinito.
2. Genera la clave GPG utilizando el siguiente comando:

   gpg --generate-key

   Nota: la clave GPG ya no es necesaria en todas las versiones de instalación a partir de la versión de abril de 2023 (23.10.3, 23.4.6, etc.)

   Cuando se te indique, introduce el nombre de usuario, correo electrónico y establece una contraseña. Se generará una clave pública. Asegúrate de guardar la clave pública, ya que la vas a usar posteriormente.

   La clave pública se utiliza para almacenar la contraseña de Looker y el certificado generados durante el inicio de Looker. Puedes traspasar esta clave pública utilizando el parámetro -k al ejecutar looker-initialization.sh.

   
   

   

   
   
3. Descomprime los archivos de Looker ejecutando el siguiente comando:

   unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directory

   El directorio de instalación de Insights es el directorio desde el que se ejecuta el script. Así que evita descomprimir el archivo en tu directorio de inicio. El directorio estándar de Linux sería /opt, pero puede instalarse en la ubicación que elijas.

4. Ejecuta el script de inicialización de Looker ejecutando el siguiente comando:

   cd <installation directory>
   bash insights/looker-initialization.sh -k <Public Key>

   Nota: -k <public key> ya no es necesario en todas las versiones de instalación a partir de la versión de abril de 2023 (23.10.3, 23.4.6, etc.)
   Donde se genera <Public Key> a través del comando gpg --generate-key.
   Note: Es posible que se te pida que escribas la contraseña para guardar la contraseña de Looker.
   Nota: El script utiliza Sudo para realizar la inicialización y si el host Linux utiliza dzdo en lugar de Sudo, el script también utilizará dzdo.
   Note: Es posible que recibas el error Module yaml error: Unexpected key in data: static_context [line 9 col 3] durante la instalación. Para obtener más información sobre este error, consulta Desactivar la validación estricta de documentos ModuleMD (RHBug: 2004853).

   Esto no afecta a la instalación de Insights.

5. Sal de Powershell y descarga looker.json ejecutando el siguiente comando:

   scp <username@hostname>:~/insights/looker.json <path-to-save-json>

   Sustituye <username@hostname> con tu nombre de usuario y nombre de host de Linux.
   Puedes utilizar cat /home/user/insights/looker.json para copiar el contenido y crear un archivo en la máquina Windows de Insights llamado looker.json en el directorio de implementación y luego pegar el contenido copiado.

Importante: Después de la inicialización se creará un archivo llamado 'looker.key' en la carpeta $HOME/_insights. No borres este archivo, ya que será necesario para futuras actualizaciones.

Nota:

Puedes crear un usuario Looker y cambiar la propiedad de la carpeta de implementación al nuevo usuario Looker y establecer el permiso de la carpeta de implementación en 755. Todos los archivos de la carpeta tendrán el atributo 644.

Nota:

Looker tiene la capacidad de eliminar una consulta SQL después de que se cierre un panel, si la consulta no se ha completado. Esto puede mitigar los problemas de rendimiento en algunos escenarios. Si deseas que esta característica esté habilitada, añade el siguiente permiso sql. Esto es opcional.

use master
go
GRANT ALTER ANY CONNECTION TO sqladmin

Instalación de Insights

Nota:

• Al actualizar desde una versión anterior a la 2021.10, los usuarios con permisos de Insights no se migran automáticamente a tu nueva instalación. Se pueden migrar opcionalmente a través de la herramienta de migración de usuarios. Si ya utilizaste la herramienta al actualizar a 2021.10, no tienes que volver a ejecutar la herramienta de migración de usuarios.
• El instalador utilizará el idioma de visualización de Windows si se trata de uno de los siguientes idiomas: en-US, fr-FR, de-DE, es-ES, es-MX, ja-JP, ko-KR, pt-BR, pt-PT, ru-RU, tr-TR, zh-CN. Si el idioma de visualización de Windows no es uno de estos idiomas, el instalador utilizará el inglés.

1. Descarga el InsightsInstaller.msi desde el Customer Portal, seleccionando tu versión.
2. Ejecuta el instalador como administrador utilizando el símbolo del sistema o la consola de PowerShell.
3. Ve al directorio donde está ubicado tu instalador .msi.
4. Ejecuta el instalador de Insights utilizando el siguiente comando:

   msiexec /i InsightsInstaller.msi

   De forma alternativa, puedes utilizar el siguiente comando:

   .\InsightsInstaller.msi

5. El instalador de Insights debería comprobar ahora los requisitos previos. Si se cumplen todos los requisitos previos, aparecerá el asistente de configuración de UiPath Insights para guiarte en la instalación y configuración de Insights.
   
   

   

   
   
   Nota: si la instalación falló o quieres comprobar el registro de instalación, puedes ir a la carpeta %temp% o %temp%/<sessionID> y comprobar la MSI{random chars}.LOG más reciente. Los archivos de este directorio no son permanentes y puede que se pierdan entre sesiones. Puedes introducir el siguiente comando para ejecutar la instalación con la ubicación de registro predefinida.

   msiexec -I "InsightsInstaller.msi" -L*V  c:\logs\interactive.log

6. Acepta el Acuerdo de licencia y haz clic en Siguiente.
   
   

   

   
   
7. El script de inicialización de Looker en tu host de Linux muestra un archivo JSON con la configuración de la instancia. Introduce la lista de archivo completa de la ubicación en la que almacenaste ese archivo en este host de Windows.
   
   

   

   
   
8. Introduce la configuración de la máquina Windows de Insights de la siguiente manera:
   • URL de Insights Server: el nombre de host o la URL de la máquina Windows de Insights.
   • Puerto: el puerto que quieres utilizar para habilitar la comunicación con la máquina Windows de Insights. El número de puerto predeterminado está establecido en 443.
   • Certificado: el Asunto o Huella digital del certificado SSL que quieras utilizar para las conexiones seguras con Insights.
     
     

     

     
     
9. Configura los ajustes de Orchestrator de la siguiente manera:
   • URL de Orchestrator: la URL de Orchestrator
   • Token de instalación: escribe el token de acceso a la instalación que se generó en la página Token de acceso a la instalación de Identity Server al iniciar sesión como tenant del host. Para obtener más información, consulta Portales de administración de host.
   • Identity Server independiente: si tienes un Identity Server independiente, habilita esta opción.
     Nota: Necesitarás un nuevo token de acceso a la instalación en cada instalación. El token expirará después de las dos horas. Genera otro si experimentas un error de instalación.
     
     

     

     
     
10. Configura la configuración de la base de datos de Insights de la siguiente manera:
    • Nombre del servidor: el nombre de la máquina del servidor SQL donde se encuentra la base de datos de Insights, incluyendo el puerto de escucha predeterminado del servidor SQL (1433). Por ejemplo: SQLServer,1433.
    • Nombre de la base de datos: el nombre de la base de datos de Insights.
    • Tipo de autenticación: elige uno de los siguientes métodos de autenticación:
      Debes utilizar el nombre de dominio completo para la base de datos (p. Ej., mysever.my.domain en lugar de myserver). SQL Server debe, preferiblemente, unirse al dominio de AD directamente.
      • Autenticación de Windows: cuando se selecciona, Insights se conectará a la base de datos, creará tablas y ejecutará el grupo de aplicaciones de IIS utilizando las credenciales especificadas. El instalador valida la conexión utilizando las credenciales de Windows con las que hayas iniciado la sesión. Si seleccionas esta opción, deberás especificar el dominio, el nombre de usuario y la contraseña.
      • Autenticación SQL: si se selecciona, la conexión se llevará a cabo utilizando la autenticación SQL. Si utilizas esta opción, los campos Nombre de usuario y Contraseña se podrán editar y deberás proporcionar el nombre de usuario y la contraseña SQL utilizados para conectarse a la base de datos.
        
        

        

        
        
        Importante: Ninguna autenticación para SMTP es compatible en Insights 2022.4, 2022.10 y 2023.4.
11. Configura los ajustes de correo electrónico de la siguiente manera:
    • Configurar el servicio de correo electrónico (SMTP): comprueba para configurar el servicio de correo electrónico
      • Servidor: el nombre de host SMTP.
      • De: la dirección de correo electrónico desde la que se envían los mensajes de correo electrónico.
      • Nombre de usuario: el nombre de usuario del servidor SMTP, si requiere autenticación. Por ejemplo, si utilizas Gmail, rellena este campo con la dirección de correo electrónico que se utilice para enviar mensajes.

        Considera la posibilidad de usar SMTP con autenticación, ya que es posible que no se admita en el futuro SMTP sin autenticación.

      • Contraseña: la contraseña de la cuenta de correo electrónico
      • Puerto: el puerto SMTP.
      • TLS/SSL: comprueba para habilitar TLS/SSL.

        Versión TLS/SSL: solo se marca el TLS/SSL visible. Elija entre TLSv1_1 y TLSv1_2

        Nota: Una vez completado este paso, se enviará un correo electrónico utilizando los detalles del servidor SMTP. Esto es para garantizar que los detalles del SMTP sean correctos. Si se produce un error durante este paso, comprueba el archivo de registro y ve a la página de resolución de problemas
12. Haz clic en Siguiente para iniciar la instalación. Una vez completado el proceso de instalación, haz clic en Cerrar para salir del instalador.
    
    

    

    
    

Pasos tras la instalación

Migración de tablas

Nota: este paso solo es necesario si tienes tablas grandes y le surgen tiempos de espera durante la actualización.

Para migrar tablas de trabajos, sigue los pasos que se indican a continuación.

1. Rellenar JobOrganizationUnitId.

   with CTE as (
   select qie.[JobOrgUnitFullyQualifiedName] as qOrgName, qie.[JobOrganizationUnitId] as qOrgId, j.[OrganizationUnitId] as jOrgId, j.[OrgUnitFullyQualifiedName] as jOrgName
   from [dbo].[QueueItemEvents] qie 
   inner join [dbo].[QueueItems] qi on qie.[QueueItemId] = qi.[Id]
   inner join [dbo].[Jobs] j on qi.[ExecutorJobId] = j.[Id]
   where j.[OrganizationUnitId] != qie.[JobOrganizationUnitId] or (qie.[JobOrganizationUnitId] is null and j.[OrganizationUnitId] is not null))
   update CTE
   set qOrgName = jOrgName, qOrgId = jOrgId;

2. Crea un Índice de flujo de trabajo de larga duración si no existe.
   Nota: si este script se ha usado antes, no hace falta ejecutarlo una segunda vez.

   IF NOT EXISTS(SELECT * FROM sys.indexes WHERE Name = 'IX_JobEvents_JobId_TenantId' and OBJECT_NAME(object_id) = 'JobEvents')
   CREATE NONCLUSTERED INDEX [IX_JobEvents_JobId_TenantId] ON [dbo].[JobEvents]
   (
       [JobId] ASC,
       [TenantId] ASC
   )

3. Truncar tablas de lectura para volver a llenar campos nuevos.

   truncate table [read].[QueueItemEvents];
   truncate table [read].[QueueItems];
   truncate table [read].[Jobs];
   truncate table [read].[JobEvents];
   delete [dbo].[IngestionMarkers] where [IngestionEventType] in (9002, 9001);

Garantizar la licencia adecuada

Debes tener al menos un código de licencia, que incluirá Orchestrator, Insights y un Robot, todos ellos en el nivel de Host, adjuntado en Orchestrator (consulta Gestionar licencia de Host).

Activar tenants

Después de instalar Insights, debes habilitar Insights para los tenants deseados desde el portal del host de Orchestrator. Para obtener más información, consulta Habilitar o deshabilitar funciones.

Verificar los servicios de Insights

1. Abrir un navegador web compatible
2. Ve a https://hostname:443/Insights para confirmar que Insights se instaló correctamente.

Modificar Insights

Conserva el archivo de instalación original en caso de que quieras modificarlo o desinstalarlo.

Para obtener más información, consulta Modificar las configuraciones de Insights.

Habilitar Insights de nodo único en Orchestrator multinodo existente

Para habilitar UiPath Insights de nodo único en UiPath Orchestrator multinodo existente, sigue los siguientes pasos:

1. Habilita UiPath Orchestrator en un nodo principal y genera un archivo de parámetros. Consulta Añadir nodos a Orchestrator multinodo para obtener más información.
2. Ejecuta el instalador de Orchestrator (UiPathOrchestrator.msi) en los nodos secundarios con el siguiente comando:

   UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json
         /Q

3. Garantiza la coherencia en todos los nodos reemplazando UiPath.Orchestrator.dll. archivo de configuración en los nodos secundarios con la versión del nodo principal. Este archivo se encuentra en C:\Program Files (x86)\UiPath\Orchestrator. Se recomienda crear una copia de seguridad antes del reemplazo.
4. Compruebe que el archivo UiPath.Orchestrator.dll. El archivo de configuración es idéntico en todos los nodos después del reemplazo.

Artículos relacionados

• Instalación en un entorno aislado
• Actualizar Insights
• Solución de problemas