升级 OCP

本文介绍如何通过 obd 的图形化界面操作升级 OCP。

前提条件

当前待升级 OCP 的版本需为 V4.0.3 或之后版本。

注意事项

升级通过 Docker 容器部署的 OCP 时，有如下注意事项：

• 需确认所有的 OCP 容器处于正常状态。若存在多个 OCP 容器，仅需保留一个 OCP 容器处于启动状态，停止其他容器。

• 启动状态的 OCP 容器的名字里需包含 ocp-all-in-one 字段，若不包含需对容器进行重命名。

• 若原 Docker 部署的是多节点 OCP，升级后仍需要多节点，需要对 OCP 进行扩容操作。具体操作参见 步骤三：扩容 OCP。

操作步骤

步骤一：获取升级所需安装包

1. 下载安装包

   访问 OceanBase 软件下载中心，搜索 OceanBase 云平台，根据实际情况下载所需安装包，并将安装包上传至 obd 中控机器任一目录下。

   若从下载中心无法获取所需版本安装包，可联系技术支持人员获取对应安装包。

2. 解压安装包

   在安装包所在目录下，执行如下命令解压：

   [admin@test001 ~]$ tar -xzf ocp-all-in-one-*.tar.gz
   

3. （可选）卸载原 obd

   若机器中存在 obd 且该 obd 是通过 All in One 包安装，您可执行如下命令先卸载当前 obd。

   [admin@test001 ~]$ cd ocp-all-in-one/bin && bash uninstall.sh
   

4. 启动安装程序

   在 ocp-all-in-one 安装目录的 bin 目录下执行 install.sh 脚本启动安装 obd 程序。

   [admin@test001 bin]$ bash install.sh
   

   该脚本会安装 obd，并将安装目录下 rpms 目录中的所有安装包复制到 obd 的本地镜像库中，同时关闭远程镜像库。执行成功后输出如下，您可复制并执行输出中的 source ~/.oceanbase-all-in-one/bin/env.sh 命令以应用环境配置。

   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. 启动升级

   [admin@test001 ~]$ obd web upgrade
   

   输出如下，浏览器中访问输出中的 IP 地址即可进入升级向导页面，单击 开始升级。

   start OBD WEB in 0.0.0.0:8680
   please open http://10.10.10.1:8680/#/updateWelcome
   

   说明

   • 白屏界面默认使用 8680 端口，您可使用 obd web upgrade -p <PORT> 命令指定端口。

   • 在阿里云或其他云环境下，可能出现程序无法获取公网 IP，从而输出内网地址的情况，此 IP 非公网地址，您需要使用正确的地址访问白屏界面。

   • obd web 命令绑定在 0.0.0.0 上，在多网卡部署的情况下，您可通过任意一个可访问的 IP 访问白屏界面。

2. 部署配置

   在部署配置页面选择待升级的 OCP 集群，以及升级的目标版本。系统会自动获取已被 obd 管理的所有集群名称，您可在 集群名称 下拉列表选择需要升级的集群。若您需要升级的集群未被当前 obd 接管（如使用 Docker 部署的集群），此处可自定义集群名。当集群升级完成后，OBD 将自动接管对应 OCP 集群。

   

   设置完成后，单击 下一步 即可进入 联通性测试 页面。

3. 验证 MetaDB 联通性

   升级使用 Docker 部署的 OCP 时，需手动填写 MetaDB 配置信息；若待升级 OCP 由 obd 管理，当前页面会自动获取 MetaDB 配置信息，您需检查 连接信息 部分内容是否与预期待升级环境一致。确认 MetaDB 连接信息无误后，输入 访问密码 并单击 验证，系统将校验 MetaDB 是否可成功连接。

   

4. 配置操作系统用户

   验证 MetaDB 联通性后，您需填写操作系统用户以便安装程序进行自动化配置。

   

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

   配置完成后，单击 下一步 即可进入 环境预检查 页面。

5. 环境预检查

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

   确认 安装配置 及 升级配置信息 中的升级内容是否满足预期要求，若发现问题可单击 上一步 进行修改，确认无误后可单击 预检查 进行检查。

   若检查通过，单击 下一步 即可开始升级 OCP；若检查失败，支持对失败项进行修复或忽略。

   • 若选择修复，待修复完成后单击 重新检查，系统将重新执行环境预检查程序。

   • 若选择忽略，单击 忽略全部未通过项，此时未通过的检查项 检查状态 将变更为 已忽略，可单击 下一步 开始升级 OCP。

   注意

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

   

6. 升级 OCP

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

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

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

   说明

   升级 OCP 的过程会耗时较长，请您耐心等待。

   

（可选）步骤三：扩容 OCP

1. 准备扩容所用配置文件

   [admin@test001 ~]$ vim ocp-scale-out.yaml
   

   文件内容示例如下，servers.name 配置不能与原 OCP 集群中的重复：

   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. 执行扩容

   [admin@test001 ~]$ obd cluster scale_out myocp -c ocp-scale-out.yaml
   

   命令执行成功返回如下内容：

   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 集群信息。

   obd cluster display myocp
   

   输出如下，包含新扩容进去的两个 OCP 节点：

   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 obshell dashboard ok
   +----------------------------------------------------------+
   |                     obshell 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 云平台 文档。