升级 OCP Express

更新时间：2026-04-14 17:55:47

编辑

本文介绍如何通过 obd 黑屏命令行升级 OCP Express。

说明

目前仅支持通过 obd 黑屏命令行方式升级 OCP Express。

前提条件

请确保您已部署 OCP Express。
obd 需为 V2.1.0 及以上版本，若 OCP Express 目标版本为 V4.2.1 及以上版本，obd 至少需为 V2.3.1。
若 OCP Express 目标版本为 V4.2.1 及以上版本，OBAgent 需为 V4.2.1 及以上版本。

获取 OCP Express hash 值

升级 OCP Express 前您需知道升级的目标版本的 hash 值，可根据自身机器情况选择如下两种方式中任意一种获取 hash 值。

在线获取

离线获取

如果您的机器可以连接公网，可以通过升级 obd 后利用 obd 获取远程资源。参考如下步骤。

执行如下命令开启远程镜像仓库
```
obd mirror enable remote
```
执行如下命令升级 obd 到最新版本
```
obd update
```
执行如下命令查看 obd 版本，验证是否升级成功
```
obd --version
```

执行如下命令查询远程镜像仓库中 OCP Express 版本

obd mirror list oceanbase.community.stable|grep ocp-express

输出如下，最后一列字符串即为 OCP Express 对应版本的 hash 值。

| ocp-express                       | 1.0.0   | 100000432023032015.el7 | x86_64 | c6156b6676746d697e0bb46b50a062ce188cb76f2f95f1fd4d6ac14dd8d71f76 |
| ocp-express                       | 1.0.0   | 100000452023041914.el7 | x86_64 | a70d09919bcbad065270e8ff3984ef18c332c2f5983b756fc55956ce910f7d2d |

当您的机器无法连接网络时，您可通过下载 all-in-one 安装包升级 obd 并获取资源，需下载 V4.1.0_CE BP1 及以上版本 all-in-one 安装包，具体步骤如下。

下载 all-in-one 安装包

从 OceanBase 软件下载中心下载 all-in-one 安装包，并将其复制到中控机中，推荐下载最新版本的安装包。
在安装包所在目录下执行如下命令解压并安装
注意
- 您需使用部署 OCP Express 时所用的主机账号（比如 admin）安装 all-in-one 安装包。
- 若您之前已安装过 all-in-one 安装包，推荐下载解压后通过 upgrade.sh 脚本升级 obd，即将下述代码块中的 ./install.sh 命令替换为 ./upgrade.sh 命令。
```
[admin@test001 ~]$ tar -xzf oceanbase-all-in-one-*.tar.gz
[admin@test001 ~]$ cd oceanbase-all-in-one/bin/
[admin@test001 bin]$ ./install.sh
[admin@test001 bin]$ source ~/.oceanbase-all-in-one/bin/env.sh
```

执行如下命令查询本地镜像仓库中 OCP Express 版本

obd mirror list local

输出如下，最后一列字符串即为 OCP Express 对应版本的 hash 值。

| ocp-express       | 1.0.0   | 100000432023032015.el7 | x86_64 | 42c6fc921063f24f9e1072d75bfa7f21f42146e3 |
| ocp-express       | 1.0.0   | 100000452023041914.el7 | x86_64 | 5b29837dc1f575c7d1840ab8e59064ddd407bd4b |

升级 OCP Express

同版本升级

跨版本升级

OCP Express 同版本升级可通过 obd cluster reinstall 命令，详情请参见集群命令组中 obd cluster reinstall 命令介绍。

通过上面的任意一种方式获取到 ocp-express 组件的 hash 值（md5）后执行如下命令进行升级安装，此处以部署名为 obtest 为例。

obd cluster reinstall obtest -c ocp-express --hash=a70d09919bcbad065270e8ff3984ef18c332c2f5983b756fc55956ce910f7d2d

OCP Express 跨版本升级可通过 obd cluster upgrade 命令，详情请参见集群命令组中 obd cluster upgrade 命令介绍。

通过上面的任意一种方式获取到 ocp-express 组件的 hash 值（md5）后执行如下命令进行升级安装。

obd cluster upgrade <deploy name> -V <version> -c ocp-express --usable=<hash>

验证

OCP Express 升级后的登录账号密码与升级前相同。登录后查看帮助 -> 关于 ocp express，查看版本号与发布日期即可验证是否已升级到目标版本。

升级 OCP Express

说明

前提条件

获取 OCP Express hash 值

注意

升级 OCP Express

验证