从 watsonx.data 版本升级 5.2 到版本 5.3

实例管理员可以将系统 watsonx.data 从 5.2 版本升级至版本 5.3。

谁需要完成这项任务？

实例管理员要执行升级操作 watsonx.data ，您必须是实例管理员。 实例管理员有权限管理以下项目中的软件：

实例的操作员项目

此实例 watsonx.data 的操作符已安装在操作符项目中。 在升级命令中，环境变量 ${PROJECT_CPD_INST_OPERATORS} 指代操作员的项目。

实例的操作数项目

用于 和 control plane 的自定义 watsonx.data 资源已安装在 operands 项目中。 在升级命令中，环境变量 ${PROJECT_CPD_INST_OPERANDS} 指代操作数项目。

你需要在什么时候完成这项任务？

请查看以下选项，以确定您是否需要完成此任务：

  • 若需同时升级 实例 control planeIBM Software Hub 及一项或多项服务 Software HubIBM ，请改按《升级 实例》中的流程操作。
  • 若您在升级 watsonx.data 时未同步升级 IBM Software Hub control plane ，请完成此任务以升级 watsonx.data。

    根据需要重复此操作如果您负责管理多个实例 IBM Software Hub，可以重复此任务以升级集群 watsonx.data 中的更多实例。

完成此任务所需的信息

升级前请仔细阅读 watsonx.data 以下信息：

版本需求

与实例 IBM Software Hub 相关的所有组件必须安装在同一版本中。 例如，如果 处于版本 5.3.1 ， IBM Software Hubcontrol plane 则必须将 watsonx.data 升级至版本 5.3.1。

环境变量
本任务中的命令使用环境变量，因此您可以完全按照所写的命令运行。
  • 若您尚未拥有定义环境变量的脚本，请参阅 《设置安装环境变量》。
  • 要使用脚本中的环境变量，必须在本任务中运行命令之前加载这些环境变量。 例如，运行以下命令：
    source ./cpd_vars.sh

开始之前

此任务要求满足以下先决条件：

系统需求
此任务假定集群满足的最低要求 watsonx.data。
在何处查找更多信息
如果此任务尚未完成，请参阅系统要求。
此外，若您计划使用需要GPU的功能，请确保拥有适用于该功能的正确类型 watsonx.data 和数量的GPU。
在何处查找更多信息
如果此任务尚未完成，请参阅 GPU 要求。
工作站
此任务假定您将用于运行升级的工作站已配置为客户端工作站，并具备以下命令行界面：
  • IBM Software Hub 命令行界面： cpd-cli
  • OpenShift® 命令行界面： oc
  • Helm 命令行界面： oc
在何处查找更多信息
如果此任务尚未完成，请参阅更新客户端工作站。
控制平面
此任务假设 已升级 IBM Software Hubcontrol plane 。
在何处查找更多信息
如果此任务尚未完成，请参阅升级实例。 IBMSoftware Hub
专用容器注册表
如果您的环境使用私有容器注册表（例如，您的集群处于空气隔离状态），则此任务假定以下任务已完成：
  1. watsonx.data 软件镜像被镜像到私有容器注册表。
    在何处查找更多信息
    如果此任务尚未完成，请参阅《 将镜像镜像到私有容器注册表》。
  2. 该 cpd-cli 配置用于从私有容器注册表中拉取镜像 olm-utils-v4 。
    在何处查找更多信息
    如果此任务尚未完成，请参阅从私有容器注册表拉取 olm-utils-v4 镜像。
GPU操作员
若您计划使用需要GPU的功能，本任务将默认已安装使用GPU所需的操作员。
在何处查找更多信息
如果此任务尚未完成，请参阅 《为需要 GPU 的服务安装操作员》。
簇作用域资源
此任务假设集群范围资源（如自定义资源定义、集群角色和集群角色绑定）已完成更新。
在何处查找更多信息
如果此任务尚未完成，请参阅 《更新平台和服务的集群范围资源》。
映像提取私钥
此任务假设包含实例镜像拉取凭据的密钥已存在。
在何处查找更多信息
如果此任务尚未完成，请参阅 《为实例创建镜像拉取密钥 Software HubIBM 》。

过程

完成以下任务以升级 watsonx.data ：

  1. 服务升级
  2. 验证升级
  3. 下一步该做什么

升级服务

升级 watsonx.data ：

  1. 登录 cpd-cli 到集群 Red Hat® OpenShift Container Platform ：
    ${CPDM_OC_LOGIN}
    请记住： CPDM_OC_LOGIN 是一个别名，代表 命令 cpd-cli manage login-to-ocp 。
  2. 更新操作员和自定义资源。 watsonx.data
    cpd-cli manage install-components \
--license_acceptance=true \
--components=watsonx_data \
--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.data 当命令 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=watsonx_data

下一步操作

升级后，您需要更新 Presto 的 query.max-memory-per-node 属性。 memory.heap-headroom-per-node 确保这些属性的总值不超过可用堆内存。 有关在 watsonx.data™中自定义属性的更多信息，请参阅 《自定义组件》。

watsonx.data 已准备就绪，可立即使用。 要开始使用 watsonx.data ，请参阅 《开始使用》 watsonx.data。