Data Manager をインストールする

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

要件

このセクションでは、Data Manager をインストールする場合のハードウェア要件とソフトウェア要件を詳しく説明します。

ハードウェア要件

• 必要なマシン: クラウド内の仮想マシンまたはオンプレミス ボックスまたはノート PC
• オペレーティング システム: Windows (Windows 10) または Linux (Ubuntu/CentOS/RedHat)
• コンピューティング エンジン: CPU
• OCR: 必須

CPU コア	RAM (GB)	HDD (GB)
1	4	30

ソフトウェア要件

Linux オペレーティング システム

クラウドの仮想マシンに製品をインストールする場合は、次のオペレーティング システムがサポートされます。

ソフトウェア	バージョン
Ubuntu	20.04 LTS 18.04 LTS 16.04 LTS
RHEL	7.x

オンプレミスのデータセンターにあるマシンに製品をインストールする場合は、次のオペレーティング システムがサポートされます。

ソフトウェア	バージョン
Ubuntu	20.04 LTS 18.04 LTS 16.04 LTS
RHEL	7.x
CentOS	7.x

Windows オペレーティング システム

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

Windows では、マシンで仮想化が有効化されている必要があります。ノート PC やデスクトップ ワークステーションのような物理マシンでのみ仮想化を有効化することを強く推奨します。入れ子の仮想化を使用する仮想マシン (クラウドまたはデータセンター) の Windows 上での Docker の実行はサポートされていません。

ブラウザー

ソフトウェア	バージョン
Google Chrome	50 以上

ネットワーク構成

(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 は OCR エンジン (<IP>:<port_number>) にアクセスできる必要があります。OCR エンジンとしては、オンプレミスの UiPath Document OCR、オンプレミスの Omnipage OCR、Google Cloud Vision OCR、Microsoft Read Azure、オンプレミスの Microsoft Read が考えられます。

前提条件

Data Manager は、Docker 上で実行されるコンテナー化されたアプリケーションです。Data Manager をオンプレミスの AI Center と同じマシンで実行することはできません。別々のマシンで実行するために必要なことは、Docker のインストール (Linux の場合) または Docker Desktop のインストール (Windows の場合) だけです。

重要:

Docker イメージのファイル サイズ (GB) は非常に大きくなる可能性があるため、Linux 上で Docker のファイルを保存するために使用するフォルダーは、スペースが不足しないように十分な大きさのパーティションに作成する必要があります。既定では、常にルート パーティションに作成されます。

ルート パーティションの大きさを確認するには、ターミナルで以下を入力し、右端の列で / を含む行を探します。

df -h

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

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.

Azure VM

Azure の VM にインストールする場合は、以下のコマンドを使用します。

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.

Data Manager を実行するときは、各 Docker コンテナーに対して作業フォルダー (Data Manager ではたとえば workdir という名前のフォルダー) を作成し、そのフォルダーのパスを docker run コマンドの -v フラグの後に含める必要があります。　この操作を Windows 上で行うと、Docker Desktop で以下のようなメッセージが表示されます。続行するには、[Share it] をクリックします。

Docker のデータ フォルダーを構成する (Linux のみ)

Docker のファイルを保持するフォルダーのパスを入力し、このコマンドを実行した後、再起動します。

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

Docker のチート シート

Docker は、ソフトウェアを Docker イメージで配布するのに役立ちます。イメージの実行中インスタンスをコンテナーと呼びます。イメージが利用可能な限り、必要な回数だけコンテナーを停止、削除、再開できます。

イメージをいったん削除すると、元に戻すことはできません。イメージを回復するには、元のレジストリから再度取得するしかありません (レジストリにまだ存在する場合)。

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.

以下の表に、Docker コマンド ラインで使用する一般的なコマンドのリストを示します。

Click here for the full list of base Docker commands.

コマンド	説明
「docker login <registry name> -u <username> -p <password>」	レジストリにログインします。
「docker pull <registry name>/<image name>:<image tag>」	レジストリからイメージをダウンロードします。最新バージョンのイメージを参照するには、一般に latest タグを使用します。
"`docker run –d -p 5000:80 <registry name>/<image name>:<image tag> OR 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」	システムに存在するイメージのリストを取得します。
「docker ps –a」	すべてのコンテナーのリストを取得します (実行中のものと停止されているものの両方)。 たとえば、コンテナーを停止または削除する必要がある場合に対象のコンテナーを参照するには、container id を使用します。
「docker stop <container id>」	コンテナーを停止します。 このコマンドではコンテナーは削除されません。ただし、削除する前にコマンドを実行する必要があります。
「docker rm <container id>」	コンテナーを削除します。 コンテナーは事前に停止する必要があります。
「docker logs <container id>」	コンテナーのログを表示します。
「docker rmi <image id>」	1 つまたは複数のイメージをシステムから削除します。 イメージは多くのスペースを占有する可能性があるため、これでストレージ スペースを節約できます。
「Docker container prune -f」	停止したコンテナーをすべて削除します。

Linux ターミナルのチート シート

コマンド	説明
「sudo <any_command>」	管理者としてコマンドを実行します。Permission Denied エラーが発生する場合は、必ずこれを試してください。
「ifconfig」	システム内のネットワーク インターフェイスに関する情報を表示します。eth0 または docker0 のいずれかのセクションでマシンの IP を確認します。
「pwd」	現在のフォルダーへのパスを表示します。
「ls」	ディレクトリの内容のリストを取得します。
「cd <folder_name>」	別のフォルダーに移動します。
「mkdir <folder_name>」	新しいフォルダーを作成します。

Data Manager をインストールする

レジストリ資格情報が手元にあることを確認してください。レジストリ資格情報を受け取っていない場合は、営業担当に連絡し、一連の資格情報の作成を依頼する必要があります。

次に、Powershell、あるいはコマンドライン ターミナル (Windows の場合) またはシェル ターミナル (Linux の場合) のいずれかで、以下を入力します。

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

重要:

Data Manager のスタンドアロン コンテナーを AI Center と同じマシンで実行することはできません。

Data Manager を起動する

Data Manager を起動するには、以下のコマンドを使用します。

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

<port_number> は、Data Manager がアクセスできるようにするポート番号に置き換えます。5000、8000、8080、8081 などのように、数千番台のポート番号を使用するのが一般的です。<path_to_working_folder> は、Data Manager の内部の設定およびデータをすべて保持するローカル フォルダーに置き換えます。そのフォルダーに Docker サービスがアクセスできることを確認してください。

このコマンドの実行後、Web ブラウザーを開いて URL「http://localhost:<port_number>」を入力します。

別のマシンのブラウザーを使用している場合は、localhost の代わりに、datamanager コンテナーが実行されているマシンの IP アドレスを指定します。

複数の Data Manager セッションを実行するには、フォルダー パスを変更して、コマンドを再度実行します。

自己署名証明書

オンプレミスの AI Center にデプロイされている ML スキルで有効な HTTPS 証明書が使用されていない場合は、[コマンド ライン] オプションを使用して自己署名証明書のルートをホワイト リストに登録できます。

証明書は PEM 形式でなければなりません。この要件が満たされている限り、ファイル拡張子は重要ではありません。

証明書は Docker コンテナー内に存在していなければならないため、マウントが必要です。したがって、-v を使用して証明書ファイルをコンテナー内にマウントし、そのパスを指定します。

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"

注:

path_to_certificate_file は symlink をサポートしていません。

自己署名証明書のルート (この場合は custom.cer) は最初の引数と 2 番目の引数で同じでなければなりません。一方を変更する場合は、もう一方も変更する必要があります。

エアギャップ環境 (インターネット アクセスなし)

インターネットにアクセスできない (エアギャップ環境の) マシンに Data Manager をセットアップする必要がある場合は、インターネットにアクセスできる他のマシンで上記のコマンドを実行します。

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.

まず、インターネットに接続されているマシンに Docker をインストールします。次に、前出の docker login コマンドと docker pull コマンドを実行した後で、以下のコマンドを実行する必要があります。

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

エアギャップ環境のマシンに .tar ファイルをコピーし、.tar ファイルが保存されたフォルダーでこのコマンドを実行します。

docker load --input datamanager-latest.tar

tar ファイルのサイズは大きくなります。数ギガバイトにもなるのでご注意ください。