- リリース ノート
- 要件
- インストール
- 基本情報
- プロジェクト
- データセット
- ML パッケージ
- パイプライン
- ML スキル
- ML ログ
- AI Fabric での Document Understanding
- 基本的なトラブルシューティング ガイド
1. マシンをプロビジョニングする
このセクションでは、マシンをプロビジョニングするときに必要な手順について詳しく説明します。
- 現在、AI Fabric のインストールは、新しい専用のマシン上でサポートされています。不明なポリシーや制限がある共有マシンは、問題の回避策が別途必要になることがあるので、公式にはサポートされていません。
- AI Fabric のインストールには、一般的なクラウド プロバイダーが提供する仮想マシン インスタンスを使用することをお勧めします。GPU が必要なセットアップでは、NVIDIA の GPU のみがサポートされます。たとえば、Standard_NC12 (Azure の場合)、n1-standard-16 (GCP の場合)、p3.2xlarge (AWS の場合) などです。
/var ディレクトリには、標準インストールの場合は 200 GB 以上、エアギャップ インストールを利用可能な場合は 500 GB 以上が必要です (通常は、起動ディスクに応じた容量が必要になりますが、例外もあります)。そうでないと、インストーラーは失敗します。
コマンド df -h を使用して、ディスクが正しく割り当てられていることを確認します。
エアギャップ インストールの場合は、/var ディレクトリに 500 GB がマウントされているのが理想です。内部ポリシーによって /var のサイズの変更が禁止されている場合は、500 GB を次のように共有する必要があります。
- /var: 45 GB (または、できるだけ大きく)
- /var/lib/etcd: 5 GB
- /var/lib/docker: 250 GB
- /var/lib/kubelet: 200 GB
外部データ ディスクが接続されていて、フォーマットはされていない必要があります。ディスクが未フォーマット (未処理) であることは非常に重要です。フォーマットされていると、インストーラーは失敗し、復元できません。その場合は、新しいマシンを再プロビジョニングして、新しいディスクを接続する必要があります。さらに、AI Fabric に使用するセカンダリ ストレージはディスクである必要があります (パーティションではない)。
AI Fabric にアクセスするネットワークから上記のポートへのアクセスを許可する受信規則が存在する必要があります。
このポートを使用して、kubernetes API にアクセスします。マシンの IP 自体のみがインバウンドおよびアウトバウンド アクセスを必要とします (ローカルホストはアプリケーションでは使用されず、IP 自体が使用されます)。
https://du-metering.uipath.com
にアクセスできることを確認します。 これは、エアギャップ インストールには適用されません。
上記のように、インストールには、十分な大きさの未フォーマットの外部データ ディスクが必要です。この Linux マシンの bash プロンプトで以下のコマンドを実行して、外部ディスクが間違いなく未フォーマットかどうかを確認します。
file -sL /dev/sd*
file -sL /dev/sd*
出力は次のようになります。
<user>@<hostname>:~$ file -sL /dev/sd*
/dev/sda: DOS/MBR boot sector, extended partition table (last)
/dev/sda1: Linux rev 1.0 ext4 filesystem data, UUID=01772985-75fa-4dd1-b12c-66526c1fb0cd, volume name "cloudimg-rootfs" (needs journal recovery) (extents) (64bit) (large files) (huge files)
/dev/sda14: data
/dev/sda15: DOS/MBR boot sector, code offset 0x58+2, OEM-ID "mkfs.fat", Media descriptor 0xf8, sectors/track 32, heads 64, sectors 217088 (volumes > 32 MB), FAT (32 bit), sectors/FAT 1670, reserved 0x1, serial number 0xad0c5d13, label: "UEFI "
/dev/sdb: data
<user>@<hostname>:~$ file -sL /dev/sd*
/dev/sda: DOS/MBR boot sector, extended partition table (last)
/dev/sda1: Linux rev 1.0 ext4 filesystem data, UUID=01772985-75fa-4dd1-b12c-66526c1fb0cd, volume name "cloudimg-rootfs" (needs journal recovery) (extents) (64bit) (large files) (huge files)
/dev/sda14: data
/dev/sda15: DOS/MBR boot sector, code offset 0x58+2, OEM-ID "mkfs.fat", Media descriptor 0xf8, sectors/track 32, heads 64, sectors 217088 (volumes > 32 MB), FAT (32 bit), sectors/FAT 1670, reserved 0x1, serial number 0xad0c5d13, label: "UEFI "
/dev/sdb: data
/dev/sdb
の値が data
だけであることに注意してください。これはディスクが未フォーマットであることを示しています。同様に、以下のコマンドを使用して、システム内のディスクのサイズを確認できます。
lsblk --all --list --output KNAME,SIZE,TYPE,PKNAME,NAME
lsblk --all --list --output KNAME,SIZE,TYPE,PKNAME,NAME
出力は次のようになります。
KNAME SIZE TYPE PKNAME NAME
loop0 126.4M loop loop0
loop1 55.3M loop loop1
loop2 126.9M loop loop2
loop3 9.5M loop loop3
loop4 29.9M loop loop4
loop5 loop loop5
loop6 30.3M loop loop6
loop7 loop loop7
sda 100G disk sda
sda1 99.9G part sda sda1
sda14 4M part sda sda14
sda15 106M part sda sda15
sdb 200G disk sdb
KNAME SIZE TYPE PKNAME NAME
loop0 126.4M loop loop0
loop1 55.3M loop loop1
loop2 126.9M loop loop2
loop3 9.5M loop loop3
loop4 29.9M loop loop4
loop5 loop loop5
loop6 30.3M loop loop6
loop7 loop loop7
sda 100G disk sda
sda1 99.9G part sda sda1
sda14 4M part sda sda14
sda15 106M part sda sda15
sdb 200G disk sdb
sdb
の TYPE
は disk であることに注意してください。手順「4. AI Fabric インフラストラクチャ インストーラーを実行する」では、未フォーマットの空のディスクを探します。partition
と同じ TYPE
のデバイスに未フォーマットの領域がある場合、インストーラーは適切なデバイスを検出できません。
AI Center マシン (つまり、AI Fabric がインストールされるマシン) から、
以下のコマンドを実行して、Orchestrator に接続できることを確認します。
telnet <Orchestrator Fully-Qualified-Domain-Name> 443
telnet <Orchestrator Fully-Qualified-Domain-Name> 443
以下のコマンドを実行して、SQL データベースに接続できることを確認します。
telnet <SQL-database-ip> 1433
telnet <SQL-database-ip> 1433
要件 | 備考 |
---|---|
動作している v20.4 以降の Orchestrator がインストールされている | こちらをご覧ください。 |
SQL Server 2008 R2 以上がある。 | こちらをご覧ください。 |
SQL Server 認証を有効化する必要がある | SQL Server 管理者に連絡してください。 |
データベースおよびロールの作成が可能な SQL 資格情報 | SQL Server 管理者に連絡してください。 |
対応しているブラウザーを使用している | こちらをご覧ください。 |
200GB 以上の起動ディスク (エアギャップ環境にインストールする場合は 500GB) | 詳しくは、こちらをご覧ください。 |
合計 250 GB 以上のセカンダリ ディスクが未フォーマットである | こちらをご覧ください。 |
AI Fabric マシンから Orchestrator に接続する。ドメイン名を使用して接続可能であること | telnet <Orchestrator-Domain-Name>
<port> AI Fabric マシンの telnet <Orchestrator-Domain-Name> <port> が動作する必要があります。
|
AI Fabric マシンからデータベースに接続する。 | telnet <SQL-Server-IP>
<port> AI Fabric マシンの telnet <Orchestrator-Domain-Name> <port> が動作する必要があります。
|
Robot/Studio マシンから AI Fabric に接続可能である。 | telnet <aif-linux-machine> 31390
Robot/Studio マシンの telnet <aif-linux-machine> 31390 が動作する必要があります。すなわち、Robot/Studio マシンはポート 31390 上の Linux マシンのクライアントになります。
|
インストーラーで必要なエンドポイントに AI Fabric マシンから接続可能である (エアギャップ環境には適用されません)。 | AI Fabric マシンからエンドポイントへのアウトバウンド アクセスがブロックされていてはなりません。 |
信頼できる認証機関からのドメイン証明書 (AI Fabric マシン用) | こちらをご覧ください。 |
AI Fabric のライセンス ファイル。 | こちらをご覧ください。 |