Instalar Data Manager

Before proceeding, make sure you meet the Requirements and install the Prerequisites.

Requisitos

En esta sección se detallan los requisitos de hardware y software para instalar Data Manager.

Requisitos de hardware

• Machines Involved: VM in the Cloud or On-Prem Box or Laptop
• Operating Systems: Windows (Windows 10) or Linux (Ubuntu/CentOS/RedHat)
• Computing Engines: CPU
• OCR: Required

Núcleos de la CPU	RAM (GB)	HDD (GB)
1	4	30

Requisitos de software

Sistema operativo Linux

Si instalas el producto en una máquina virtual en la nube, se admiten los siguientes sistemas operativos:

Software	Versiones
Ubuntu	20.04 LTS 18.04 LTS 16.04 LTS
RHEL	7.x

Si instalas el producto en una máquina en un centro de datos local, se admiten los siguientes sistemas operativos:

Software	Versiones
Ubuntu	20.04 LTS 18.04 LTS 16.04 LTS
RHEL	7.x
CentOS	7.x

Sistema operativo Windows

See the official Docker website for the list of Windows operating systems supported.

En Windows, tu máquina requiere que se habilite la virtualización. Se recomienda encarecidamente hacer esto solo en máquinas físicas como portátiles o estaciones de trabajo de escritorio. No se admite la ejecución de Docker en Windows en máquinas virtuales (nube o centro de datos) utilizando la virtualización anidada.

Navegadores

Software	Versiones
Google Chrome	50+

Configuración de la red

(Optional) Data Manager needs access to AI Center on-premises or to public SaaS endpoints like https://du.uipath.com/ie/invoices in case Prelabelling is needed.

Data Manager necesita acceder al motor OCR <IP>:<port_number>. El motor OCR puede ser UiPath Document OCR local, Omnipage OCR local, Google Cloud Vision OCR, Microsoft Read Azure, Microsoft Read local.

Requisitos previos

Data Manager es una aplicación en contenedor que se ejecuta sobre docker. No se puede ejecutar en la misma máquina que AI Center On-Premises. Para ejecutarlo en una máquina independiente, solo es necesario tener instalado Docker (en Linux) o Docker Desktop (en Windows).

Importante:

Las imágenes de Docker pueden tener un tamaño de muchos GB, por lo que la carpeta que Docker utiliza para guardar sus archivos en Linux debe estar en una partición lo suficientemente grande como para no quedarse sin espacio. De forma predeterminada, siempre está en la partición raíz.

Para ver el tamaño de tu partición raíz, escribe lo siguiente en el terminal y busca la línea con una / en la columna de la derecha:

df -h

If the size of that partition is smaller than the minimal storage requirements, then see the Configuring the Docker Data Folder section.

Instalar Docker

Linux

Follow instructions in the official Docker documentation, or run this command:

curl -fsSL https://raw.githubusercontent.com/UiPath/Infrastructure/master/ML/du_prereq_installer.sh | sudo bash -s -- --env cpu

If this command fails, then you have an incompatible Linux operating system and you need to request your IT to install Docker on the machine following the instructions in the official Docker documentation.

Máquinas virtuales con Azure

Si la instalación se realiza en una máquina virtual con Azure, utiliza este comando:

curl -fsSL https://raw.githubusercontent.com/UiPath/Infrastructure/master/ML/du_prereq_installer.sh | sudo bash -s -- --env cpu --cloud azure

Windows 10

Download and install Docker Desktop. On recently updated versions of Windows 10, you will need WSL2 installed. So when presented with a dialog saying "WSL 2 Installation is Incomplete" please click the Restart button.

When running Data Manager you need to create a working folder for each Docker container (perhaps named workdir for Data Manager) and include the path to it in the docker run command, after the -v flag. When doing this on Windows, Docker Desktop will pop up a notification like the one below. You need to click on Share it to proceed.

Configurar la carpeta de datos de Docker (solo en Linux)

Introduce la ruta de la carpeta donde desea que Docker guarde sus archivos, ejecuta este comando y reinicia:

curl -fsSL https://raw.githubusercontent.com/UiPath/Infrastructure/master/ML/du_prereq_installer.sh | sudo bash -s -- --change-mount </path/to/folder>

Hoja de referencia de Docker Cheat

Docker permite enviar software en imágenes de Docker. Una instancia en ejecución de una imagen se denomina contenedor. Un contenedor puede detenerse, eliminarse y volver a iniciarse tantas veces como sea necesario, siempre que la imagen esté disponible.

Una vez que se elimina la imagen, esta se pierde. La única forma de recuperarla es sacarla de nuevo del registro del que procede, si todavía está disponible ahí.

A running container is analogous to a small Virtual Machine, in that it has an internal filesystemand network interfaces, which are separate from the host machine filesystem and network. Folders and ports can be mapped from the container to the host using –v and –p arguments, respectively.

En la siguiente tabla puedes encontrar una lista de comandos comunes para la línea de comandos de Docker.

Click here for the full list of base Docker commands.

Comando	Descripción
"docker login <registry name> -u <username> -p <password>"	Permite acceder a un registro.
"docker pull <registry name>/<image name>:<image tag>"	Permite descargar una imagen de un registro. La etiqueta más reciente se utiliza habitualmente para referirse a la última versión de una imagen.
"`docker run –d -p 5000:80 <registry name>/<image name>:<image tag> O docker run –d –p 5000:80 <image id> `"	Run a container in detached mode, while mapping port 80 from inside the container to port 5000 on the host machine, and <container folder> to <host folder>. Detached mode means the container does not block the terminal, so you can perform other operations on the same terminal.
"docker images"	Muestra una lista de las imágenes que hay en el sistema.
"docker ps –a"	Muestra una lista de todos los contenedores (tanto los que se están ejecutando como los que están detenidos). The container id is used to refer to that container when one needs to stop it or remove it, for instance.
"docker stop <container id>"	Detiene el contenedor Este comando no elimina el contenedor, pero es necesario hacerlo antes de eliminarlo.
"docker rm <container id>"	Elimina el contenedor El contenedor debe detenerse de antemano.
"docker logs <container id>"	Display the logs of the container
"docker rmi <image id>"	Elimina una o más imágenes del sistema. Esto contribuye a ahorrar espacio de almacenamiento, ya que las imágenes pueden ocupar mucho espacio.
"Docker container prune -f"	Elimina todos los contenedores detenidos

Hoja de referencia del terminal Linux

Comando	Descripción
"sudo <any_command>"	Ejecuta un comando como administrador. Prueba esto cada vez que aparezca el error Permiso denegado.
"ifconfig"	Muestra información sobre las interfaces de red del sistema. Localiza la IP de tu máquina en las secciones eth0 o docker0.
"pwd"	Muestra la ruta a la carpeta actual.
"ls"	Muestra una lista del contenido de un directorio.
"cd <folder_name>"	Permite ir a una carpeta distinta.
"mkdir <folder_name>"	Crea una carpeta nueva.

Instalar Data Manager

Procura tener a mano las credenciales de registro. Si no las has recibido, ponte en contacto con tu representante de ventas y solicita que te genere un conjunto de credenciales.

A continuación, introduce lo siguiente en un terminal Powershell o de línea de comandos (en Windows) o en un terminal shell (en Linux):

docker login aiflprodweacr.azurecr.io -u <username> -p <password>docker pull aiflprodweacr.azurecr.io/datamanager:latest

Importante:

Data Manager standalone container cannot run on the same machine as AI Center.

Lanzar Data Manager

Para iniciar Data Manager, utiliza el siguiente comando:

docker run -d -p <port_number>:80 -v "<path_to_working_folder>:/app/data" aiflprodweacr.azurecr.io/datamanager:latest --license-agreement accept

Sustituye<port_number>por el número de puerto en el que quieres que se pueda acceder a Data Manager. Los puertos en miles son comunes, como 5000, 8000, 8080, 8081, etc. Sustituye <path_to_working_folder> por la carpeta local donde quieres que Data Manager guarde toda su configuración y datos internos. Asegúrate de que el servicio docker tiene acceso a esa carpeta.

Después de ejecutar este comando, abre un navegador web e introduce la siguiente URL: http://localhost:<port_number>.

If you are using the browser on a different machine, replace localhost with the IP address of the machine where the datamanager container is running.

Para ejecutar varias sesiones de Data Manager, cambia la ruta de la carpeta y vuelve a ejecutar el comando.

Certificados autofirmados

If an ML Skill deployed in AI Center on-premises does not use a valid HTTPS certificate, you can use a Command Line option to whitelist the root of your self-signed certificate.

The certificate needs to be in a PEM format. As long as this requirement is met, the file extension is insignificant.

El certificado tiene que existir dentro del contenedor docker, por lo que tiene que estar instalado. Por lo tanto, instala el archivo de certificado en el contenedor utilizando la opción -v y especifica la ruta al mismo:

docker run -d -p <port_number>:80 -v "<path_to_working_folder>:/app/data" -v "<path_to_certificate_file>":/custom.cer aiflprodweacr.azurecr.io/datamanager:latest --license-agreement accept --custom-root-cert="/custom.cer"

Nota:

path_to_certificate_file no admite enlaces simbólicos.

La raíz del certificado autofirmado, en este caso custom.cer, tiene que ser la misma tanto en el primer argumento como en el segundo. Si se cambia uno, también hay que cambiar el otro.

Entornos aislados (sin acceso a Internet)

Si necesitas configurar Data Manager en una máquina sin acceso a internet (aislada), deberás ejecutar los comandos anteriores en alguna otra máquina que sí tenga acceso a internet.

Then you need to save the container as a .tar file, copy the file over to the airgapped machine, and then load it. This is done using the docker save and docker load commands described in Docker documentation.

Así que, en la máquina conectada a Internet, primero tienes que instalar Docker, luego, después de ejecutar los comandos docker login y docker pull, tienes que ejecutar el comando

docker save -o datamanager-latest.tar aiflprodweacr.azurecr.io/datamanager:latest

Luego tienes que copiar el archivo .tar a la máquina aislada, y después ejecutar este comando en la misma carpeta donde se guardó el archivo .tar:

docker load --input datamanager-latest.tar

Ten en cuenta que el archivo .tar será grande, ocupará unos cuantos gigabytes.