document-understanding
2020.10
false
Obsoleto
Guia do usuário do Document Understanding.
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 29 de jul de 2024

Instalação do Data Manager

Antes de prosseguir, certifique-se de atender aos requisitos e instalar os pré-requisitos.

Requisitos

Esta seção detalha os requisitos de hardware e software para instalação do Data Manager.

Requisitos de Hardware

  • Máquinas envolvidas: VM na nuvem (Cloud) ou caixa ou laptop local (On-Premises)

  • Sistemas operacionais: Windows (Windows 10) ou Linux (Ubuntu/CentOS/RedHat)

  • Motores de computação: CPU

  • OCR: obrigatório

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

Consulte o site oficial do Docker para obter a lista de sistemas operacionais Windows suportados.

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

(Opcional) O Data Manager precisa de acesso ao AI Center On-Premises ou a Pontos de extremidades SaaS públicos, como https://du.uipath.com/ie/invoices, caso seja necessário pré-rotulagem.

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 -hdf -h

Se o tamanho dessa partição for menor que os requisitos mínimos de armazenamento, consulte a seção Como configurar a pasta de dados do Docker.

Como instalar o Docker

Linux

Siga as instruções da documentação oficial do Docker ou execute este comando:

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

Se esse comando falhar, você tem um sistema operacional Linux incompatível e precisa solicitar que seu TI instale o Docker na máquina seguindo as instruções na documentação oficial do Docker.

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 azurecurl -fsSL https://raw.githubusercontent.com/UiPath/Infrastructure/master/ML/du_prereq_installer.sh | sudo bash -s -- --env cpu --cloud azure

Windows 10

Baixe e instale o Docker Desktop. Em versões atualizadas recentemente do Windows 10, você precisará do WSL2 instalado. Portanto, quando aparecer uma caixa de diálogo dizendo "A instalação do WSL 2 está incompleta", clique no botão Reiniciar.

Ao executar o Data Manager, você precisa criar uma pasta de trabalho para cada contêiner Docker (talvez chamado workdir para o Data Manager) e incluir o caminho para ele no comando docker run, após o sinalizador -v. Ao fazer isso no Windows, o Docker Desktop exibirá uma notificação como a abaixo. Você precisa clicar em Compartilhar para continuar.


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

Um contêiner em execução é análogo a uma pequena máquina virtual, pois possui um filesystem interno e interfaces de rede, separados do filesystem e da rede da máquina host. Pastas e portas podem ser mapeadas do contêiner para o host usando os argumentos –v e –p, respectivamente.

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

Clique aqui para obter a lista completa de comandos básicos do Docker.

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>

`"

Execute um contêiner no modo desassociado, enquanto mapeia a porta 80 de dentro do contêiner para a porta 5000 na máquina host, e <container folder> para <host folder>. O modo desassociado significa que o contêiner não bloqueia o terminal, portanto, você pode realizar outras operações no mesmo terminal.

"docker images"

Liste imagens presentes no seu sistema.

"docker ps –a"

Liste todos os contêineres (em execução e parados).

  • O ID do contêiner é usado para se referir a esse contêiner quando é necessário pará-lo ou removê-lo, por exemplo.
"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>"

Exiba os logs do contêiner

"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:latestdocker login aiflprodweacr.azurecr.io -u <username> -p <password>docker pull aiflprodweacr.azurecr.io/datamanager:latest
Importante: o contêiner do Data Manager autônomo não pode ser executado na mesma máquina que o 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 acceptdocker 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>.
Se estiver usando o navegador em uma máquina diferente, substitua localhost pelo endereço IP da máquina em que o contêiner datamanager esteja em execução.

Para executar várias sessões do Data Manager, altere o caminho da pasta e execute o comando novamente.

Certificados autoassinados

Se uma Habilidade de ML implantada no AI Center On-Premises não usar um certificado HTTPS válido, você poderá usar uma opção de linha de comando para colocar na lista de permissões a raiz do seu certificado autoassinado.

O certificado precisa estar no formato PEM. Desde que esse requisito seja atendido, a extensão do arquivo é insignificante.

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

Em seguida, você precisa salvar o contêiner como um arquivo .tar, copiar o arquivo para a máquina Air-gapped e, em seguida, carregá-lo. Isso é feito usando os comandos docker save e docker load descritos na documentação do Docker.

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:latestdocker 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.tardocker load --input datamanager-latest.tar

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

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.