使用图形化界面升级 OCP

本节为您介绍如何通过 OceanBase 安装部署工具（OceanBase Deployer，OBD）将 OCP-CE 升级到最新版本。

前提条件

• 仅支持 OCP V4.0.3 及之后版本通过该方式进行升级，其它版本升级方式可联系技术支持获取。

• 已安装并配置 Java 环境，目前仅支持 JDK1.8 版本。

• 已参见 安装准备 获取 ocp-all-in-one-4.2.1-YYYYMMDDhhmmss.el7.x86_64.tar.gz 软件包，将软件包上传至 OCP 宿主机的任一目录，执行如下命令进行解压。

  tar zxf ocp-all-in-one-4.2.1-YYYYMMDDhhmmss.el7.x86_64.tar.gz
  

操作步骤

步骤一：启动 obd

1. 登录 obd 中控机所在节点。

2. 执行如下命令进入解压后软件包的 bin 目录下，启动部署程序。

   cd ocp-all-in-one/bin && bash install.sh
   

3. 执行如下命令，使环境变量生效。

   source ~/.oceanbase-all-in-one/bin/env.sh
   

4. 执行 obd web upgrade ，在返回信息中获取升级向导页面的 IP 地址。

   

步骤二：进入 OCP 升级向导页面

通过浏览器访问 步骤一 获取的 IP 地址，进入升级向导页面，单击 开始升级。

步骤三：配置部署相关信息

1. 自定义待管理的 OceanBase 集群名称。

   系统会自动获取已被 OBD 管理的所有集群名称，您可在 集群名称 下拉列表选择需要升级的集群。 若您需要升级的集群（如使用 docker 部署的集群）未被 OBD 接管，可手动输入集群名。当集群升级完成后，OBD 将自动接管该集群。

2. 选择要升级的产品版本。

步骤四：验证 MetaDB 联通性

1. 确认 MetaDB 连接信息是否无误，单击 验证，系统将校验该 MetaDB 是否连接成功。

   安装程序会根据当前主机的 OCP 自动获取 MetaDB 配置信息，请检查表单中的信息是否与预期待升级环境一致，OCP 将根据该信息执行升级程序。

2. 填写操作系统用户相关信息，填写完成后，单击 验证 测试用户连通性。

   参数	说明
   用户名	需提供主机操作系统的用户以便安装程序进行自动化配置，该用户名需具有 sudo 权限。
   用户密码	需输入 用户名 的对应密码。当主机已设置免密时，可忽略此项配置。

3. 单击 下一步。

步骤五：环境预检查

环境预检查将验证您的环境是否满足升级 OCP 的要求。

系统会根据 MetaDB 配置信息，获取 OCP 相关配置信息，为保证管理功能一致性，升级程序将升级平台管理服务（OCP Server）及其管理的所有主机代理服务（OCP Agent）。

1. 确认 安装配置 及 升级配置信息 中的升级内容是否满足预期要求，确认无误后单击 预检查。

   

2. 查看检查结果。

   • 若检查通过，单击 下一步。
   • 若检查失败，支持对失败项进行修复或忽略。若选择修复，待修复完成后单击 重新检查，系统将重新执行环境预检查程序；若选择忽略，单击 忽略全部未通过项，此时未通过的检查项状态将变更为 已忽略，可进行 下一步。

   注意

   忽略全部未通过项可能会导致升级失败，建议您修复检查失败项后再进行下一步。

   

步骤六：升级 OCP

OCP 升级过程中，您可以通过 升级日志 模块查看详细升级日志。

• 若 OCP 升级成功，可在 升级日志 中查看 OCP 登录信息，包括 URL、用户名及密码等。

• 若 OCP 升级失败，请查看日志信息获取失败原因，并联系技术支持同学进行处理。待定位安装失败问题原因且修复问题后，单击 重新升级 ，系统将重新执行失败的升级步骤。

步骤七（可选）：使用 OBD 接管原 metadb 集群

使用 OBD 升级 OCP 后，若您想使用 OBD 管理原 OCP 的 metadb 集群，您可将原 metadb 集群的信息复制到 OBD 目录下即可，命令如下：

cp -rf ~/.ocp-installer/cluster/<metadb_cluster_name> ~/.obd/cluster/

其中，metadb_cluster_name 表示原 metadb 集群的名称，您需根据实际情况替换。