watsonx Code Assistant for Z Agentic のインストール

インスタンス管理者は、IBM® Software Hub バージョン 5.3 に watsonx Code Assistant for Z Agentic をインストールできます。

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

インスタンス管理者 watsonx Code Assistant for Z Agenticをインストールするには、インスタンス管理者でなければなりません。 インスタンス管理者は、以下のプロジェクトにソフトウェアをインストールする権限を持っています。

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

watsonx Code Assistant for Z Agentic のこのインスタンスのオペレーターは、オペレーター・プロジェクトにインストールされます。

インストール・コマンドで、${PROJECT_CPD_INST_OPERATORS} 環境変数はオペレーター・プロジェクトを参照します。

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

control plane および watsonx Code Assistant for Z Agentic のカスタム・リソースは、オペランド・プロジェクトにインストールされます。

インストール・コマンドで、${PROJECT_CPD_INST_OPERANDS} 環境変数はオペランド・プロジェクトを参照します。

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

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

  • 複数のサービスを同時にインストールする場合は、代わりに ソリューションおよびサービスのバッチ・インストールの実行 のプロセスに従ってください。
  • バッチ・インストールの一部として watsonx Code Assistant for Z Agentic をインストールしなかった場合は、このタスクを実行して watsonx Code Assistant for Z Agentic をご使用の環境に追加します。

    必要に応じて繰り返します 複数のインスタンスの IBM Software Hubを担当している場合は、このタスクを繰り返して、クラスターに watsonx Code Assistant for Z Agentic のインスタンスをさらにインストールできます。

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

watsonx Code Assistant for Z Agentic をインストールする前に、以下の情報を確認してください。

バージョンの要件

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

環境変数

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

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

watsonx Code Assistant for Z Agentic は、デフォルトの Red Hat® OpenShift® Container Platform セキュリティー・コンテキスト制約 restricted-v2 で機能します。

Common core services

watsonx Code Assistant for Z AgenticにはIBM Software Hub common core servicesが必要です。

common core servicesがインスタンスのオペランド・プロジェクトにインストールされていない場合、watsonx Code Assistant for Zエージェントをインストールすると、common core servicesが自動的にインストールされます。 common core services をインストールすると、インストールの完了にかかる時間が長くなります。

ストレージ要件
watsonx Code Assistant for Z Agentic をインストールするときに、ストレージ・クラスを指定する必要があります。 以下のストレージ・クラスが推奨されます。 ただし、クラスターでこれらのストレージ・クラスを使用しない場合は、同等の定義を持つストレージ・クラスを指定してください。
ストレージ ノート ストレージ・クラス
OpenShift Data Foundation サービスをインストールするときに、ファイル・ストレージとブロック・ストレージを指定します。
  • ファイル・ストレージ: ocs-storagecluster-cephfs
  • ブロック・ストレージ: ocs-storagecluster-ceph-rbd
IBM Fusion Data Foundation サービスをインストールするときに、ファイル・ストレージとブロック・ストレージを指定します。
  • ファイル・ストレージ: ocs-storagecluster-cephfs
  • ブロック・ストレージ: ocs-storagecluster-ceph-rbd
IBM Fusion Global Data Platform サービスをインストールするときに、ファイル・ストレージとブロック・ストレージの両方に同じストレージ・クラスを指定します。
  • ファイル・ストレージ:

    以下のストレージ・クラスのいずれか。

    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
  • ブロック・ストレージ:

    以下のストレージ・クラスのいずれか。

    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
IBM Storage Scale Container Native サービスをインストールするときに、ファイル・ストレージとブロック・ストレージの両方に同じストレージ・クラスを指定します。
  • ファイル・ストレージ: ibm-spectrum-scale-sc
  • ブロック・ストレージ: ibm-spectrum-scale-sc
Portworx サービスをインストールするときに、--storage_vendor=portworx オプションにより、サービスは正しいストレージ・クラスを使用します。
  • ファイル・ストレージ: portworx-rwx-gp3-sc
  • ブロック・ストレージ:
    • portworx-couchdb-sc
    • portworx-elastic-sc
    • portworx-gp3-sc
NFS サービスをインストールするときに、ファイル・ストレージとブロック・ストレージの両方に同じストレージ・クラスを指定します。
  • ファイル・ストレージ: managed-nfs-storage
  • ブロック・ストレージ: managed-nfs-storage
Amazon Elasticストレージ
サービスをインストールするときに、以下を指定できます。
  • ファイル・ストレージのみ
  • ファイル・ストレージとブロック・ストレージ (推奨)

ファイル・ストレージは、Amazon Elastic File Systemによって提供されます。 ブロック・ストレージは、Amazon Elastic Block Storeによって提供されます。
  • ファイル・ストレージ: efs-nfs-client
  • ブロック・ストレージ:

    以下のストレージ・クラスのいずれか。

    • gp2-csi
    • gp3-csi
NetApp Trident サービスをインストールするときに、ファイル・ストレージとブロック・ストレージの両方に同じストレージ・クラスを指定します。
  • ファイル・ストレージ: ontap-nas
  • ブロック・ストレージ: ontap-nas
Nutanix サポートされていません。 該当なし。

始める前に

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

システム要件
このタスクでは、クラスターが watsonx Code Assistant for Z Agentic の最小要件を満たしていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、『システム要件』を参照してください。
ワークステーション
このタスクでは、インストールを実行するワークステーションがクライアント・ワークステーションとしてセットアップされており、以下のコマンド行インターフェースがあることを前提としています。
  • IBM Software Hub CLI: cpd-cli
  • OpenShift CLI: oc
  • Helm CLI: helm
詳細情報の参照先
このタスクが完了していない場合は、『クライアント・ワークステーションのセットアップ』を参照してください。 Setting up a client workstation
制御プレーン
このタスクでは、IBM Software Hub control planeがインストールされていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、IBM Software Hub のインスタンスのインストールを参照してください。
プライベート・コンテナー・レジストリー
ご使用の環境でプライベート・コンテナー・レジストリーを使用している場合 (例えば、クラスターがエアー・ギャップである場合)、このタスクでは以下のタスクが完了していることを前提としています。
  1. watsonx Code Assistant for Z Agentic ソフトウェア・イメージがプライベート・コンテナー・レジストリーにミラーリングされます。
    詳細情報の参照先
    このタスクが完了していない場合は、プライベート・コンテナー・レジストリーへのイメージのミラーリングを参照してください。
  2. cpd-cliは、プライベート・コンテナー・レジストリーから olm-utils-v4イメージをプルするように構成されています。
    詳細情報の参照先
    このタスクが完了していない場合は、プライベート・コンテナー・レジストリーからの olm-utils-v4 イメージのプルを参照してください。
ロード・バランサー
watsonx Code Assistant for Z Agentic 用にロード・バランサーのタイムアウト設定が調整されます。
詳細情報の参照先
このタスクが完了していない場合は、『ロード・バランサー設定の変更』を参照してください。
SMT 設定
Kernel-based Virtual Machine (KVM) 対応システムおよびビッグ・コア PowerVM対応システムの同時マルチスレッド化 (SMT) 設定が調整されます (該当する場合)。
詳細情報の参照先
このタスクが完了していない場合は、『電源の設定の変更』』を参照してください。Power
Red Hat OpenShift AI
このタスクでは、Red Hat OpenShift AI がインストールされていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、Red Hat OpenShift AI のインストールを参照してください。
Red Hat OpenShift AIを必要とする機能を使用する予定の場合、このタスクでは、Red Hat OpenShift AIがインストールされていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、Red Hat OpenShift AI のインストールを参照してください。
クラスター・スコープ・リソース
このタスクでは、カスタム・リソース定義、クラスター役割、クラスター役割バインディングなどのクラスター・スコープ・リソースが存在することを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、クラスター・スコープ・リソースの作成 (クラスター・スコープ・リソースの作成) (IBM Software Hub プラットフォームおよびサービス用)を参照してください。
イメージ・プル・シークレット
このタスクでは、インスタンスのイメージ・プル資格情報を含むシークレットが存在することを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、IBM Software Hub のインスタンスのイメージ・プル・シークレットの作成を参照してください。

前提条件サービス

watsonx Code Assistant for Z Agentic をインストールする前に、以下のサービスがインストールされ、実行されていることを確認してください。

手順

watsonx Code Assistant for Z Agentic をインストールするには、以下のタスクを実行します。

  1. サービスのインストール
  2. インストールの検証
  3. 次に行うこと

サービスのインストール

watsonx Code Assistant for Z Agentic をインストールするには、以下のようにします。

  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 Agenticのオペレーターとカスタム・リソースをインストールします。

    実行するコマンドは、クラスター上のストレージによって異なります。

    Red Hat OpenShift Data Foundation ストレージ 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Fusion Data Foundation ストレージ 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Fusion Global Data Platform ストレージ
    注意: IBM Fusion Global Data Platform ストレージを使用する場合、${STG_CLASS_BLOCK} と ${STG_CLASS_FILE} の両方が同じストレージ・クラス (通常は ibm-spectrum-scale-sc または ibm-storage-fusion-cp-sc) を指します。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Storage コンテナー・ネイティブ・ストレージのスケーリング
    注意: IBM Storage Scale Container Native ストレージを使用する場合、${STG_CLASS_BLOCK} と ${STG_CLASS_FILE} の両方が同じストレージ・クラス (通常は ibm-spectrum-scale-sc) を指します。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    Portworx ストレージ 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--storage_vendor=portworx \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    NFSストレージ
    注意: NFS ストレージを使用する場合、${STG_CLASS_BLOCK} と ${STG_CLASS_FILE} の両方が同じストレージ・クラス (通常は managed-nfs-storage) を指します。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    AWS ( EFS ストレージのみ)
    注意: EFS ストレージを使用する場合、${STG_CLASS_BLOCK} と ${STG_CLASS_FILE} の両方が同じストレージ・クラス (通常は efs-nfs-client) を指します。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    AWSとEFSおよびEBSストレージ 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    NetApp Trident
    注意: NetApp Trident ストレージを使用する場合、${STG_CLASS_BLOCK} と ${STG_CLASS_FILE} の両方が同じストレージ・クラス (通常は ontap-nas) を指します。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_agentic \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}

インストールの検証

watsonx Code Assistant for Z Agentic は、install-components コマンドが次のように戻るときにインストールされます。
[SUCCESS]... The install-components command ran successfully

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

次のタスク

これで、watsonx Code Assistant for Z Agentic の使用を開始できます。 詳しくは、Post-installation setup for watsonx Code Assistant for Z Agentic を参照してください。