将 watsonx Orchestrate 从版本 5.2 升级至版本 5.3.0

完成此任务所需的信息

在升级 watsonx Orchestrate 之前，请查看以下信息：

版本需求

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

环境变量

本任务中的命令使用环境变量，因此您可以完全按照所写的命令运行。

• 若您尚未拥有定义环境变量的脚本，请参阅 《设置安装环境变量》。
• 要使用脚本中的环境变量，必须在本任务中运行命令之前加载这些环境变量。 例如，运行以下命令：

  source ./cpd_vars.sh

开始之前

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

系统需求

此任务假定集群满足 watsonx Orchestrate 的最低要求。

在何处查找更多信息
如果此任务尚未完成，请参阅系统要求。

此外，若您计划使用需要GPU的功能，请确保您的设备配备了适用于 watsonx Orchestrate 的正确类型和数量的GPU。

在何处查找更多信息
如果此任务尚未完成，请参阅 GPU 要求。

工作站

此任务假定您将用于运行升级的工作站已配置为客户端工作站，并具备以下命令行界面：

• IBM Software Hub 命令行界面： cpd-cli
• OpenShift® 命令行界面： oc
• Helm 命令行界面： oc

在何处查找更多信息
如果此任务尚未完成，请参阅更新客户端工作站。

控制平面

此任务假设 已升级 IBM Software Hubcontrol plane 。

在何处查找更多信息
如果此任务尚未完成，请参阅 《升级 IBM 实例》 Software Hub。

专用容器注册表

如果您的环境使用私有容器注册表（例如，您的集群处于空气隔离状态），则此任务假定以下任务已完成：

1. watsonx Orchestrate 软件镜像已同步至私有容器注册表。

   在何处查找更多信息
   如果此任务尚未完成，请参阅《 将镜像镜像到私有容器注册表》。

2. 该 cpd-cli 配置用于从私有容器注册表中拉取镜像 olm-utils-v4 。

   在何处查找更多信息
   如果此任务尚未完成，请参阅从私有容器注册表拉取 olm-utils-v4 镜像。

GPU操作员

若您计划使用需要GPU的功能，本任务将默认已安装使用GPU所需的操作员。

在何处查找更多信息
如果此任务尚未完成，请参阅 《为需要 GPU 的服务安装操作员》。

Red Hat® OpenShift AI

若您计划使用需要 Red Hat OpenShift AI的功能，本任务将默认 已 Red Hat OpenShift AI 安装。

在何处查找更多信息
如果此任务尚未完成，请参阅《 安装 Red Hat OpenShift AI 》。

Multicloud Object Gateway

此任务假设在需要时会 Multicloud Object Gateway 进行升级。

在何处查找更多信息
如果此任务尚未完成，请参阅 《升级多云对象网关》。

Red Hat OpenShift Serverless Knative Eventing

此任务假设以下任务已完成：

1. Red Hat OpenShift Serverless Knative Eventing 已升级

   在何处查找更多信息
   如果此任务尚未完成，请参阅 《安装 Red Hat OpenShift 无服务器Knative事件处理 》。

2. 该 IBM Events Operator 实例已完成升级。

   5.3.1 此任务仅在您升级至 5.3.1IBM Software Hub 或更高版本时才需要执行。 若您正在升级至 5.3.0IBM Software Hub 版本，请跳过此任务

   在何处查找更多信息
   如果此任务尚未完成，请参阅 《升级 IBM 事件操作员》。

簇作用域资源

此任务假设集群范围资源（如自定义资源定义、集群角色和集群角色绑定）已完成更新。

在何处查找更多信息
如果此任务尚未完成，请参阅 《更新平台和服务的集群范围资源》。

映像提取私钥

此任务假设包含实例镜像拉取凭据的密钥已存在。

在何处查找更多信息
如果此任务尚未完成，请参阅 《为 IBM 实例创建镜像拉取密钥 》 Software Hub。

过程

完成以下任务以升级 watsonx Orchestrate ：

1. 指定安装选项
2. 事件处理 操作员依赖性
3. 升级过程中问题的故障排除
4. 服务升级
5. 验证升级
6. 升级后的任务
7. 升级服务实例
8. 下一步该做什么

指定安装选项

在 IBM Software Hub 版本 5.3.0 中， watsonx Orchestrate 的默认行为是仅安装代理功能。

请参阅下表以确定是否需要指定安装选项：

从旧版本的代理技能助手模式升级

---
# ............................................................................
# watsonx Orchestrate parameters
# ............................................................................
non_olm:
  watsonxOrchestrate:
    installMode: "agentic_skills_assistant"  
    watsonxAI:
      watsonxaiifm: true

从旧版本的代理模式升级

---
# ............................................................................
# watsonx Orchestrate parameters
# ............................................................................
non_olm:
  watsonxOrchestrate: 
    watsonxAI:
      watsonxaiifm: true

事件处理 操作员依赖性

升级过程中问题的故障排除

升级服务

升级 watsonx Orchestrate ：

1. 登录 cpd-cli 到集群 Red Hat OpenShift Container Platform ：

   ${CPDM_OC_LOGIN}

   请记住： CPDM_OC_LOGIN 是一个别名，代表 命令 cpd-cli manage login-to-ocp 。
2. 更新 watsonx Orchestrate 的操作员和自定义资源。

   运行相应的命令来创建自定义资源。

   默认安装（无安装选项）

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=watsonx_orchestrate \
   --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 manage install-components \
   --license_acceptance=true \
   --components=watsonx_orchestrate \
   --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} \
   --param-file=/tmp/work/install-options.yml \
   --upgrade=true

验证升级

[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_orchestrate

升级后的任务

升级服务实例

当您升级 watsonx Orchestrate 时，服务实例会自动进行升级。

下一步操作