IBM watsonx.ai のバージョン 5.2 からバージョン 5.3 へのアップグレード

インスタンス管理者は、IBM watsonx.ai をバージョン 5.2 からバージョン 5.3 にアップグレードできます。

このタスクを実行する必要があるのは誰か?

インスタンス管理者 IBM watsonx.ai をアップグレードするには、インスタンス管理者でなければなりません。 インスタンス管理者は、以下のプロジェクト内のソフトウェアを管理する権限を持っています。

インスタンスの オペレーター・プロジェクト

IBM watsonx.ai のこのインスタンスのオペレーターは、オペレーター・プロジェクトにインストールされます。 アップグレード・コマンドで、${PROJECT_CPD_INST_OPERATORS} 環境変数はオペレーター・プロジェクトを参照します。

インスタンスの オペランド・プロジェクト

control plane および IBM watsonx.ai のカスタム・リソースは、オペランド・プロジェクトにインストールされます。 アップグレード・コマンドで、${PROJECT_CPD_INST_OPERANDS} 環境変数はオペランド・プロジェクトを参照します。

このタスクをいつ完了する必要がありますか?

以下のオプションを確認して、このタスクを実行する必要があるかどうかを判別します。

  • IBM Software Hub control planeと 1 つ以上のサービスを同時にアップグレードする場合は、代わりにIBM Software Hub のインスタンスのアップグレードのプロセスに従ってください。
  • IBM Software Hub control planeのアップグレード時に IBM watsonx.ai をアップグレードしなかった場合は、このタスクを実行して IBM watsonx.ai をアップグレードします。

    必要に応じて繰り返します 複数の IBM Software Hubのインスタンスを担当している場合は、このタスクを繰り返して、クラスター上の IBM watsonx.ai のインスタンスをアップグレードできます。

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

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

バージョンの要件

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

環境変数
このタスクのコマンドでは環境変数を使用するため、記載されているとおりにコマンドを実行できます。
  • 環境変数を定義するスクリプトがない場合は、インストール環境変数の設定を参照してください。
  • スクリプトから環境変数を使用するには、このタスクでコマンドを実行する前に環境変数をsourceする必要があります。 例えば、以下のコマンドを実行します。
    source ./cpd_vars.sh
Common core services
IBM watsonx.ai requires the IBM Software Hub common core services.

common core servicesがインスタンスのオペランド・プロジェクトで正しいバージョンでない場合、IBM watsonx.aiをアップグレードすると、common core servicesは自動的にアップグレードされます。 common core services アップグレードでは、アップグレードの完了にかかる時間が長くなります。

始める前に

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

システム要件
このタスクでは、クラスターが IBM watsonx.aiの最小要件を満たしていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、『システム要件』を参照してください。
さらに、IBM watsonx.aiに適切なタイプと数の 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. IBM watsonx.ai ソフトウェア・イメージがプライベート・コンテナー・レジストリーにミラーリングされます。
    詳細情報の参照先
    このタスクが完了していない場合は、プライベート・コンテナー・レジストリーへのイメージのミラーリングを参照してください。
  2. cpd-cliは、プライベート・コンテナー・レジストリーから olm-utils-v4イメージをプルするように構成されています。
    詳細情報の参照先
    このタスクが完了していない場合は、プライベート・コンテナー・レジストリーからの olm-utils-v4 イメージのプルを参照してください。
GPU オペレーター
このタスクでは、GPU を使用するために必要なオペレーターがインストールされていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、GPU を必要とするサービスのオペレーターのインストールを参照してください。
Red Hat® OpenShift AI
このタスクでは、Red Hat OpenShift AI がインストールされていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、Red Hat OpenShift AI のインストールを参照してください。
クラスター・スコープ・リソース
このタスクでは、カスタム・リソース定義、クラスター役割、クラスター役割バインディングなどのクラスター・スコープのリソースが更新されていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、プラットフォームおよびサービスのクラスター・スコープ・リソースの更新を参照してください。
イメージ・プル・シークレット
このタスクでは、インスタンスのイメージ・プル資格情報を含むシークレットが存在することを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、IBM Software Hub のインスタンスのイメージ・プル・シークレットの作成を参照してください。

手順

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

  1. 5.3 へのアップグレード前の デプロイメント・モデルの除去
  2. アップグレードするコンポーネントの指定
  3. 異なるインストール・モードへのアップグレード
  4. サービスのアップグレード
  5. アップグレードの検証
  6. 次に行うこと

5.3 へのアップグレード前の デプロイメント・モデルの除去

caikit-1.0 (watsonx-cfm-caikit-1.0) を使用してモデルを実行している場合、バージョン 5.3 にアップグレードすると、これらのモデルは機能しなくなります。

アップグレードする前に、caikit1.0を使用してデプロイメントをすべて削除し、caikit1.1を使用してデプロイメントを新たに作成する必要があります (watsonx-cfm-caikit-1.1)。 これにより、バージョン 5.3 にアップグレードしたときにモデルが確実に機能するようになります。

別のインストール・モードへのアップグレード

IBM watsonx.aiのモードを別のモードにアップグレードする場合は、同じバージョンでのみアップグレードできます。

IBM watsonx.ai 軽量エンジンから完全IBM watsonx.ai・サービスにアップグレードする場合は、同じバージョン内でのみアップグレードできます。

インストール・モードをアップグレードするには、カスタム・リソース (CR) にアクセスし、IBM watsonx.ai と IBM watsonx.ai IFM CR の両方から lite_install: true フラグを削除します。

インストール・モードについて詳しくは、IBM watsonx.ai・インストール・モードの選択を参照してください。

アップグレードするコンポーネントの指定

watsonx.ai サービスをアップグレードするには、XAI_COMPONENT_TYPE 環境変数を watsonx_ai コンポーネントに設定します。

watsonx_ai コンポーネントは、クラスターにインストールされている基盤モデルを処理し、Prompt LabやTuning Studioなどのツールを使用できるようにする、コアwatsonx.ai機能をインストールします。

watsonx.ai サービスをアップグレードするには、XAI_COMPONENT_TYPE を以下のように設定します。
export XAI_COMPONENT_TYPE=watsonx_ai

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

IBM watsonx.aiをアップグレードするには、以下のようにします。

  1. cpd-cliをRed Hat OpenShift Container Platform・クラスターにログインします。
    ${CPDM_OC_LOGIN}
    注意: CPDM_OC_LOGIN は、cpd-cli manage login-to-ocp コマンドの別名です。
  2. IBM watsonx.aiのオペレーターとカスタム・リソースを更新します。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=${XAI_COMPONENT_TYPE} \
--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

アップグレードの検証

IBM watsonx.ai is upgraded when the install-components command returns:
[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=${XAI_COMPONENT_TYPE}

次のタスク

IBM watsonx.aiをアップグレードした後、新しいモデルをインストールできます。 詳しくは、IBM watsonx.aiへの基盤モデルの追加を参照してください。