---
title: "手动安装 obcdc | OceanBase 文档中心"
description: 手动安装 obcdc 本文介绍如何通过手动安装 obcdc 来适配新版本 OceanBase 数据库。 背景介绍 因 obbinlog 与 OceanBase 数据库的发版周期不同，当 OceanBase 数据库发布新版本而 obbinlog 未同步发版时，您可通过手动安装对应版本的 obcdc 来使 Binlog …
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qvvxQ5-hqEoAAAAAAAAAAAAADiGDAQ/original) OceanBase Binlog 服务V 4.0.1 社区版

# 手动安装 obcdc

更新时间：2025-05-30 16:16:38

[编辑](https://github.com/oceanbase/oblogproxy-doc/edit/V4.0.1/zh-CN/550.service-upgrade.md)  

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

## 背景介绍

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

## 前提条件

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

## 操作步骤

#### 说明

本文以在 x86 架构的 CentOS Linux 7.9 镜像中安装 obcdc V4.2.5 为例介绍具体操作，其他环境可能略有不同。

1. 下载 obcdc 安装包

   访问官网 [OceanBase 软件下载中心](https://www.oceanbase.com/softwarecenter)，搜索 **增量数据获取工具**，根据实际环境下载对应版本安装包；或访问 [阿里云镜像站](https://mirrors.aliyun.com/oceanbase/community/stable/el/)，根据实际环境访问对应下载页，搜索 `oceanbase-ce-cdc` 下载对应版本安装包。
 2. 解压 RPM 包

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

   ```

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

   ```shell
   libobcdc.so -> libobcdc.so.4
   libobcdc.so.4 -> libobcdc.so.4.2.5.0
   libobcdc.so.4.2.5.0

   ```
 3. 移动文件到 obbinlog 对应目录下

   #### 注意

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

   ```shell
   [admin@test001 rpm]$ sudo mv ./home/admin/oceanbase/lib64  /home/ds/oblogproxy/obcdc/obcdc-ce-4.2.5.x-access

   ```

   示例中 `/home/ds/oblogproxy/` 为 obbinlog 的默认安装路径，您需根据实际路径进行替换。
 4. 补充其他需要的依赖

   将需要的其他依赖从其他目录复制到新的 obcdc 目录。

   ```shell
   [admin@test001 obcdc]$ cp -av obcdc-ce-4.2.4.x-access/libaio* obcdc-ce-4.2.5.x-access
   [admin@test001 obcdc]$ cp obcdc-ce-4.2.4.x-access/libobcdcaccess.so obcdc-ce-4.2.5.x-access

   ```
 5. 启动 Binlog Server

   若当前节点未启动过 Binlog Server，您需参考 [部署指南](https://www.oceanbase.com/docs/community-oblogproxy-doc-1000000001493745) 中 **步骤二：配置并启动 Binlog Server** 操作启动 Binlog Server。

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

      - supervisord 重启

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

       ```shell
       [admin@test001 oblogproxy]$ supervisorctl restart binlog

       ```
      - 非 supervisord 重启

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

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

       ```

 上一篇 下一篇 ![有帮助](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) 咨询热线