Instalación

Importante:

Please note that this is a change from our HW/SW specs from Insights 2021.10. Insights 2021.10 requires a single Windows machine, while Insights 2022.10 requires a Windows machine and a Linux machine with 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.

Installs on non-supported versions of RHEL are blocked and you need to update to a supported version. Check Operating System to find out the supported versions.

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.

Información general

Nota:

Check Insights Hardware and Software Requirements.

Se necesita un certificado SSL para HTTPS.

Asegúrate de que ip_forward está habilitado.

Para instalar Insights Standalone v2022.10, deberás seguir estos procedimientos en el orden capturado 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

Prepare the Certificate(s) to enable SSL for both machines. For more information, check the Hardware and software requirements page.

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 two machines that meet the hardware and software requirements.

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 2022.10.X, debes ejecutar una versión 2022.10.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.
• If you have a large database, consider manually adding indexes using SQL scripts . The Orchestrator installation might fail during the Insights Database migration if it has to index a large set of data (see Database migration fails during installation).

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. Selecciona la imagen de Red Hat Enterprise Linux 8

   Nota:

   Admitimos las versiones 8.2, 8.4 y 8.6. El soporte para 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

   For more information, check Initiate instance launch in 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 de entrada enumerados en la siguiente tabla siguiendo las instrucciones de la documentación de Amazon Elastic Compute Cloud :

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, selecciona este enlace de descarga.

   

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 de entrada enumerados en la siguiente tabla, sigue las instrucciones de la documentación de Azure .

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

Para configurar ajustes adicionales, marca 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:

For air-gapped environments, a check for enough free space is performed but make sure that /var volumes have at least 10GB free space (check Insights Linux Machine Hardware Requirements). Before running the deployment script, use the following steps to increase storage allocation and avoid out-of space errors:

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
   

   You’ll find the /var Mountpoint is under the name sda2 > rootvg-varlv.

   

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

   lsblk /dev/sda2
   

   Donde /dev/sda2 se recupera del paso 3. Ahora observarás el tamaño de /var , que es 8G.

   

5. A continuación, comprueba el espacio disponible ejecutando el siguiente comando:

   vgdisplay rootvg
   

   

   You’ll obseve the Free PE / Size will be around 40 GiB.

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 aisladas, ejecuta el mismo comando en /home.

   

7. Comprueba si el cambio de tamaño se ha realizado correctamente 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 a 6 para aumentar el tamaño de /home y garantizar espacio suficiente para la imagen sin conexión y el paquete.

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

1. Configure a Windows machine that meets the hardware and software requirements.
2. Abre el puerto de entrada predeterminado 443. Para obtener instrucciones sobre cómo abrir un puerto entrante en AWS, consulta Autorizar el acceso a una instancia. Para obtener instrucciones sobre cómo abrir un puerto entrante en Azure, consulta el 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).

      

      This will open the Add Roles and Features Wizard. Follow the wizard to enable Web Server (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. Download and install .NET Hosting Bundle version 6.0.7+.

   4. En PowerShell, ejecuta los siguientes comandos:

      net stop was /y ; net start w3svc
      

4. Enable HTTPS on your machine using an SSL certificate. Prepare your certificate using a procedure similar to the one provided for Orchestrator. Check Using a Certificate for the HTTPS Protocol for more information.
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.

For more details on how to enable Kerberos authentication on SQL Server, see Manual SPN Registration.

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.

• AD user should exist with access to SQL Server and DB permissions as defined in the Permissions section. Domain, username, and password for this user must be provided during the Insights install process. Keep in mind that the username is case sensitive and that this also serves as the sAMAccountName of the user.

  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 imperativo que la máquina de Insights pueda resolver los nombres de dominio tanto de 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 esté establecido en 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 esté establecido en 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 quieras conectar a SQL Server, ten en cuenta que debes asignarle elrol de servidordbcreator ANTES de instalar Insights, ya que la base de datos se crea durante este proceso de instalación.

If security restrictions do not allow the use of thedbcreator Server Role in the service account, create the empty database in 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:

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_ddladmin

• EXECUTE permiso en el esquema dbo

  

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).

Orchestrator instalado como servicio de aplicaciones en Azure: si ejecutas Orchestrator como servicio de aplicaciones en Azure, puedes ejecutar un script para publicar en Orchestrator y habilitar Insights a través del parámetro -insightsFeatureEnabled .

Nota:

• Ambas versiones de Orchestrator e Insights deben coincidir. Por ejemplo, si ejecutas la versión 2022.10.0 de Orchestrator, deberás ejecutar la misma versión de Insights para establecer la 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.
• If you have a large database, consider manually adding indexes using SQL scripts . The Orchestrator installation might fail during the Insights Database migration if it has to index a large set of data.

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 2022.10.0 LookerPreinstallationTool.exe .

   For detailed information, see the Automated Deployment Script.

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

Nota:

The SMTP settings are configured automatically starting with the 2022.10 version

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:

   The certificate needs to be placed in both Personal and Trusted Root Certification Authorities folders.

   

5. (Opcional) Configura la autenticación de Windows, si la utilizas.

   Nota:

   Si te actualizas desde 21.10, debido al cambio de arquitectura a 2 VM en 22.10, el instalador no transfiere los paneles, las alertas y las programaciones de forma automática desde 21.10 a 22.10. 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 22.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>
   

   Nota:

   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 la instalación a partir de la versión de abril de 2023 (23.10.3, 23.4.6, etc.)

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
   

   Nota:

   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.

   Nota:

   You might get the following error Module yaml error: Unexpected key in data: static_context [line 9 col 3] during the installation. For more information about this bug, see Turn off strict validation of modulemd documents (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 elimine este archivo, lo necesitará 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 InsightsInstaller.msi del 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 ha fallado 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 selecciona 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.

   • Port - the port you want to use to enable the communication with the Insights Windows machine. The default port number is set to 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 : introduce el token de acceso a la instalación que generaste 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.

    • Database Name - the name of the Insights database.

    • 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:

        Insights 2022.4 no admite autenticación para SMTP, 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:

        Once this step is completed, an email is sent using the SMTP server details. This is to ensure the SMTP details are correct. If there's an error during this step, please check the log file and navigate to the troubleshooting page

12. Select Next to start the installation. Once the installation process is completed, select Close to exit the installer.

    

Pasos tras la instalación

Migración de tablas

Nota:

Este paso solo es necesario si tienes tablas grandes y se producen 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 utilizó anteriormente, no es necesario 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 las licencias adecuadas

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

Activar tenants

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

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.

For more information, check Modifying Insights configurations.

Artículos relacionados

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