メインコンテンツへスキップ

共有フォルダー接続の設定

ABBYY Vantage では、Vantage サーバーでホストされている共有フォルダーを使用して、ドキュメントや Skill のインポート/エクスポート、およびデータ カタログの更新を行えます。 共有フォルダー (NFS 共有) の利用を開始する前に、クライアント コンピューターからそれらの共有フォルダーへの接続を設定する必要があります。Windows を実行しているクライアント コンピューターで、次の手順を実行します。
  1. Windows PowerShell を管理者として実行します。
  2. Windows NFS クライアントをインストールします。
  1. 会社の方針に応じて、Windows ユーザーを Unix の UID および GID に対応付けます。
  1. NFSクライアントを再起動します:
上記の手順を完了すると、Vantageで共有フォルダーのパスをコピーして使用したり、ファイル エクスプローラーで開いたりできるようになります。

データベース接続の設定

ABBYY Vantage は外部サーバーでホストされているデータベースを使用しているため、それらのサーバーで障害が発生すると動作しなくなる場合があります。システム管理者は、そのようなデータベースを別のサーバーに復元し、Consul を使用して新しいデータベースへの接続を設定できます。
開始する前に、kubectl コマンドラインツールがインストールされており、Kubernetes クラスターへの接続が確立されていることを確認してください。
ABBYY Vantage の設定で新しいデータベースへの接続を設定するには、次の手順を実行します。
  1. 以下のコマンドを実行して、Consul の Web インターフェイスにアクセスします。
次に、http://localhost:8500/ui/dc1/kv/secret/にアクセスします。
  1. 開いた Key/Value タブで、適切な Vantage 環境を選択します。
  2. platform または vantage プロジェクトと、データベースを使用する該当のサービス (例: mail) を選択します。
利用可能なサービスを示す Consul の platform services 一覧
  1. 各サービスに含まれる database セクションに移動します。
Vantage 環境の選択を示す Consul の Key/Value タブ
  1. SqlServer セクションを開きます。
SqlServer の構成を示す Consul の database セクション
  1. connectionString キーで、次の操作を行います。
    • Server の古い値を新しいサーバーのアドレスに置き換えます
    • Database パラメーターで新しいデータベースを指定します
    • User Id および Password パラメーターでログイン認証情報を指定します
Consul の connectionString 値エディター
  1. Save をクリックします。
  2. 次のコマンドを実行して、変更したサービスを再起動します。
サーバーアドレスが変更された場合は、この手順を各データベースに対して実行する必要があります。

データベースサービスのリファレンス

以下のテーブルに、データベースを使用するすべてのサービスと、各サービスの再起動に使用するラベルを示します。

プラットフォーム サービス

Vantage サービス

GPU の設定

Vantage では、半構造化文書からデータを抽出する Deep Learning activity で Skill を学習する際に、GPU を使用できます。

GPU のシステム要件

  • 仮想 GPU の最小 RAM: 12 GB
  • ホスト上の仮想 GPU ごとに 1 CPU および 4 GB の RAM (例: 12 GB の単一仮想 GPU を持つ VM には、少なくとも 2 CPU および 8 GB の RAM が必要です)

仮想 GPU

仮想 GPU (vGPU) を使用すると、1 台の物理 GPU を複数の仮想マシンに分割でき、Vantage のリソースをより効率的に活用できます。 vGPU を設定するには、次の手順を実行します。
  1. nVidia application hub から nVidia GRID ドライバーパッケージを GPU 搭載の仮想マシンにコピーし、次のコマンドを実行します。
  1. nVidia GPU オペレーターを Kubernetes クラスターにインストールします。 a. Vantage インストーラーコンテナーを実行する前に、ライセンス トークン ファイル (nVidia application hub で生成) を $PWD/gpu/ フォルダーに配置します。 b. Vantage インストーラーコンテナーを実行するコマンドに -v $PWD/gpu:/ansible/files/gpu:ro パラメーターを追加します。
c. [abbyy_workers] グループのインベントリファイルに GPU ノードを追加します。GPU を搭載した仮想マシンの名前には “gpu” が含まれている必要があります:
d. 次のプレイブックを実行して、クラスターにノードを追加します。
  1. 次のプレイブックを実行して vGPU を設定します:

GPU パススルー

GPU パススルーを設定すると、仮想マシンから GPU に直接アクセスできるようになります。 GPU パススルーを設定するには:
  1. Vantage インストーラーコンテナーを実行します:
  1. GPU ノード (例: worker2-12-a40-gpu01) を、[abbyy_workers] グループのインベントリファイルに追加します:
  1. プレイブックを実行します:
  1. GPU オペレーターのHelm チャートをインストールします:
  1. ノードに taint を追加します:

GPU のテストとデプロイ

vGPU モードと GPU パススルー モードのどちらでも、GPU オペレーターのインストールをテストするには:
  1. 次のコマンドを実行します:
  1. 以下の内容でYAMLファイルを作成し、適用します。
  1. pod のログを確認します。Test PASSED を含むレスポンスが表示されるはずです:
想定される出力:
GPU workerをデプロイするには:
  1. 次のパラメーターをenv_specific.ymlファイルに追加します:
  1. 次のいずれかを行います。
    • Vantage がすでにインストールされている場合は、次のプレイブックを実行して GPU ワーカーをデプロイします。
  • Vantage がまだインストールされていない場合、GPU ワーカーはインストール時にデプロイされます。

手動確認の非アクティブタイムアウトの設定

手動確認では、開いているタスクに対してオペレーターが15分間まったく操作を行わないと、タイムアウトが発生します。システム管理者は、Consul を使用して、タイムアウトが発生するまでの非アクティブ状態の継続時間を変更できます。 タイムアウトを設定するには:
  1. 次を実行して Consul の Web インターフェイスにアクセスします:
次に、http://localhost:8500/ui/dc1/kv/secret/ を開きます。
  1. Key/Value タブを使用して、適切な Vantage 環境を選択します。
  2. 次のキーの値を変更します。
  1. Save をクリックします。
  2. verification サービスと manualverification サービスを再起動します:

SSL 証明書の更新

SSL 証明書の有効期限が切れた場合は、新しい証明書に差し替える必要があります。

Lens を使用する

  1. Config > Secrets に移動し、platform-wildcard という名前のすべてのシークレットを見つけます。
  2. 各シークレットで Data サブセクションを見つけ、Show アイコンをクリックして値を更新します。
    • 新しい証明書の値を tls.crt field に入力します
    • そのキーの値を tls.key field に入力します
証明書とキーは、base64 ASCII エンコードされた内容 (PKCS#8) の PEM ファイルである必要があります。証明書は -----BEGIN CERTIFICATE----- で始まり、キーは -----BEGIN PRIVATE KEY----- で始まる必要があります。
  1. Save をクリックします。

Linuxのコマンドラインを使用する

  1. Kubernetesクラスターにアクセスできることを確認します。
  1. 証明書と秘密鍵を PEM 形式の cert.pemkey.pem として現在のフォルダーに配置します。
必要に応じて、CRT ファイルを PEM 形式に変換します。
  1. 次のコマンドを実行します: