watsonx Orchestrate のバージョン 5.2 からバージョン 5.3.1 へのアップグレード

このタスクを完了するために必要な情報

watsonx Orchestrateをアップグレードする前に、以下の情報を確認してください。

バージョンの要件

IBM Software Hubのインスタンスに関連付けられているすべてのコンポーネントは、同じリリースでインストールする必要があります。 例えば、IBM Software Hub control planeがバージョン 5.3.1の場合、watsonx Orchestrateをバージョン 5.3.1にアップグレードする必要があります。

環境変数

このタスクのコマンドでは環境変数を使用するため、記載されているとおりにコマンドを実行できます。

• 環境変数を定義するスクリプトがない場合は、インストール環境変数の設定を参照してください。
• スクリプトから環境変数を使用するには、このタスクでコマンドを実行する前に環境変数をsourceする必要があります。 例えば、以下のコマンドを実行します。

  source ./cpd_vars.sh

始める前に

このタスクでは、以下の前提条件が満たされていることを前提としています。

システム要件

このタスクでは、クラスターが watsonx Orchestrateの最小要件を満たしていることを前提としています。

詳細情報の参照先
このタスクが完了していない場合は、『システム要件』を参照してください。

さらに、GPU を必要とする機能を使用する予定の場合は、watsonx Orchestrateに適切なタイプと数の GPU があることを確認してください。

詳細情報の参照先
このタスクが完了していない場合は、GPU 要件を参照してください。

ワークステーション

このタスクでは、アップグレードを実行するワークステーションがクライアント・ワークステーションとしてセットアップされており、以下のコマンド行インターフェースがあることを前提としています。

• IBM Software Hub CLI: cpd-cli
• OpenShift CLI: oc
• Helm CLI: oc

詳細情報の参照先
このタスクが完了していない場合は、『クライアント・ワークステーションの更新』を参照してください。 Updating client workstations

コントロール・プレーン

このタスクでは、IBM Software Hub control planeがアップグレードされていることを前提としています。

詳細情報の参照先
このタスクが完了していない場合は、IBM Software Hubのインスタンスのアップグレードを参照してください。

プライベート・コンテナー・レジストリー

ご使用の環境でプライベート・コンテナー・レジストリーを使用している場合 (例えば、クラスターがエアー・ギャップである場合)、このタスクでは以下のタスクが完了していることを前提としています。

1. watsonx Orchestrate ソフトウェア・イメージがプライベート・コンテナー・レジストリーにミラーリングされます。

   詳細情報の参照先
   このタスクが完了していない場合は、プライベート・コンテナー・レジストリーへのイメージのミラーリングを参照してください。

2. cpd-cliは、プライベート・コンテナー・レジストリーから olm-utils-v4イメージをプルするように構成されています。

   詳細情報の参照先
   このタスクが完了していない場合は、プライベート・コンテナー・レジストリーからの olm-utils-v4 イメージのプルを参照してください。

GPU オペレーター

GPU を必要とする機能を使用する予定の場合、このタスクでは、GPU を使用するために必要なオペレーターがインストールされていることを前提としています。

詳細情報の参照先
このタスクが完了していない場合は、GPU を必要とするサービスのオペレーターのインストールを参照してください。

Red Hat OpenShift AI

Red Hat OpenShift AIを必要とする機能を使用する予定の場合、このタスクでは、Red Hat OpenShift AIがインストールされていることを前提としています。

詳細情報の参照先
このタスクが完了していない場合は、Red Hat OpenShift AI のインストールを参照してください。

Multicloud Object Gateway

このタスクでは、Multicloud Object Gatewayがアップグレードされていることを前提としています (必要な場合)。

詳細情報の参照先
このタスクが完了していない場合は、Multicloud Object Gateway のアップグレードを参照してください。

Red Hat OpenShift Serverless Knative Eventing

このタスクでは、以下のタスクが完了していることを前提としています。

1. Red Hat OpenShift Serverless Knative Eventing がアップグレードされます

   詳細情報の参照先
   このタスクが完了していない場合は、 Red Hat OpenShift Serverless Knative Eventing のインストールを参照してください。

2. インスタンスの IBM Events Operator がアップグレードされます。

   5.3.1 以降 このタスクは、IBM Software Hub バージョン 5.3.1 以降にアップグレードする場合にのみ必要です。 IBM Software Hub バージョン 5.3.0 にアップグレードする場合は、このタスクをスキップします。

   詳細情報の参照先
   このタスクが完了していない場合は、IBM Events Operator のアップグレードを参照してください。

クラスター・スコープ・リソース

このタスクでは、カスタム・リソース定義、クラスター役割、クラスター役割バインディングなどのクラスター・スコープのリソースが更新されていることを前提としています。

詳細情報の参照先
このタスクが完了していない場合は、プラットフォームおよびサービスのクラスター・スコープ・リソースの更新を参照してください。

イメージ・プル・シークレット

このタスクでは、インスタンスのイメージ・プル資格情報を含むシークレットが存在することを前提としています。

詳細情報の参照先
このタスクが完了していない場合は、IBM Software Hub のインスタンスのイメージ・プル・シークレットの作成を参照してください。

手順

watsonx Orchestrate をアップグレードするには、以下のタスクを実行します。

1. インストール・オプションの指定
2. アップグレード中の問題のトラブルシューティング
3. サービスのアップグレード
4. アップグレードの検証
5. サービス・インスタンスのアップグレード
6. アップグレード後のタスク
7. 次に行うこと

インストール・オプションの指定

IBM Software Hub バージョン 5.3.0 では、watsonx Orchestrate のデフォルトの動作は、エージェント・フィーチャーのみをインストールすることです。

以下の表を確認して、インストール・オプションを指定する必要があるかどうかを判別します。

エージェント・アシスタント・モードのカスタム・アップグレード・オプション

カスタム・アップグレード・オプションを使用して前のバージョンの watsonx™ Orchestrate をアップグレードする場合は、cpd-cli work ディレクトリー内の install-options.yml という名前のファイルに適切なオプションを指定します (例: cpd-cli-workspace/olm-utils-workspace/work).

---
# ............................................................................
# watsonx Orchestrate parameters
# ............................................................................
non_olm:
  watsonxOrchestrate:
    installMode: "agentic_assistant"  
    watsonxAI:
      watsonxaiifm: true

エージェント・モードのカスタム・アップグレード・オプション

カスタム・アップグレード・オプションを使用して前のバージョンの watsonx Orchestrate をアップグレードする場合は、cpd-cli work ディレクトリー内の install-options.yml という名前のファイルに適切なオプションを指定します (例: cpd-cli-workspace/olm-utils-workspace/work).

---
# ............................................................................
# watsonx Orchestrate parameters
# ............................................................................
non_olm:
  watsonxOrchestrate: 
    watsonxAI:
      watsonxaiifm: true

アップグレード中の問題のトラブルシューティング

サービスのアップグレード

watsonx Orchestrateをアップグレードするには、次のようにします。

1. cpd-cliをRed Hat OpenShift Container Platform・クラスターにログインします。

   ${CPDM_OC_LOGIN}

   CPDM_OC_LOGIN は cpd-cli manage login-to-ocp コマンドのエイリアスであることを覚えておいてください。
2. watsonx Orchestrateのオペレーターとカスタム・リソースを更新します。

   適切なコマンドを実行して、カスタム・リソースを作成します。

   デフォルトのインストール (インストール・オプションなし)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=watsonx_orchestrate \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --upgrade=true

   カスタム・インストール (インストール・オプションあり)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=watsonx_orchestrate \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml \
   --upgrade=true

アップグレードの検証

[SUCCESS]... The install-components command ran successfully

カスタム・リソースの状況が Completedであることを確認する場合は、cpd-cli manage get-cr-status コマンドを実行できます。

cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=watsonx_orchestrate

サービス・インスタンスのアップグレード

watsonx Orchestrateをアップグレードすると、サービス・インスタンスは自動的にアップグレードされます。

アップグレード後のタスク

パッチ 2 このセクションは、バージョン 5.3.1 パッチ 2 にアップグレードする場合にのみ適用されます。

oc delete cronjob wo-watson-orchestrate-redis-cronjob --ignore-not-found

次のタスク