IBM Software Hub (バージョン 5.3.x から新しいバージョン 5.3 リフレッシュへのアップグレード)

IBM Software Hubのインスタンスをアップグレードするには、インスタンスに必要なオペレーターとカスタム・リソースを格付けする必要があります。

アップグレード・フェーズ

クライアント・ワークステーションの更新
必要な情報の収集
制限付きネットワークでのアップグレードの実行の準備
プライベート・コンテナー・レジストリーからのアップグレードの実行の準備
前提ソフトウェアのアップグレード
共有クラスター・コンポーネントのアップグレード
インスタンスのアップグレードの準備
インスタンスのアップグレード
クラスターの更新

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

インスタンス管理者インスタンス管理者は、このタスクを実行できます。

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

必要に応じて繰り返しますクラスター上に IBM Software Hub のインスタンスが複数ある場合は、アップグレードするインスタンスごとにこのタスクを実行します。

始める前に

ベスト・プラクティス: このタスクのコマンドの多くは、インストール環境変数を使用して、記述されたとおりに正確に実行できます。環境変数スクリプトの更新で新しい環境変数を追加したことを確認します。

さらに、このタスクのコマンドを実行する前に、環境変数を必ず入手してください。

このタスクについて

cpd-cli manage install-components コマンドを使用して、IBM Software Hub のインスタンスに必要なオペレーターとカスタム・リソースをアップグレードします。

注: このトピックの install-components コマンドには、--run_storage_tests オプションが含まれています。 --run_storage_tests オプションを指定してコマンドを実行し、ご使用の環境のストレージがパフォーマンスの最小要件を満たしていることを確認することを強くお勧めします。

ストレージが最小要件を満たしていない場合は、--run_storage_tests オプションを削除してアップグレードを続行できます。ただし、ご使用の環境では、ストレージの問題が原因で問題が発生する可能性があります。

手順

ログに記録するcpd-cliにRed Hat® OpenShift® Container Platformクラスター：
```
${CPDM_OC_LOGIN}
```
注意: CPDM_OC_LOGIN は、cpd-cli manage login-to-ocp コマンドの別名です。

インストールする予定のソフトウェアのライセンス条項を確認します。

ライセンスはオンラインで入手できます。ただし、一部のライセンスは get-license コマンドに含まれていません。購入したライセンスが表示されない場合は、IBM Terms でライセンスを検索できます。

使用可能なすべてのライセンス URL を表示

cpd-cli manage get-license \
--release=${VERSION}

特定のライセンスについては、URLを参照してください

購入したライセンスに基づいて、適切なコマンドを実行します。

IBM Cloud Pak for Data Enterprise Edition

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=EE

IBM Cloud Pak for Data Standard Edition

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=SE

IBM Data Gate watsonxのための

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=DGWXD

IBM Data Product Hub カートリッジ

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=DPH

Data Replication

購入したライセンスに応じて、以下の適切なコマンドを実行します。

IBM Data Replication Cartridge

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IDRC

IBM InfoSphere® Data Replication Cartridge

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IIDRC

IBM Data Replication Modernization

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IDRM

IBM InfoSphere Data Replication Modernization

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IIDRM

IBM Data Replication for Db2® z/OS® Cartridge

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IDRZOS

IBM InfoSphere Data Replication for watsonx.data™ Cartridge

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IIDRWXTO

IBM InfoSphere Data Replication Cartridge Add-on for IBM watsonx.data

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IIDRWXAO

Db2

購入したライセンスに応じて、以下の適切なコマンドを実行します。

IBM Db2 Standard Edition Cartridge for IBM Cloud Pak for Data

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=DB2SE

IBM Db2 Advanced Edition Cartridge for IBM Cloud Pak for Data

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=DB2AE

IBM Knowledge Catalog Premium

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IKCP

IBM Knowledge Catalog Standard

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=IKCS

IBM watsonx.ai

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=WXAI

IBM watsonx Code Assistant

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=WCA

IBM watsonx Code Assistant Ansibleのための

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=WCAA

IBM watsonx.data

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=WXD

IBM watsonx.data Premium Edition

cpd-cli manage get-license \
--release=${VERSION} \
--license_types=WXDP

インスタンスに必要なオペレーターとカスタム・リソースをアップグレードします。

ヒント: このコマンドをクラスターに対して実行する前に、--preview=true オプションを指定してコマンドを実行することにより、このコマンドがユーザーに代わって発行する oc コマンドをプレビューすることができます。

oc コマンドは、work ディレクトリーの preview.sh ファイルに保存されます。

実行するコマンドは、インスタンスに連結プロジェクトが含まれているかどうかによって異なります。

連結プロジェクトのないインスタンス

cpd-cli manage install-components \
--license_acceptance=true \
--components=cpd_platform \
--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} \
--run_storage_tests=true \
--upgrade=true

連結プロジェクトを持つインスタンス

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

cpd-cliが次のメッセージを返すまで待ってから、次のステップに進みます。

[SUCCESS] ... install-components コマンドは正常に実行されました。

zen ポッドまたは IBM Cloud Pak foundational services ポッドにパッチを適用するカスタム RSI パッチがある場合は、パッチを再適用します。
1. 以下のコマンドを実行して、オペランド・プロジェクト内の RSI パッチのリストを取得します。
```
cpd-cli manage get-rsi-patch-info \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--all
```
2. zen ポッドまたは IBM Cloud Pak foundational services ポッドに適用されるパッチがある場合は、以下のコマンドを実行してカスタム・パッチを適用します。
```
cpd-cli manage apply-rsi-patches \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS}
```
オプション: インスタンスにインストールされているサービスのバッチ・アップグレードを実行する場合は、install-components コマンドを実行します。
ヒント: このコマンドをクラスターに対して実行する前に、--preview=true オプションを指定してコマンドを実行することにより、このコマンドがユーザーに代わって発行する oc コマンドをプレビューすることができます。
oc コマンドは、work ディレクトリーの preview.sh ファイルに保存されます。
```
cpd-cli manage install-components \
--license_acceptance=true \
--components=${COMPONENTS} \
--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が次のメッセージを返すまで待ってから、次のステップに進みます。
```
[SUCCESS] ... install-components コマンドは正常に実行されました。
```

オペランドの状況が Completed であることを確認します。

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

operators プロジェクト内のリソースの正常性を確認します。

cpd-cli health operators \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--control_plane_ns=${PROJECT_CPD_INST_OPERANDS}

ヘルス・チェック・レポートが予期した結果を返すことを確認します。

テスト	テストの検査内容	期待される結果
`Pod Healthcheck`	operators プロジェクト内のポッドの場合、各必須ポッドの状況は `Running` です。	`[SUCCESS]`
`Pod Usage Healthcheck`	operators プロジェクト内のポッドの場合、各ポッドのリソース使用量は CPU およびメモリーの制限内に収まっています。	`[SUCCESS]`
`Cluster Service Versions Healthcheck`	オペレーター・プロジェクト内のクラスター・サービス・バージョン (CSV) の場合、各 CSV のフェーズは `Succeeded` です。	`[SUCCESS]`
`Catalog Source Healthcheck`	オペレーター・プロジェクト内のカタログ・ソースの場合、各カタログ・ソースの最後に監視された状態は `Ready` です。	`[SUCCESS]`
`Install Plan Healthcheck`	オペレーター・プロジェクト内のオペレーターの場合、各オペレーターのインストール計画の承認は `Automatic` です。	`[SUCCESS]`
`Subscriptions Healthchec`	オペレーター・プロジェクト内のサブスクリプションの場合、サブスクリプションごとにインストール済みの CSV があります。	`[SUCCESS]`
`Persistent Volume Claim Healthcheck`	オペレーター・プロジェクト内の永続ボリューム要求 (PVC) では、各 PVC がバインドされます。注: オペレーター・プロジェクトに PVC が存在してはならないため、テストをスキップする必要があります。	`[SKIP...]`
`Deployment Healthcheck`	オペレーター・プロジェクト内のデプロイメントの場合、各デプロイメントには、必要な数のレプリカがあります。	`[SUCCESS]`
`Namespace Scopes Healthcheck`	operators プロジェクト内の `NamespaceScope` オペレーターについて、`members` リストに指定されているプロジェクトが存在します。	`[SUCCESS]`
`Stateful Set Healthcheck`	オペレーター・プロジェクト内のステートフル・セットの場合、ステートフル・セットには必要な数のレプリカがあります。注: オペレーター・プロジェクトにはステートフル・セットが存在しないはずであるため、テストをスキップする必要があります。	`[SKIP...]`
`Common Services Healthcheck`	operators プロジェクト内の `common-service commonservice` カスタム・リソースの場合、カスタム・リソースのフェーズは `Succeeded` です。	`[SUCCESS]`
`Custom Resource Healthcheck`	オペレーター・プロジェクト内のその他のカスタム・リソースの場合、各カスタム・リソースのフェーズは `Succeeded` です。注: オペレーター・プロジェクトには他のカスタム・リソースがないはずなので、テストをスキップする必要があります。	`[SKIP...]`
`Operand Requests Healthcheck`	オペレーター・プロジェクト内のオペランド要求の場合、各オペランド要求のフェーズは `Running`、	`[SUCCESS]`

オペランド・プロジェクト内のリソースの正常性を確認します。

cpd-cli health operands \
--control_plane_ns=${PROJECT_CPD_INST_OPERANDS}

ヘルス・チェック・レポートが予期した結果を返すことを確認します。

テスト	テストの検査内容	期待される結果
`Pod Healthcheck`	オペランド・プロジェクト内のポッドの場合、各ポッドの状況は `Running` です。	`[SUCCESS]`
`Pod Usage Healthcheck`	オペランド・プロジェクト内のポッドの場合、各ポッドのリソース使用量は CPU およびメモリーの制限内に収まります。	`[SUCCESS]`
`EDB Cluster Healthcheck`	オペランド・プロジェクト内の EDB Postgres クラスターの場合、各クラスターの状況は `Cluster in healthy state` です。	`[SUCCESS]`
`Persistent Volume Claim Healthcheck`	オペランド・プロジェクト内の永続ボリューム要求 (PVC) の場合、各 PVC はバインドされます。	`[SUCCESS]`
`Deployment Healthcheck`	オペランド・プロジェクト内のデプロイメントの場合、各デプロイメントには、必要な数のレプリカがあります。	`[SUCCESS]`
`Stateful Set Healthcheck`	オペランド・プロジェクト内のステートフル・セットの場合、ステートフル・セットには必要な数のレプリカがあります。	`[SUCCESS]`
`Common Services Healthcheck`	オペランド・プロジェクト内の `common-service commonservice` カスタム・リソースの場合、カスタム・リソースのフェーズは `Succeeded` です。	`[SUCCESS]`
`Operand Requests Healthcheck`	オペランド・プロジェクト内のオペランド要求の場合、各オペランド要求のフェーズは `Running` です。	`[SUCCESS]`
`Monitor Events Healthcheck`	プラットフォーム・モニターが`Critical`イベントを生成していません。	`[SUCCESS]`
`Custom Resource Healthcheck`	オペランド・プロジェクト内のカスタム・リソースの場合、各カスタム・リソースのフェーズは `Succeeded` です。	`[SUCCESS]`
`Platform Healthcheck`	必要なプラットフォーム・マイクロサービスのポッドが `Running`されていること。	`[SUCCESS]`

次のタスク

cpdbr サービスを使用して IBM Software Hubをバックアップする場合は、cpdbr サービスの更新 (バージョン 5.3.x からそれ以降のバージョン 5.3 リフレッシュへのアップグレード) を参照してください。

cpdbr サービスを使用しない場合、次のステップは、アップグレードしたコンポーネントによって異なります。

IBM Software Hub control planeおよびサービス

IBM Software Hub control planeとインスタンス内のサービスをアップグレードした場合:

IBM Software Hub control plane のみ

IBM Software Hub control planeのみをアップグレードした場合:

IBM Software Hub 構成アドミッション・コントローラー・Webhook のアップグレード (バージョン 5.3.x から後続バージョン 5.3 リフレッシュへのアップグレード) を確認します。
インスタンス内のサービスをアップグレードします。詳しくは、サービスを参照してください。