バージョンから 5.2 バージョンへの watsonx Code Assistant for Z アップグレード 5.3

インスタンス管理者はバージョンから 5.2 バージョン watsonx Code Assistant for Z へアップグレード 5.3 できます。

誰がこのタスクを完了する必要があるのか？

インスタンス管理者 watsonx Code Assistant for Z インスタンス管理者である必要があります。 インスタンス管理者は、以下のプロジェクトのソフトウェアを管理する権限を持っています：

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

この watsonx Code Assistant for Z はoperatorsプロジェクトにインストールされている。 アップグレードコマンドでは、 ${PROJECT_CPD_INST_OPERATORS} 環境変数がオペレータプロジェクトを参照します。

インスタンス

control plane と watsonx Code Assistant for Z のカスタムリソースは、オペランドプロジェクトにインストールされています。 アップグレードコマンドでは、 ${PROJECT_CPD_INST_OPERANDS} 環境変数がオペランド・プロジェクトを参照します。

いつまでにこのタスクを完了させる必要がありますか？

以下のオプションを確認し、このタスクを完了する必要があるかどうかを判断する：

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

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

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

アップグレードの前に、以下の情報を確認してください。 watsonx Code Assistant for Z :

バージョンの要件

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

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

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

始める前に

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

システム要件
このタスクは、クラスタが以下の最小要件を満たしていることを前提とする。 watsonx Code Assistant for Z.
詳細情報の参照先
このタスクが完了していない場合は、 システム要件を参照してください。
さらに、適切な種類と数のGPUが用意されていることを確認 watsonx Code Assistant for Z してください。
詳細情報の参照先
このタスクが完了していない場合は、 GPU要件を参照してください。
ワークステーション
このタスクは、アップグレードを実行するワークステーションがクライアント ワークステーションとしてセットアップされており、以下のコマンドラインインター フェースを持っていることを前提としています：
  • IBM Software Hub CLI: cpd-cli
  • OpenShift® CLI: oc
  • Helm CLI: oc
詳細情報の参照先
このタスクが完了していない場合は、 クライアントワークステーションの更新を参照してください。
制御プレーン
このタスクは、 IBM Software Hub control plane がアップグレードされていることを前提とする。
詳細情報の参照先
このタスクが完了していない場合は、 IBM Software Hub のインスタンスのアップグレードを参照してください。
プライベート・コンテナー・レジストリー
環境でプライベート・コンテナ・レジストリを使用している場合（たとえば、クラスタがエアギャップされている場合）、このタスクは以下のタスクが完了していることを前提とします：
  1. ソフトウェア・イメージは watsonx Code Assistant for Z ソフトウェアイメージはプライベートコンテナレジストリにミラーリングされる。
    詳細情報の参照先
    このタスクが完了していない場合は、 プライベートコンテナレジストリへのイメージのミラーリングを参照してください。
  2. cpd-cli は、プライベート・コンテナ・レジストリから olm-utils-v4 イメージをプルするように設定されている。
    詳細情報の参照先
    このタスクが完了していない場合は、 「プライベートコンテナレジストリからイメージ olm-utils-v4 を取得する」 を参照してください。
GPUオペレーター
このタスクは、GPUを使用するために必要なオペレータがインストールされていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、 GPUを必要とするサービスのオペレータのインストールを参照してください。
Red Hat® OpenShift AI
このタスクは、 Red Hat OpenShift AI がインストールされていることを前提とする。
詳細情報の参照先
この作業が完了していない場合は、 Red Hat OpenShift AI のインストールを参照してください。

手順

アップグレードのために以下のタスクを完了します。 watsonx Code Assistant for Z :

  1. サービスのアップグレード
  2. アップグレードの検証
  3. 次に何をすべきか

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

アップグレード watsonx Code Assistant for Z :

  1. cpd-cli を Red Hat OpenShift Container Platform クラスタにログインする：
    ${CPDM_OC_LOGIN}
    注記： CPDM_OC_LOGIN は cpd-cli manage login-to-ocp コマンドのエイリアスである。
  2. オペレータとカスタムリソースを更新してください watsonx Code Assistant for Z。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z \
--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

アップグレードの検証

watsonx Code Assistant for Z は、 install-components コマンドが戻ってきたときにアップグレードされる：
[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=wca_z

次のタスク

watsonx Code Assistant for Z はすぐに使える。 はじめにについては watsonx Code Assistant for Z、 コード COBOL のリファクタリングと変換を参照してください。