メインコンテンツへスキップ
Vantage 3.0 ではこのデプロイモデルは廃止されました。 Vantage 2.7 以前では、ABBYY が提供する Ansible スクリプトと Azure CLI スクリプトで構築される、ABBYY 指定のインフラストラクチャが必要でした。3.0 ではこのモデルはサポートされておらず、お客様が独自にインフラストラクチャをプロビジョニングする必要があります。また、ABBYY はプロビジョニング スクリプトやその他のインフラストラクチャ自動化を提供しません。このページは Vantage 2.7 にのみ適用されます。Vantage 3.0 の概要 と Vantage 2.7 からの移行 を参照してください。
このセクションでは、ABBYY Vantage を 2.7.x リリースライン内で更新する手順について説明します。3.0 への移行は更新ではなくマイグレーションにあたります。詳しくは、Vantage 2.7 から移行するを参照してください。
Vantage を更新する前に、システム要件セクションに記載されている新しいリリースの要件をすべて満たしていることを確認してください。
更新手順は、次のステップで構成されます。
  1. コンテナーイメージを同期する。
  2. データをバックアップする。
  3. インストールスクリプトを実行する。
  4. Vantage をアンインストールする。
  5. ABBYY Vantage を更新する。

​
コンテナーイメージの同期

コンテナーイメージを同期するには、コンテナーイメージのダウンロードの手順に従ってください。

​
データのバックアップ

更新時点で稼働していたバージョンに Vantage を復元するには、データベース、Consul、および Kubernetes シークレット のコピーのバックアップが必要です。これらのコンポーネントを適切にバックアップするには、以下の手順に従ってください。
  1. データベースと Consul のバックアップを作成する前に、クラスターを停止する必要があります。クラスター内のすべてのノードを停止してください。
  2. 次のバックアップを作成します。
    • Databases: データベースの一覧は次のとおりです: apigatewayregistry, auth, auth-identity, catalogstorage, cron, documentset, folderimport, interactive-jobs, mail, mailimport, permissions, publicapi, reporting, secretstorage, security-audit, skillinfo, skillmonitor, storage, subscriptions, tokenmanagement, transactions, workflows, workspace.
    • Consul: Kubernetes CronJob は、[X].consul-backup という名前の pod によって、Consul を外部 RWX ストレージ (NFS など) にバックアップします。バックアップされた TGZ ファイルは、consul-backup という名前の PVC フォルダーから取得できます。
  3. クラスターを起動します。クラスター内のすべてのノードを起動してください。
  4. Kubernetes シークレット のコピーをバックアップします。キーを取得するには、次のコマンドを実行します:
Kubernetes シークレット のコピーをバックアップする前に、クラスターが起動していることを確認してください。
バックアップは念のため作成するものです。アップグレードが正常に完了した場合は、バックアップから復旧する必要はありません。

​
インストールスクリプトを実行する

ABBYY Vantageを更新する前に、インストールの手順を実行してください。 インストールスクリプトを実行するには、次の手順に従います。
  1. 設定ファイルを準備します。
デフォルトでは、Vantageの更新時にTechnology Core バージョン 2は削除されます。これを保持するには、env_specific.yml ファイルに techcore.keep_previous_version パラメーターを追加し、その値を true に設定します。
  1. 証明書を準備します。
  2. コンテナーイメージをダウンロードします。
  3. インストールスクリプトを実行します (手順 1～3) 。

​
Vantage のアンインストール

製品をアンインストールするには、次のプレイブックを実行します。
このプレイブックを実行すると、データストアはそのまま残したまま、すべてのサービスが削除されます。

​
ABBYY Vantage を更新する

ABBYY Vantage を更新するには:
  1. 次のプレイブックを実行して、デプロイ前チェックを行い、Vantage の法的文書を確認して同意します。
プレイブックは次の処理を行います。
  • プレイブックの env_specific.yml ファイルで指定されたパラメーターに基づき、リソース (データベース、SMTP 接続など) の事前チェックを実行します。
  • システム管理者に、EULA および ABBYY プライバシーポリシーへの同意を求めます。
  1. Vantage を更新するには、次のプレイブックを実行します。
これらのプレイブックを実行すると、製品の新しいバージョンがインストールされます。通常、この処理には約20～30分かかります。
ABBYY Vantage の更新後は、再度認証が必要です。アップグレード前に取得した認証トークンは、以後使用できなくなります。
Advanced Designer と Scanning Station を使用するには、それぞれの新しいバージョンをダウンロードして、お使いのマシンにインストールする必要があります。
  • https://<your-vantage-host>/ad/latest - Advanced Designer のダウンロード用
  • https://<your-vantage-host>/ss/latest - Scanning Station のダウンロード用
更新処理が失敗した場合は、次の「復旧」セクションを参照してください。

​
復旧

更新プロセスが正常に完了しなかった場合は、次の手順に従ってください。
  1. クラスター内のpodが正常に動作していることを確認し、正常に動作していない場合は再起動します。
  2. 想定どおりに動作していないpodのログを確認して分析します。
  3. podのログに記載されているトラブルシューティング手順に従います。
  4. Vantage の新しいバージョンのインストール中のいずれかの手順でアップグレードが失敗した場合 (例: Vantage ジョブの待機、Vantage デプロイの待機) 、エラーの原因を修正してから、install プレイブックを実行します。

​
新しいクラスターでデータを復旧してVantageをインストールする

上記の手順で解決しない場合は、次の手順に従って、新しいクラスターでデータを復旧しながらVantageをインストールできます。
  1. データの最新バックアップがすべてそろっていることを確認します。
  2. 以前に作成したバックアップからデータを復元します。
  3. バックアップから復元したデータベースおよび外部ストレージへの接続情報を含む env_specific ファイルを準備します。
  4. インストールセクションのインストールスクリプトの実行の手順に従ってVantageをインストールします。手順 2 (Docker イメージからインストーラーを実行する) では、以下のコマンドを使用します。
  1. secretstorage-encryptionkeys および tokenmanagement-encryptionkeys シークレット内のキーの値を、先ほどバックアップした値で上書きします。 a. 次のコマンドを実行します。
    b. 開いたファイルで、key-<guid>.xml の後にある base64 文字列を、先ほど secretstorage-encryptionkeys シークレット用にバックアップしたキーに含まれる base64 文字列に置き換えます。 c. 変更を保存して、エディターを閉じます。 d. tokenmanagement-encryptionkeys シークレットについても、次のコマンドを使用して同じ操作を行います。
  2. キーを書き換えたら、secretstorage と tokenmanagement の pod を再起動します。
  1. トランザクションを再開します。クラスターに接続されているマシンで、トランザクションサービスにアクセスするために次のコマンドを実行します。
ブラウザーで http://localhost:8080/index.html にアクセスし、次の API メソッドを実行します。
復旧後にVantageのホストアドレスが変更され、システム内に承諾待ちの招待がある場合は、それらの招待を再送信する必要があります。