Instalação do Data Manager

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

Requisitos

Esta seção detalha os requisitos de hardware e software para instalação do 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 da CPU	RAM (GB)	HDD (GB)
1	4	30

Requisitos de software

Sistema operacional Linux

Se você instalar o produto em uma VM na nuvem, os seguintes sistemas operacionais serão suportados:

Software	Versões
Ubuntu	20.04 LTS 18.04 LTS 16.04 LTS
RHEL	7.x

Se você instalar o produto em uma máquina em um datacenter local, os seguintes sistemas operacionais serão suportados:

Software	Versões
Ubuntu	20.04 LTS 18.04 LTS 16.04 LTS
RHEL	7.x
CentOS	7.x

Sistema operacional Windows

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

No Windows, sua máquina requer a virtualização esteja habilitada. É altamente recomendável que isso seja feito apenas em máquinas físicas, como laptops ou estações de trabalho desktop. Não oferecemos suporte à execução no Docker no Windows em máquinas virtuais (nuvem ou datacenter) usando virtualização aninhada.

Navegadores

Software	Versões
Google Chrome	50+

Configuração de rede

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

O Data Manager precisa de acesso ao mecanismo de OCR <IP>:<port_number>. O mecanismo de OCR pode ser UiPath Document OCR on-premises, Omnipage OCR on-premises, Google Cloud Vision OCR, Microsoft Read Azure, Microsoft Read on-premises.

Pré-requisitos

O Data Manager é um aplicativo em contêiner executado sobre o Docker. Você não pode executá-lo na mesma máquina que o AI Center On-Premises. Para executá-lo em uma máquina separada, basta ter o Docker instalado (no Linux) ou o Docker Desktop instalado (no Windows).

Importante:

As imagens do Docker podem ter muitos GB de tamanho, portanto, a pasta que o Docker usa para armazenar seus arquivos no Linux deve estar em uma partição suficientemente grande para não ficar sem espaço. Por padrão, está sempre na partição raiz.

Para visualizar o tamanho da sua partição raiz, digite o seguinte no terminal e procure a linha com um / na coluna mais à direita:

df -h

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

Como instalar o 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 virtuais (VMs) do Azure

Se você estiver instalando em uma VM no Azure, use 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.

Como configurar a pasta de dados do Docker (somente Linux)

Preencha o caminho para a pasta onde deseja que o Docker mantenha seus arquivos, execute este comando e reinicie:

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

Folha de referência do Docker

O Docker ajuda a implantar software em Docker "images. Uma instância em execução de uma imagem é chamada de contêiner. Um contêiner pode ser parado, removido, reiniciado, quantas vezes forem necessárias, desde que a imagem esteja disponível.

Após a imagem ser removida, ele é perdido. A única maneira de recuperá-lo é puxá-lo novamente do registro de onde veio, se ainda estiver disponível lá.

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.

Na tabela abaixo, você pode encontrar uma lista de comandos comuns para a linha de comando do Docker.

Click here for the full list of base Docker commands.

Command	Description
"docker login <registry name> -u <username> -p <password>"	Faça login em um registro.
"docker pull <registry name>/<image name>:<image tag>"	Baixe uma imagem de um registro. A tag mais recente é comumente usada para se referir à versão mais recente de uma imagem.
"`docker run –d -p 5000:80 <registry name>/<image name>:<image tag> OU 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"	Liste imagens presentes no seu sistema.
"docker ps –a"	Liste todos os contêineres (em execução e parados). 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>"	Pare o contêiner Este comando não remove o contêiner, mas é necessário antes de removê-lo.
"docker rm <container id>"	Remova o contêiner O contêiner deve ser interrompido de antemão.
"docker logs <container id>"	Display the logs of the container
"docker rmi <image id>"	Remova uma ou mais imagens do sistema. Isso ajuda a economizar espaço de armazenamento, pois as imagens podem ocupar muito espaço.
"Docker container prune -f"	Remova todos os contêineres parados

Folha de referência do terminal Linux

Command	Description
"sudo <any_command>"	Execute um comando como administrador. Tente isso sempre que você receber o erro de Permissão Negada.
"ifconfig"	Exiba informações sobre as interfaces de rede em seu sistema. Encontre o IP da sua máquina nas seções eth0 ou docker0.
"pwd"	Exiba o caminho para a pasta atual.
"ls"	Liste o conteúdo de um diretório.
"cd <folder_name>"	Acesse uma pasta diferente.
"mkdir <folder_name>"	Crie uma nova pasta.

Instalação do Data Manager

Certifique-se de ter as credenciais de registro em mãos. Se você não recebeu as credenciais de registro, entre em contato com seu representante de vendas e solicite que um conjunto de credenciais seja gerado para você.

Em seguida, digite o seguinte em um terminal Powershell ou linha de comando (no Windows) ou terminal shell (no 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.

Iniciando o Data Manager

Para iniciar o Data Manager, use o seguinte comando:

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

Substitua <port_number> pelo número da porta onde deseja que o Data Manager seja acessível. Portas aos milhares são comuns, como 5000, 8000, 8080, 8081, etc. Substitua <path_to_working_folder> pela pasta local na qual deseja que o Data Manager mantenha todas as suas configurações e dados internos. Certifique-se de que o serviço Docker tenha acesso a essa pasta.

Após executar este comando, abra um navegador da Web e insira a seguinte 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 executar várias sessões do Data Manager, altere o caminho da pasta e execute o comando novamente.

Certificados autoassinados

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.

O certificado deve existir dentro do contêiner Docker, portanto, deve ser montado. Consequentemente, monte o arquivo cert dentro do contêiner usando -v e especifique o caminho para ele:

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"

Observação:

path_to_certificate_file não suporta links simbólicos.

A raiz do certificado autoassinado, neste caso custom.cer, deve ser a mesma tanto no primeiro argumento quanto no segundo. Se um for alterado, o outro também precisa ser.

Ambientes Air-gapped (sem acesso à Internet)

Se precisar configurar o Data Manager em uma máquina sem acesso à Internet (Air-gapped), será necessário executar os comandos acima em outra máquina que tenha acesso à 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.

Então, na máquina conectada à internet, você precisa primeiro instalar o Docker, depois, após executar os comandos docker login e docker pull acima, é preciso executar o comando

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

Em seguida, você precisa copiar o arquivo .tar para a máquina Air-gapped e, logo, executar este comando na mesma pasta onde o arquivo .tar foi salvo:

docker load --input datamanager-latest.tar

Esteja ciente de que o arquivo tar será grande, com alguns gigabytes.