升级 IBM Cloud Pak for Data (从 V 4.7.x 升级到更高版本 4.7 刷新)

重要信息： IBM Cloud Pak for Data 4.7 版本将于 2025 年 7 月 31 日结束支持 (EOS)。欲了解更多信息，请参阅 IBM Cloud Pak for Data 版本 4.X 的停止服务公告。

在 IBM Cloud Pak for Data 4.7 版本支持结束之前，升级到 IBM Software Hub 5.1 版本。更多信息，请参阅 IBM Software Hub 版本 5.1 文档中的升级 IBM Software Hub。

升级实例的 IBM Cloud Pak foundational services 后，可以升级 IBM Cloud Pak for Data control plane 和服务。

升级阶段: 更新客户端工作站; 收集所需信息; 准备从专用容器注册表运行升级; 升级共享群集组件; 升级 Cloud Pak for Data
谁需要完成此任务?: 实例管理员实例管理员可以完成此任务。
何时需要完成此任务?: 根据需要重复如果集群上具有多个 Cloud Pak for Data 实例，那么针对要升级的每个实例执行此任务。

准备工作

最佳实践: 您可以完全按照使用安装环境变量编写的那样运行此任务中的命令。

如果已升级到 V 4.7，请确保已从更新环境变量脚本添加新环境变量。
如果已安装 V 4.7，请参阅设置安装环境变量

此外，请确保在运行此任务中的命令之前，先确定环境变量的来源。

关于本任务

您可以选择是否要执行以下操作:

在升级实例中的服务之前升级 Cloud Pak for Data control plane
同时升级 Cloud Pak for Data control plane 和服务。

请记住: 实例中的所有软件都必须安装在同一版本上。

运行 cpd-cli manage apply-olm 命令时，实例中的所有操作程序都将升级到同一版本。

过程

运行 cpd-cli manage login-to-ocp 命令，以具有足够许可权的用户身份登录到集群以完成此任务。例如:
```
cpd-cli manage login-to-ocp \
--username=${OCP_USERNAME} \
--password=${OCP_PASSWORD} \
--server=${OCP_URL}
```
提示: login-to-ocp 命令采用与 oc login 命令相同的输入。运行 oc login --help 以获取详细信息。
查看 Cloud Pak for Data的许可条款。
Cloud Pak for Data 许可证以联机方式提供。运行相应的命令，获取您的许可证的 URL ：
Enterprise Edition
```
cpd-cli manage get-license \
--release=${VERSION} \
--license-type=EE
```
Standard Edition
```
cpd-cli manage get-license \
--release=${VERSION} \
--license-type=SE
```
升级实例的操作程序项目中的操作程序。

提示: 在对集群运行此命令之前，可以通过运行带有 --preview=true 选项的命令来预览此命令将代表您发出的 oc 命令。
oc 命令将保存到 work 目录中的 preview.sh 文件。
以下命令将升级操作程序项目中的所有操作程序。
```
cpd-cli manage apply-olm \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--upgrade=true
```
等待 cpd-cli 返回以下消息，然后继续执行下一步:
```
[成功] ... apply-olm 命令成功运行。
```
如果 apply-olm 命令失败，请参阅安装或升级期间应用-olm 命令的故障排除。

确认操作程序 pod 为 Running 或 Copmleted:

oc get pods --namespace=${PROJECT_CPD_INST_OPERATORS}

升级实例的操作数项目中的操作数。

提示: 在对集群运行此命令之前，可以通过运行带有 --preview=true 选项的命令来预览此命令将代表您发出的 oc 命令。

oc 命令将保存到 work 目录中的 preview.sh 文件。

您运行的命令取决于集群上的存储器:

Red Hat OpenShift Data Foundation 存储器

为指定的组件创建定制资源。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

IBM Storage FusionData Foundation 存储

为指定的组件创建定制资源。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

IBM Storage Fusion全球数据平台存储

为指定的组件创建定制资源。

使用 IBM Storage Fusion 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ibm-spectrum-scale-sc。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

IBM Storage Scale Container 本机存储器

为指定的组件创建定制资源。

使用 IBM Storage Scale Container Native 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ibm-spectrum-scale-sc。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Portworx 存储器

为指定的组件创建定制资源。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--storage_vendor=portworx \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--storage_vendor=portworx \
--license_acceptance=true \
--upgrade=true|false

NFS 存储器

使用 IBM Storage Scale Container Native 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 managed-nfs-storage。

为指定的组件创建定制资源。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

仅 AWS EFS 存储器

为指定的组件创建定制资源。

仅使用 EFS 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类 (通常为 efs-nfs-client)。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

AWS EFS 和 EBS 存储器

为指定的组件创建定制资源。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

NetApp Trident

为指定的组件创建定制资源。

使用 NetApp Trident 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ontap-nas。

Cloud Pak for Data control plane 和服务

缺省情况下， apply-cr 会同时升级到 4 组件。您可以通过指定 --parallel_num 选项来调整此设置。

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

Cloud Pak for Data control plane仅

cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--upgrade=true

等待 cpd-cli 返回以下消息，然后继续执行下一步:

[成功] ... apply-cr 命令成功运行。

确认操作数的状态为 Completed:

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

下一步操作

后续步骤取决于您升级的组件:

Cloud Pak for Data control plane 和服务: 如果升级了 Cloud Pak for Data control plane 和实例中的服务，请参阅安装或升级后设置服务。
Cloud Pak for Data control plane仅: 如果仅升级了 Cloud Pak for Data control plane，那么必须升级实例中的服务。有关更多信息，请参阅服务。