5. Ejecutar el instalador de la aplicación AI Fabric

Ejecuta el instalador de la aplicación. Esto instalará AI Fabric y los modelos Out of the Box en caso de instalaciones con espacio de aire.

Acceder a la consola de administración

Ve a la consola de administración; esta siempre será <machine-ip>:8800. Aquí es donde se llevará a cabo la configuración para el instalador de la aplicación. Al ir a esa dirección, se mostrará la siguiente página.

Haz clic en Continuar a la configuración. Se mostrará así la siguiente ventana.

Configurar DNS (opcional)

Si la máquina Linux tiene DNS configurado y quieres usar tu propio certificado al acceder a la aplicación de AI Fabric en función de un nombre de dominio totalmente cualificado, esta pantalla de configuración te permitirá hacerlo.

Introduce el nombre del host y carga tanto la clave privada como el certificado SSL. Asegúrate de que el dominio es accesible desde la red donde quieres acceder a AI Fabric a través de los puertos 8800, 31443 y 31390. En el caso de los certificados de dominio, asegúrate de que el archivo del paquete del certificado incluye todos los elementos en cadena de este orden específico: raíz, intermediario y certificado del servidor. Además, si el certificado de clave pública no se emitió con una clave de RSA pública de al menos 2048 bits, la validación fallará.

El formato del certificado es un archivo .pem, y la clave privada es un archivo .key. Puedes obtener los archivos desde el certificado .pfx.

Iniciar sesión en la consola de administración

Después de configurar el DNS en el paso anterior (o hacer clic en **Omitir y Continuar** para omitir ese paso), se mostrará la siguiente página:

Escribe tu contraseña del paso 4: Ejecutar el instalador de infraestructura de AI Fabric. Después de iniciar sesión, se te pedirá que cargues un archivo de licencia:

Carga el archivo YAML que tiene tu licencia de AI Fabric (ponte en contacto con tu representante de AI Fabric si no tienes una licencia de AI Fabric).

Elija el tipo de instalación

Instalación aislada

Si sigues la instalación aislada, en este paso, debes cargar el paquete de instalación.

Haz clic en el botón Elegir un paquete para cargar y selecciona el archivo aif_services extraído en el paso anterior.

Instalación en línea

Si está siguiendo la instalación en línea, haga clic en el enlace en la parte inferior de la página que indica download AI Fabric from the internet

Configurar el instalador

El siguiente paso es configurar el instalador utilizando la siguiente pantalla:

Los campos en esta página deben completarse. Consulta las siguientes explicaciones.

Ingress

IP del host (IP o FQDN) de la máquina Linux. Si configuraste DNS para esta máquina y completaste el paso Configurar DNS antes, introduce el nombre de dominio completo de esta máquina.

Base de datos única vs. varias bases de datos

Solo tienes que seleccionar la opción adecuada en función de lo que hiciste en el paso 2.

Sql

• Host Introduce la dirección IP de la base de datos SQL donde creaste las bases de datos en el paso 2: Configuración de SQL.
• Nombre de usuario Introduce el nombre de usuario para el propietario de la base de datos SQL.
• Contraseña Introduce la contraseña para la base de datos SQL.
  Aviso: Si utilizas bases de datos de Azure, asegúrate de utilizar FQDN para conectarte a las bases de datos. Puede ser un nombre de dominio público o privado (siempre que el DNS esté configurado), pero no funcionará si utilizas la IP privada. Consulta aquí: https://docs.microsoft.com/en-us/azure/private-link/private-endpoint-dns.

Orchestrator

Punto de conexión Introduce la dirección de Orchestrator con el puerto 443. No incluyas http ni https. El punto de conexión de Orchestrator debe ser el nombre de dominio <domain-name>:443.

Importante: Asegúrate de incluir el puerto 443 después del nombre de dominio. No incluir el puerto es uno de los errores de usuario habituales durante la instalación.

Consulta los siguientes ejemplos para evitar problemas.

Punto de conexión de Orchestrator introducido	Correcto
aifabric.orchestrator.cloudapp.azure.com:443	✓
https://aifabric.orchestrator.cloudapp.azure.com	✗
https://23.96.154:443	✗
23.96.154:443	✗

Servidor de identidad

Esto solo es necesario si UiPath Identity Server es diferente del punto de conexión de Orchestrator.

Token de acceso a Identity Server

Este es el token de identidad de Orchestrator. Para generar este token, ve a <orchestrator-address>/identity en un navegador. Asegúrate de haber iniciado sesión en el tenant del host (en lugar del tenant "predeterminado"). Se mostrará la siguiente página:

Si ves una página que no tiene la navegación izquierda como se ve anteriormente, es probable que hayas iniciado sesión en el tenant predeterminado. Asegúrate de iniciar sesión como el tenant del host.

Ahora haz clic en Token de acceso a la instalación, haz clic en Generar token y utiliza el icono de las dos tarjetas para copiar este token en tu portapapeles.

Pega este token en el campo token de acceso de Identidad.

Importante: Ten en cuenta que este token caduca en una hora. La configuración debería implementarse de inmediato después de haber generado el token para reducir el riesgo de problemas. Si tienes que editar la configuración y volver a implementar, asegúrate de generar un nuevo token.

Comprobaciones previas

Haz clic en Continuar en la página de configuración. Así, se te dirigirá a una página con el título Comprobaciones previas. Si pasas correctamente todas las comprobaciones previas, verás una página como esta:

La única comprobación previa que se puede ignorar de forma prudente es: Total Memory. De forma prudente, la máquina debería tener al menos 52GB RAM; para ver cómo aprovisionar menos memoria limita las capacidades de AI Fabric, consulta la página Requisitos de hardware.

Resolución de problemas con las comprobaciones previas

Si no ves una marca de verificación verde en las comprobaciones previas, utiliza esta guía para solucionar los errores.

Comprobación previa
Comprobación de Orchestrator	Comprueba que: Podemos conectarnos al dominio de Orchestrator en la ruta /api/auth. Comprueba que Web.config está establecido correctamente. Solución: asegúrate de que las reglas de la red están establecidas de forma que la máquina Linux pueda conectarse a Orchestrator. Comprueba que Web.config está establecido correctamente en 3. Configurar Orchestrator.
Comprobación de Identity Server	Verifica que podamos conectarnos al servidor de identidades en la ruta / identidad. Solución: asegúrate de que las reglas de la red están establecidas para que la máquina Linux se pueda conectar a Identity Server (si son diferentes a las de Orchestrator).
Validación de token de acceso a Identity Server	Verifica que el token de acceso es válido. Solución: si pasas la comprobación de Identity Server, asegúrate de tener un nuevo token, ya que la validez del token es de 1 hora.
Las comprobaciones de Orchestrator e Identity Server fallan Y no tienes un DNS externo.	Si no tienes un DNS externo a través del que se puede resolver el nombre de dominio de Orchestrator o el nombre de dominio de Identity Server, necesitas una aplicación adicional de un archivo de configuración. Consulta Resolución avanzada de problemas: Resolución de DNS
Comprobaciones de BD	Comprueba que: La conexión y las credenciales de SQL Server son válidas. La BD existe. El usuario está asignado al rol db_owner para cada BD. Solución: asegúrate de que SQL Server permite las conexiones entrantes en su puerto y de que la autenticación de SQL Server está habilitada. El script en 2. Configurar base de datos lleva a cabo automáticamente la creación de la BD y la creación adecuada de roles.
Todas las comprobaciones de Disk Space fallan.	Si has verificado las reglas de red/firewall para Orchestrator y SQL Server, pero aún ves que todas las comprobaciones relacionadas con las conexiones fallan, puede deberse a un problema de configuración de red más complejo de Enmascaramiento de IP. Por lo general, suele ocurrir cuando la máquina Linux y Orchestrator/SQL Server se encuentran en diferentes subredes. Si esto sucede, ejecuta: sysctl -w net.ipv4.ip_forward=1 iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE en la máquina Linux y vuelve a probar con las comprobaciones previas.

Si no puedes resolver el fallo de la comprobación previa, ponte en contacto con el soporte y envía un paquete de soporte. Consulta Resolución avanzada de problemas: Paquete de soporte para obtener instrucciones sobre cómo crear uno.

Ejecutar el instalador de la aplicación

Cuando todas las comprobaciones previas pasen correctamente, haz clic en Continue. Verás la siguiente página:

Esta página significa que el instalador de la aplicación de AI Fabric ha comenzado. Si todas las configuraciones se establecieron correctamente, la ejecución debería llevar de 20 a 30 minutos. Consulta a continuación para generar el registro que mostrará si la instalación se realizó correctamente.

Resolución de problemas con el instalador de la aplicación

Consejo:

En el más alto nivel, buscar la solución a los problemas con la instalación de la aplicación por ti mismo (ten en cuenta que puedes enviar un paquete de soporte al soporte técnico de UiPath; consulta más abajo) supone estos pasos:

• Consulta el registro de aprovisionamiento para determinar qué ha sucedido. Ejecuta kubectl logs -f provision-* para ver el registro de aprovisionamiento más reciente.
• Corrige/edita tu configuración una vez que descubras el error en los registros.
• Volver a iniciar un aprovisionamiento guardando la configuración, haciendo clic en Go to new new version y luego en Deploy.

Ejecutar registros

Para ver los registros de ejecución, puedes utilizar la interfaz de línea de comando de kubernetes, ya que el instalador de la aplicación se ejecuta sobre kubernetes.

Para ejecutar cualquier comando de kubernetes, vuelve a cargar tu shell de bash (una vez por sesión de terminal) ejecutando bash -l.

Cada vez que se cambia e implementa una configuración (para la primera configuración, la implementación se lleva a cabo de forma automática, pero para las siguientes debes guardar la configuración y hacer clic en Implementar), se ejecutará un nuevo trabajo para instalar la aplicación.

Para ver los registros de ejecución en la máquina Linux, ejecuta:

bash -l
kubectl get pods

y verás algo como esto:

aif-admin@aifabric-onprem-int0:~$ kubectl get pods
NAME                                  READY   STATUS             RESTARTS   AGE
...
...
provision-rmvfg                       0/1     Running            0          1m

La salida muestra un nombre con el formato provision-<identifier>. Para ver el instalador de la aplicación en ejecución, haz lo siguiente:

kubectl logs -f provision-rmvfg

Donde reemplazarás "rmvgf" con cualquier identificador que se muestre en tu terminal (como alternativa, escribe kubectl logs -f provision y presiona la tecla TAB; esto completará el identificador automáticamente).

Esto mostrará los registros de ejecución (si el proceso no ha finalizado), así como los registros cuando el proceso haya finalizado correctamente o haya terminado. La mayoría si no todos los usuarios pueden resolver problemas sin tener que utilizar nada más que el comando anterior.

Instalación correcta

Una instalación correcta mostrará la siguiente captura de pantalla antes de los 15-20 minutos después de pasar las comprobaciones previas:

Si ves esta pantalla, puedes continuar con el paso 6. Verificar la instalación.

Problemas conocidos

En la activación de una instalación solo después de haber pasado las comprobaciones previas, solo hay un problema conocido que puede ocurrir en el instalador de AI Fabric. Si este es el caso, verás el siguiente output del registro:

...
Starting ai-helper deployment ...Release "ai-helper" does not exist. 
Installing it now.
Error: etcdserver: request timed outHelm installation failed for ai-helper in namespace aifabric. 
Exiting !!!onebox provisioning failed. 
Exiting !!!

Este es un error de etcdserver intermitente. Vuelve a instalar yendo a la consola de administración en <ip>:8800, haciendo clic en Config, pegando un nuevo token de Identity Server, haciendo clic en Continue to new version, y finalmente haciendo clic en Deploy.

Este problema debería resolverse por sí mismo con hasta 5 intentos de instalación. Si tienes el mismo problema (Error: etcdserver: request timed out) y ves que instalando de nuevo no lo resuelve, ponte en contacto con soporte y crea un paquete de soporte.

Instalar modelos OOB (solo de forma aislada)

Para la instalación aislada, debes descargar manualmente los modelos de OOB y luego "instalarlos" en tu máquina de AI Fabric para poder utilizarlos. Para cada modelo que quieras añadir, tendrás un archivo .tar que debes mover a tu máquina de AI Fabric. Una vez en la máquina de AI Fabric, ejecuta los siguientes comandos para cada archivo:

tar -zxvf formextractor-1.tar.gz
cd formextractor
nohup sudo ./setup.sh > formextractor.out 2>&1

Puedes acceder a los registros en el archivo formextract.out. Se recomienda utilizar nohup para este comando, porque la instalación puede tardar hasta una hora, y esto evitaría cualquier problema debido a una pérdida de conexión con la máquina.

Solución de problemas avanzada

Crear un paquete de soporte

Para crear un paquete de soporte, ve a la IU de administrador (<machine-ip>:8800) y haz clic en Resolución de problemas en la barra de navegación superior. Haz clic en el botón para generar un nuevo paquete de soporte y luego descarga ese paquete. Cuando te pongas en contacto con soporte, incluye ese archivo en el ticket (support-bundle.tar.gz).

Resolución de DNS

Como se mencionó anteriormente, este problema se mostrará durante las comprobaciones previas. Como recordatorio, este problema se produce cuando no hay DNS externo que resuelva el dominio de Orchestrator o el dominio de Identity Server.

Para hacer frente a este problema (ten en cuenta que si eres un usuario de Linux con experiencia, el problema no se puede resolver simplemente añadiendo entradas a /etc/hosts), tendremos que editar configmap del clúster para que el clúster sea consciente de este DNS. Para ello, debes ejecutar el siguiente comando:

kubectl -n kube-system edit cm coredns

Se abrirá un editor de vi con el archivo que se ve como sigue:

apiVersion: v1
data:
  Corefile: |
    .:53 {
        errors
        health
        ready
        kubernetes cluster.local in-addr.arpa ip6.arpa {
           pods insecure
           fallthrough in-addr.arpa ip6.arpa
           ttl 30
        }
        prometheus :9153
        forward . /etc/resolv.conf
        cache 30
        loop
        reload
        loadbalance
        }
    }
kind: ConfigMap
metadata:
  creationTimestamp: "2020-11-30T12:25:28Z"
  name: coredns
  namespace: kube-system
  resourceVersion: "17667708"
  selfLink: /api/v1/namespaces/kube-system/configmaps/coredns
  uid: 2bde7049-eda6-46eb-b523-beb8c421085f

Debe añadirse una nueva sección hosts después de loadbalance en la sección Corefile (línea 19); ahí puedes enumerar todos los dns que desees y añadir fallthrough al final:

apiVersion: v1
data:
  Corefile: |
    .:53 {
        errors
        health
        ready
        kubernetes cluster.local in-addr.arpa ip6.arpa {
           pods insecure
           fallthrough in-addr.arpa ip6.arpa
           ttl 30
        }
        prometheus :9153
        forward . /etc/resolv.conf
        cache 30
        loop
        reload
        loadbalance
        hosts example.hosts orchestrator-dns.com {
          1.2.3.4 example.hosts
          5.6.7.8 orchestrator-dns.com
          fallthrough
        }
    }
kind: ConfigMap
metadata:
  creationTimestamp: "2020-11-30T12:25:28Z"
  name: coredns
  namespace: kube-system
  resourceVersion: "17667708"
  selfLink: /api/v1/namespaces/kube-system/configmaps/coredns
  uid: 2bde7049-eda6-46eb-b523-beb8c421085f

Después de eso, el DNS se configurará y trabajará dentro de tu clúster.

Aviso: Asegúrate de que, después de tus modificaciones, coredns es un archivo YAML adecuado y no utiliza tabulaciones para las sangrías, sino únicamente espacios.