从 Informix 版本升级 5.1 到版本 5.3

实例管理员可以将系统 Informix 从 5.1 版本升级至版本 5.3。

谁需要完成这项任务？

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

实例的操作员项目: 此实例 Informix 的操作符已安装在操作符项目中。在升级命令中，环境变量 ${PROJECT_CPD_INST_OPERATORS} 指代操作员的项目。
实例的操作数项目: 用于和 control plane 的自定义 Informix 资源已安装在 operands 项目中。在升级命令中，环境变量 ${PROJECT_CPD_INST_OPERANDS} 指代操作数项目。

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

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

若需同时升级实例 control planeIBM Software Hub 及一项或多项服务 Software HubIBM ，请改按《升级实例》中的流程操作。
若您在升级 Informix 时未同步升级 IBM Software Hub control plane ，请完成此任务以升级 Informix。
根据需要重复此操作如果您负责管理多个实例 IBM Software Hub，可以重复此任务以升级集群 Informix 中的更多实例。

完成此任务所需的信息

升级前请仔细阅读 Informix 以下信息：

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

环境变量

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

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

开始之前

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

系统需求

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

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

工作站

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

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

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

控制平面

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

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

专用容器注册表

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

Informix 软件镜像被镜像到私有容器注册表。
在何处查找更多信息

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

如果此任务尚未完成，请参阅从私有容器注册表拉取镜像 olm-utils-v4。

簇作用域资源

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

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

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

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

映像提取私钥

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

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

过程

完成以下任务以升级 Informix ：

服务升级
验证升级
升级现有服务实例
下一步该做什么

升级服务

升级 Informix ：

登录 cpd-cli 到集群 Red Hat® OpenShift Container Platform ：
```
${CPDM_OC_LOGIN}
```
请记住： CPDM_OC_LOGIN 是一个别名，代表命令 cpd-cli manage login-to-ocp 。

更新操作员和自定义资源。 Informix

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

验证升级

Informix 当命令 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=informix_cp4d

升级现有的服务实例

升级后 Informix ，必须升级与之关联 Informix 的所有服务实例。

要升级服务实例：

获取服务 Informix 实例列表：

cpd-cli service-instance list \
--service-type=informix \
--profile=${CPD_PROFILE_NAME}

将 INSTANCE_NAME 环境变量设置为要升级的服务实例名称：
```
export INSTANCE_NAME=<instance-name>
```
设置 INSTANCE_VERSION 环境变量：
```
export INSTANCE_VERSION=${VERSION}
```
将 INSTANCE_VERSION 环境变量设置 IBM Software Hub 为与集群中版本对应的版本：
```
export INSTANCE_VERSION=<version>
```
请使用下表确定相应的数值：
IBM Software Hub 版本服务实例版本

5.3.1 10.1.0

5.3.0 10.0.0

IBM Software Hub 版本	服务实例版本
5.3.1	10.1.0
5.3.0	10.0.0

升级服务实例：

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

重复上述步骤，以升级与该实例关联的每个 IBM Software Hub服务实例。