安装 obcdc

本文介绍如何通过手动安装 obcdc 来适配新版本 OceanBase 数据库。

背景介绍

因 obbinlog 与 OceanBase 数据库的发版周期不同，当 OceanBase 数据库发布新版本而 obbinlog 未同步发版时，您可通过手动安装对应版本的 obcdc 来使 Binlog 服务适配新版本 OceanBase 数据库。

前提条件

在开始之前，请确保您当前环境已安装 obbinlog。

操作步骤

1. 下载 obcdc 安装包

   访问官网 OceanBase 软件下载中心，搜索 增量数据获取工具，根据实际环境下载对应版本安装包；或访问 阿里云镜像站，根据实际环境访问对应下载页，搜索 oceanbase-ce-cdc 下载对应版本安装包。

2. 解压 RPM 包

   [admin@test001 rpm]$ rpm2cpio oceanbase-ce-cdc-4.2.5.0-100010012024110110.el7.x86_64.rpm | cpio -div
   

   解压后当前目录 ./home/admin/oceanbase/lib64 下会出现以下文件：

   libobcdc.so -> libobcdc.so.4
   libobcdc.so.4 -> libobcdc.so.4.2.5.0
   libobcdc.so.4.2.5.0
   

3. 创建 obcdc 目录

   在 obbinlog 安装目录下的 obcdc 文件夹中，子文件夹的命名格式为 obcdc-ce-${version}.x-access，其中 ${version} 代表版本号的前三位数字，比如 obcdc-ce-4.2.5.x-access。

   请在已有的 obcdc 目录中找出版本与要安装的 obcdc 版本相近的一个目录，如 obcdc-ce-4.2.4.x-access，通过复制创建出待安装的 obcdc 目录 obcdc-ce-4.2.5.x-access。

   [admin@test001 rpm]$ sudo cp -av /home/ds/oblogproxy/obcdc/obcdc-ce-4.2.4.x-access  /home/ds/oblogproxy/obcdc/obcdc-ce-4.2.5.x-access
   

   示例中 /home/ds/oblogproxy/ 为 obbinlog 的默认安装路径，您需根据实际路径进行替换。

4. 替换 libobcdc

   删除新 obcdc 目录下原有的 libobcdc 文件，并将需要安装的 libobcdc 文件复制到该目录。

   [admin@test001 rpm]$ sudo rm -f /home/ds/oblogproxy/obcdc/obcdc-ce-4.2.5.x-access/libobcdc.so*
   [admin@test001 rpm]$ sudo cp -av ./home/admin/oceanbase/lib64/libobcdc.so*  /home/ds/oblogproxy/obcdc/obcdc-ce-4.2.5.x-access
   

   示例中 /home/ds/oblogproxy/ 为 obbinlog 的默认安装路径，您需根据实际路径进行替换。

5. 启动 Binlog Server

   若当前节点未启动过 Binlog Server，您需参考 部署指南 中 步骤二：配置并启动 Binlog Server 操作启动 Binlog Server。

   若当前节点已启动 Binlog Server，您需重启 Binlog Server 使 obcdc 生效。根据启动 Binlog Server 时配置的不同有如下两种重启方法，可根据实际情况选择：

   • supervisord 重启

     当通过部署脚本 env/deploy.sh 启动且 supervise_start 配置为 true 时，脚本会安装 supervisord 并使用 supervisord 启动程序，您可执行如下命令重启 Binlog Server。

     [admin@test001 oblogproxy]$ supervisorctl restart binlog
     

   • 非 supervisord 重启

     除通过部署脚本 env/deploy.sh 启动且 supervise_start 配置为 true 外的其他场景，您都可执行如下命令重启 Binlog Server。

     [admin@test001 oblogproxy]$ sudo ./run.sh stop
     [admin@test001 oblogproxy]$ sudo ./run.sh start