--- title: "升级 OCP - 安装部署工具 OBD V3.6.0 | OceanBase 文档中心" description: 升级 OCP 本文介绍如何通过 obd 的图形化界面操作升级 OCP。 前提条件 当前待升级 OCP 的版本需为 V4.0.3 或之后版本。 注意事项 升级通过 Docker 容器部署的 OCP 时，有如下注意事项： 需确认所有的 OCP 容器处于正常状态。若存在多个 OCP 容器，仅需保留一个 OCP 容器处于启动… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*Qq8pT6yBPTcAAAAAAAAAAAAADiGDAQ/original) 安装部署工具 OBDV 3.6.0 # 升级 OCP 更新时间：2026-01-15 16:40:37 [编辑](https://github.com/oceanbase/obd-doc/edit/V3.6.0/zh-CN/400.user-guide/200.ui-operations/800.update-ocp.md) 本文介绍如何通过 obd 的图形化界面操作升级 OCP。 ## 前提条件 当前待升级 OCP 的版本需为 V4.0.3 或之后版本。 ## 注意事项 升级通过 Docker 容器部署的 OCP 时，有如下注意事项： - 需确认所有的 OCP 容器处于正常状态。若存在多个 OCP 容器，仅需保留一个 OCP 容器处于启动状态，停止其他容器。 - 启动状态的 OCP 容器的名字里需包含 `ocp-all-in-one` 字段，若不包含需对容器进行重命名。 - 若原 Docker 部署的是多节点 OCP，升级后仍需要多节点，需要对 OCP 进行扩容操作。具体操作参见 [步骤三：扩容 OCP](#（可选）步骤三：扩容%20OCP)。 ## 操作步骤 #### 说明 obd 支持升级企业版和社区版 OCP，本节以升级社区版 OCP 为例介绍升级 OCP 的操作。 ### 步骤一：获取升级所需安装包 #### 说明 若待升级的 OCP 为 Docker 容器部署，ocp-all-in-one 包需下载并安装到启动状态的 OCP 容器中。 1. 下载安装包 访问 [OceanBase 软件下载中心](https://www.oceanbase.com/softwarecenter)，搜索 **OceanBase 云平台**，根据实际情况下载所需安装包，并将安装包上传至 obd 中控机器任一目录下。 若从下载中心无法获取所需版本安装包，可联系技术支持人员获取对应安装包。 2. 解压安装包 在安装包所在目录下，执行如下命令解压： ```shell [admin@test001 ~]$ tar -xzf ocp-all-in-one-*.tar.gz ``` 3. （可选）卸载原 obd 若机器中存在 obd 且该 obd 是通过 All in One 包安装，您可执行如下命令先卸载当前 obd。 ```shell [admin@test001 ~]$ cd ocp-all-in-one/bin && bash uninstall.sh ``` 4. 启动安装程序 在 ocp-all-in-one 安装目录的 `bin` 目录下执行 `install.sh` 脚本启动安装 obd 程序。 ```shell [admin@test001 bin]$ bash install.sh ``` 该脚本会安装 obd，并将安装目录下 `rpms` 目录中的所有安装包复制到 obd 的本地镜像库中，同时关闭远程镜像库。执行成功后输出如下，您可复制并执行输出中的 `source ~/.oceanbase-all-in-one/bin/env.sh` 命令以应用环境配置。 ```shell add auto set env logic to profile: /home/admin/.bash_profile ######################################################################################### Install Finished ========================================================================================= Setup Environment: source ~/.oceanbase-all-in-one/bin/env.sh Quick Start: obd demo Use Web Service to install: obd web Use Web Service to upgrade: obd web upgrade More Details: obd -h ========================================================================================= ``` ### 步骤二：升级 OCP 1. 启动升级 ```shell [admin@test001 ~]$ obd web upgrade ``` 输出如下，浏览器中访问输出中的 IP 地址即可进入升级向导页面，单击 **开始升级**。 ```shell start OBD WEB in 0.0.0.0:8680 please open http://10.10.10.1:8680/#/updateWelcome ``` #### 说明 - 白屏界面默认使用 8680 端口，您可使用 `obd web upgrade -p ` 命令指定端口。 - 在阿里云或其他云环境下，可能出现程序无法获取公网 IP，从而输出内网地址的情况，此 IP 非公网地址，您需要使用正确的地址访问白屏界面。 - `obd web` 命令绑定在 0.0.0.0 上，在多网卡部署的情况下，您可通过任意一个可访问的 IP 访问白屏界面。 2. 部署配置 在部署配置页面选择待升级的 OCP 集群，以及升级的目标版本。系统会自动获取已被 obd 管理的所有集群名称，您可在 **集群名称** 下拉列表选择需要升级的集群。若您需要升级的集群未被当前 obd 接管（如使用 Docker 部署的集群），此处可自定义集群名。当集群升级完成后，OBD 将自动接管对应 OCP 集群。 ![deploy](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V3.2.0/zh-CN/200.ui-operations/800.update-ocp-06.png) 设置完成后，单击 **下一步** 即可进入 **联通性测试** 页面。 3. 验证 MetaDB 联通性 升级使用 Docker 部署的 OCP 时，需手动填写 MetaDB 配置信息；若待升级 OCP 由 obd 管理，当前页面会自动获取 MetaDB 配置信息，您需检查 **连接信息** 部分内容是否与预期待升级环境一致。确认 MetaDB 连接信息无误后，输入 **访问密码** 并单击 **验证**，系统将校验 MetaDB 是否可成功连接。 ![metadb](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V3.2.0/zh-CN/200.ui-operations/800.update-ocp-07.png) 4. 配置操作系统用户 验证 MetaDB 联通性后，您需填写操作系统用户以便安装程序进行自动化配置。 ![user](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V3.2.0/zh-CN/200.ui-operations/800.update-ocp-08.png) | 参数 | 说明 | | --- | --- | | 用户名 | 需提供主机操作系统的用户以便安装程序进行自动化配置，该用户名需具有 sudo 权限。 | | 密码 | 需输入 **用户名** 的对应密码。当主机已设置免密时，可忽略此项配置。配置后可单击 **验证** 测试用户连通性。 | 配置完成后，单击 **下一步** 即可进入 **环境预检查** 页面。 5. 环境预检查 系统会根据 MetaDB 配置信息获取 OCP 相关配置信息，为保证管理功能一致性，升级程序将升级平台管理服务（COP Server）及其管理的所有主机代理服务（OCP Agent）。 确认 **安装配置** 及 **升级配置信息** 中的升级内容是否满足预期要求，若发现问题可单击 **上一步** 进行修改，确认无误后可单击 **预检查** 进行检查。 若检查通过，单击 **下一步** 即可开始升级 OCP；若检查失败，支持对失败项进行修复或忽略。 - 若选择修复，待修复完成后单击 **重新检查**，系统将重新执行环境预检查程序。 - 若选择忽略，单击 **忽略全部未通过项**，此时未通过的检查项 **检查状态** 将变更为 **已忽略**，可单击 **下一步** 开始升级 OCP。 #### 注意 忽略全部未通过项可能会导致升级失败，建议您修复检查失败项后再进行下一步。 ![check](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V3.2.0/zh-CN/200.ui-operations/800.update-ocp-12.png) 6. 升级 OCP OCP 升级过程中，您可以通过 **升级日志** 模块查看详细升级日志。 - 若 OCP 升级成功，可在 **升级日志** 中查看 OCP 登录信息，包括 URL、用户名及密码等。 - 若 OCP 升级失败，请查看日志信息获取失败原因，并联系技术支持同学进行处理。待定位安装失败问题原因且修复问题后，单击 **重新升级**，系统将重新执行失败的升级步骤。 #### 说明 升级 OCP 的过程会耗时较长，请您耐心等待。 ![upgrade](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V3.2.0/zh-CN/200.ui-operations/800.update-ocp-11.png) ### （可选）步骤三：扩容 OCP 1. 准备扩容所用配置文件 ```shell [admin@test001 ~]$ vim ocp-scale-out.yaml ``` 文件内容示例如下，servers.name 配置不能与原 OCP 集群中的重复： ```yaml ocp-server-ce: servers: - name: server2 ip: 10.10.10.2 - name: server3 ip: 10.10.10.3 server2: home_path: /home/admin/ocp soft_dir: /home/admin/ocp/software log_dir: /home/admin/ocp/logs port: 8080 memory_size: 8G server3: home_path: /home/admin/ocp soft_dir: /home/admin/ocp/software log_dir: /home/admin/ocp/logs port: 8080 memory_size: 8G ``` 2. 执行扩容 ```shell [admin@test001 ~]$ obd cluster scale_out myocp -c ocp-scale-out.yaml ``` 命令执行成功返回如下内容： ```shell Open ssh connection ok Get local repositories and plugins ok Repository integrity check ok Parameter check ok Open ssh connection ok Connect to observer 10.10.10.1:2881 ok Initializes observer work home ok Initializes obproxy work home ok Initializes ocp-server-ce work home ok ...... #省略部分输出 Check before start ocp-server-ce ok Start ocp-server-ce ok ocp-server-ce program health check ok Execute ` obd cluster display myocp ` to view the cluster status Trace ID: a1491fa6-991e-11f0-8809-00163e4692be If you want to view detailed obd logs, please run: obd display-trace a1491fa6-991e-11f0-8809-00163e4692be ``` 3. 验证扩容结果 复制并执行扩容命令输出中的 display 命令查看 OCP 集群信息。 ```shell obd cluster display myocp ``` 输出如下，包含新扩容进去的两个 OCP 节点： ```shell Get local repositories and plugins ok Open ssh connection ok Connect to ocp-server-ce ok +------------------------------------------------------------+ | ocp-server-ce | +---------------------------+----------+------------+--------+ | url | username | password | status | +---------------------------+----------+------------+--------+ | http://10.10.10.1:8080 | admin | '********' | active | | http://10.10.10.2:8080 | admin | '********' | active | | http://10.10.10.3:8080 | admin | '********' | active | +---------------------------+----------+------------+--------+ Connect to observer 10.10.10.1:2881 ok Wait for observer init ok +-------------------------------------------------+ | oceanbase-ce | +---------------+---------+------+-------+--------+ | ip | version | port | zone | status | +---------------+---------+------+-------+--------+ | 10.10.10.1 | 4.3.5.4 | 2881 | zone1 | ACTIVE | +---------------+---------+------+-------+--------+ obclient -h10.10.10.1 -P2881 -uroot@sys -p'********' -Doceanbase -A cluster unique id: 96617816-cfc9-5cd7-a43e-0c8327f32c23-1997aa9d887-04050304 Connect to obproxy ok +-------------------------------------------------------------------+ | obproxy-ce | +---------------+------+-----------------+-----------------+--------+ | ip | port | prometheus_port | rpc_listen_port | status | +---------------+------+-----------------+-----------------+--------+ | 10.10.10.1 | 2883 | 2884 | 2885 | active | +---------------+------+-----------------+-----------------+--------+ obclient -h10.10.10.1 -P2883 -uroot@proxysys -p'********' -Doceanbase -A obshell program health check ok display ob-dashboard ok +----------------------------------------------------------+ | ob-dashboard | +---------------------------+------+--------------+--------+ | url | user | password | status | +---------------------------+------+--------------+--------+ | http://10.10.10.1:2886 | root | '********' | active | +---------------------------+------+--------------+--------+ Trace ID: c25da2e0-9921-11f0-afb0-00163e4692be If you want to view detailed obd logs, please run: obd display-trace c25da2e0-9921-11f0-afb0-00163e4692be ``` ## 相关文档 OCP 的使用可参见官网 [OceanBase 云平台](https://www.oceanbase.com/docs/ocp) 文档。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线