将 watsonx BI 从 5.2 版本升级至 5.3 版本

完成此任务所需的信息

在升级 watsonx BI 之前，请仔细阅读以下信息：

版本需求

与某个实例相关的 IBM Software Hub 所有组件必须安装在同一版本中。 例如，如果当前版本 control planeIBM Software Hub 为 5.3.1 ，则必须将 watsonx BI 升级至 5.3.1。

环境变量

本任务中的命令使用了环境变量，因此您可以直接按原样运行这些命令。

• 如果您没有定义环境变量的脚本，请参阅“设置安装环境变量”。
• 若要在脚本中使用环境变量，必须在执行本任务中的命令之前加载环境变量。 例如，运行以下命令：

  source ./cpd_vars.sh

Common core services

watsonx BI 需要 IBM Software Hubcommon core services 。

如果该实例的 operands common core services 项目中的 版本不正确，则在升级 watsonx BI 时， common core services 将自动升级。 此次 common core services 升级会延长升级所需的时间。

开始之前

本任务假设已满足以下先决条件：

系统需求

此任务假设该集群满足 watsonx BI 的最低要求。

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

此外，请确保您为 watsonx BI 配备了类型和数量均合适的GPU。

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

工作站

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

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

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

控制平面

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

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

专用容器注册表

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

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

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

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

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

GPU 操作员

此任务假设已安装使用 GPU 所需的操作程序。

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

Red Hat® OpenShift AI

本任务假设已 Red Hat OpenShift AI 安装。

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

集群范围内的资源

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

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

映像提取私钥

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

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

必备服务

在升级 watsonx BI 之前，请确保以下服务已升级并正在运行：

• IBM Software Hub

  oc patch zenservice lite-cr -n cpd-instance --type=merge -p '{"spec": {"version": "6.2.2", "zen_pak_version": "6.2.2"}}'

• watsonx.data™ intelligence

  • 您必须修改 watsonx.data intelligence CR 才能启用 GPU 模型。

    要启用 GPU 模型，请运行以下命令：

    oc patch watsonxdataintelligence watsonxdataintelligence-cr -n "${PROJECT_CPD_INST_OPERANDS}" --type='json' -p='[{"op": "replace", "path": "/spec/enableModelsOn", "value": "gpu"},{"op": "replace", "path": "/spec/enableSemanticEmbedding", "value":true}]'

• watsonx.ai™ 嵌入式模型 ibm-slate-30m-english-rtrvr
  • 要安装嵌入式 ibm-slate-30m-english-rtrvr 模型，请运行以下命令：

    oc patch Watsonxaiifm watsonxaiifm-cr -n "${PROJECT_CPD_INST_OPERANDS}" --type=json -p '[{"op": "add", "path": "/spec/install_model_list/", "value": "ibm-slate-30m-english-rtrvr"}]'

过程

请完成以下任务以升级 watsonx BI ：

1. 升级服务
2. 验证升级
3. 升级服务实例
4. 接下来该做什么

升级服务

要升级 watsonx BI ：

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

   ${CPDM_OC_LOGIN}

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

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=watsonx_bi_assistant \
   --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

验证升级

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

升级服务实例

升级 watsonx BI 后，您必须升级与 watsonx BI 关联的服务实例。

开始之前

在用于升级服务实例的工作站上创建一个配置文件。

该配置文件必须关联到具有以下任一权限的用户 IBM Software Hub ：

• 创建服务实例 (can_provision)
• 管理服务实例 (manage_service_instances)

如需更多信息，请参阅“创建配置文件以使用 cpd-cli 管理命令”。

过程

要升级服务实例：

1. 将 INSTANCE_VERSION 环境变量设置为与您集群中 IBM Software Hub 的版本相对应的版本：

   export INSTANCE_VERSION=<version>

   请参考下表确定合适的数值：

   IBM Software Hub 版本	服务实例版本
   5.3.1	3.4.0
   5.3.0	3.3.0

2. 升级服务实例：

   cpd-cli service-instance upgrade \
   --service-type=watsonx-bi-assistant \
   --instance-name=${INSTANCE_NAME} \
   --profile=${CPD_PROFILE_NAME} \
   --version=${INSTANCE_VERSION}

下一步操作

在使用 watsonx BI 版本 3.3.0 之前，您必须完成 watsonx BI 的升级后设置。