升级前检查集群 IBM Software Hub 状态（从 5.1 版本升级至 5.3 版本）

该 IBM Software Hub 命令行界面包含一些命令，您可以在升级前使用这些命令来验证 IBM Software Hub集群的运行状况。

升级阶段

谁需要完成这项任务？

集群管理员此任务必须由集群管理员完成。

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

此任务为可选任务，但强烈建议完成。如果您在升级前未验证集群的健康状况， IBM Software Hub升级过程中可能会遇到问题。

根据需要重复此操作。如果您有多个实例， IBM Software Hub请针对每个计划升级的 IBM Software Hub 实例重复此操作。

开始之前

最佳实践：您可以直接按照本任务中的命令原样执行，并使用安装环境变量。请确保您已添加了 “更新环境变量”脚本中的新环境变量。

此外，请确保在执行本任务中的命令之前，已设置好环境变量。

在升级之前 IBM Software Hub，您可以运行以下命令来检查集群的运行状况：

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

运行以下 cluster 命令：

cpd-cli health cluster

请确认集群资源报告返回的结果是否符合预期：

测试	该测试的检测内容	预期结果
`Cluster Version Check`	该集群正在运行受支持的版本 Red Hat OpenShift Container Platform。	`[SUCCESS]`
`Image Registry Connectivity Test`	该集群可访问以下站点： `https://icr.io` `https://github.com/IBM` `https://mirror.openshift.com/pub` 注意：在受限网络中，此检查可能会失败。如果你从私有容器注册表中拉取镜像， `[FAIL]` 是一个可接受的结果。	`[SUCCESS]`
`Machine Config Pools Healthcheck`	机器配置池不是 `UPDATING` 或 `DEGRADED`。	`[SUCCESS]`
`Certificate Signing Request Healthcheck`	目前没有待处理的证书签名请求。如果存在待处理的证书签名请求，则检查将失败。	`[SKIP...]`
`Cluster Operator Healthcheck`	集群操作符是 `AVAILABLE` ，而不是 `DEGRADED`。	`[SUCCESS]`
`ETCD Healthcheck`	Kubernetesetcd 集群成员状态正常。	`[SUCCESS]`

运行以下 nodes 命令：

cpd-cli health nodes

请确认节点资源报告返回的结果与预期一致：

测试	该测试的检测内容	预期结果
`Node readiness`	集群节点是 `READY` 和，且未承受压力。	`[SUCCESS]`
`Node Resources Healthcheck`	每个节点的资源使用率均低于90%。	`[SUCCESS]`

运行该 network-performance 命令。

该集群从 IBM 的Entitled Registry中获取图像

cpd-cli health network-performance

提示：如果您计划在集群中的一部分节点上 IBM Software Hub 安装该软件，请指定该 --node-list 选项，以将测试范围限制在这些节点上。该选项的语法如下：

--node-list=<comma-separated
node-names>

节点名称之间请勿包含空格。

要获取节点名称列表，请运行：

oc get nodes -o custom-columns=NAME:.metadata.name --no-headers

该集群从私有容器注册表中拉取镜像

cpd-cli health network-performance \
--image-prefix=${PRIVATE_REGISTRY_LOCATION}/cpopen/cpd \
--image-tag=${VERSION}.${IMAGE_ARCH}

--node-list=<comma-separated
node-names>

节点名称之间请勿包含空格。

要获取节点名称列表，请运行：

oc get nodes -o custom-columns=NAME:.metadata.name --no-headers

请确认网络性能报告的摘要部分是否包含预期结果：

测试	该测试的检测内容	预期结果
`Node readiness check`	将要测试的节点是 `READY`. （默认情况下，所有节点都会被测试。）	`[SUCCESS]`
`Pod readiness check`	用于测试网络性能的 Pod 已准备就绪，且其容器正在运行。该命令 `ibm-network-performance-ds DaemonSet` 会在每个待测试的节点上创建一个 Pod。（默认情况下，所有节点都会被测试。）	`[SUCCESS]`
`Network throughput check`	网络吞吐量的下限为每秒至少 350 MB。	`[SUCCESS]`

运行该 network-connectivity 命令。

cpd-cli health network-connectivity \
--control_plane_ns=${PROJECT_CPD_INST_OPERANDS}

请确认网络连接报告的摘要部分是否包含预期结果：

测试	该测试的检测内容	预期结果
`Network Cluster Operator Healthcheck`	集群网络 OpenShift 运营商是 `AVAILABLE` ，而不是 `DEGRADED`。	`[SUCCESS]`
`Pod Healthcheck`	该项目 `openshift-ovn-kubernetes` 中的 pod 状态正常。	`[SUCCESS]`
`PodNetworkConnectivityCheck Custom Resource Healthcheck`	这些 `podnetworkconnectivitychecks` 对象是可访问的。	`[SUCCESS]`
`Operator To Operand Pod Connection check`	该实例的 “操作者”项目中的 Pod 可以连接到该实例的 “操作对象”项目中的 Pod。	`[SUCCESS]`