---
title: "使用 obd 接管集群 - 安装部署工具 OBD V3.6.0 | OceanBase 文档中心"
description: 使用 obd 接管集群 前提条件 待接管的 OceanBase 集群需为社区版 V4.2.1 BP4 或之后版本，且已启动过 obshell，具体确认操作可参见下文 查看 OceanBase 集群信息 。 待接管的 OceanBase 集群处于正常运行状态，查看方法可参见《OceanBase 数据库》文档 检查 OB…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*Qq8pT6yBPTcAAAAAAAAAAAAADiGDAQ/original) 安装部署工具 OBDV 3.6.0

# 使用 obd 接管集群

更新时间：2025-11-05 20:02:21

[编辑](https://github.com/oceanbase/obd-doc/edit/V3.6.0/zh-CN/400.user-guide/300.command-line-operations/400.takeover-cluster/450.takeover-cluster.md)  

## 前提条件

- 待接管的 OceanBase 集群需为社区版 V4.2.1 BP4 或之后版本，且已启动过 obshell，具体确认操作可参见下文 [查看 OceanBase 集群信息](#查看%20OceanBase%20集群信息)。
 - 待接管的 OceanBase 集群处于正常运行状态，查看方法可参见《OceanBase 数据库》文档 [检查 OBServer 状态](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000639722) 一文。
 - obd 所在机器与 OceanBase 集群中的节点网络连通。

## 接管 OceanBase 集群

1. 接管 OceanBase 集群

   ```shell
   [admin@obtest ~]$ obd cluster takeover test -h 10.10.10.1 -P 2881 -p ****** --ssh-user=admin --ssh-key-file=/home/admin/.ssh/id_rsa

   ```

   接管命令的详细介绍可参见 [集群命令组](https://www.oceanbase.com/docs/common-obd-cn-1000000003892230) 中 **obd cluster takeover**。
 2. 通过 obd 查看集群状态

   ```shell
   [admin@obtest ~]$ obd cluster display test

   ```

   输出如下：

   ```shell
   Get local repositories and plugins ok
   Open ssh connection ok
   Cluster status check ok
   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.0.1 | 2881 | zone1 | ACTIVE |
   +------------+---------+------+-------+--------+
   obclient -h10.10.10.1 -P2881 -uroot -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: 093ddc0c-039b-11ef-865a-00163e0808cc
   If you want to view detailed obd logs, please run: obd display-trace 093ddc0c-039b-11ef-865a-00163e0808cc

   ```

## 查看 OceanBase 集群信息

1. 使用 root 用户登录待接管 OceanBase 集群的 sys 租户

   ```shell
   [admin@obtest ~]$ obclient -h10.10.10.1 -P2883 -uroot@sys#obdemo -p -c -Doceanbase -A

   ```

   参数说明：

      - -h：提供 OceanBase 数据库连接 IP，通常是一个 ODP 地址。此处以 `10.10.10.1` 为例，您需根据实际情况进行替换。
      - -u：提供租户的连接账户，格式有：`用户名@租户名#集群名`、`集群名:租户名:用户名`、`集群名-租户名-用户名` 或者 `集群名.租户名.用户名`。此处以 `root@sys#obdemo` 为例，您需根据实际情况进行替换。

       #### 说明

            - 当使用 ODP 连接 OceanBase 集群时，可以通过以下方式获取集群名：  
             先通过直连的方式连接 OceanBase 数据库，之后使用 `SHOW PARAMETERS LIKE 'cluster';` 命令来获取集群的名称，该命令的返回结果中 `VALUE` 的值对应 OceanBase 集群的名称。
            - 如果 ODP 代理多个集群，连接时必须指定集群名；如果 ODP 只代理一个集群，连接时则不需指定集群名。
      - -P：提供 OceanBase 数据库连接端口，直连时需配置为 `mysql_port` 值（默认为 `2881`），通过 ODP 连接时需配置为 `listen_port` 值（默认为 `2883`）。此处以 `2883` 为例，您需根据实际情况进行替换。
      - -c：表示在 OBClient 运行环境中不要忽略注释。

       #### 说明

       Hint 是特殊的注释，不受 -c 影响。
      - -A：表示在 OBClient 连接数据库时不自动获取统计信息。
      - -D：设置要访问的数据库的名称，可以更改为业务数据库。
 2. 查看 OceanBase 数据库版本

   ```shell
   obclient [oceanbase]> SELECT OB_VERSION();

   ```

   输出如下：

   ```shell
   +--------------+
   | OB_VERSION() |
   +--------------+
   | 4.3.0.1      |
   +--------------+

   ```
 3. 查看 obshell 信息

   ```shell
   obclient [oceanbase]> select * from ocs.all_agent;

   ```

   输出如下，能输出 obshell 信息即表示集群中已启动过 obshell：

   ```shell
   +------------+------+---------------+----------------------+-------+--------------+-------+------------+----------+--------------------------------+------------------------------------------------------------------------------------------------------+
   | ip         | port | identity      | version              | os    | architecture | zone  | mysql_port | rpc_port | home_path                      | public_key                                                                                           |
   +------------+------+---------------+----------------------+-------+--------------+-------+------------+----------+--------------------------------+------------------------------------------------------------------------------------------------------+
   | 10.10.10.1 | 2886 | CLUSTER AGENT | 4.2.3.0-102024031414 | linux | x86_64       | zone1 |       2881 |     2882 | /home/admin/oceanbase-ce       | MEgCQQCoegOM/lKWUfz0ZUOg+KK+bpW7jr16xvQy7foOqZc5yB8F+8J5pNvD0pHNH+2IeG2bIMbhnUbV/B0XeqkACD/xAgMBAAE= |
   +------------+------+---------------+----------------------+-------+--------------+-------+------------+----------+--------------------------------+------------------------------------------------------------------------------------------------------+

   ```

## 相关文档

- [连接方式概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000640069)
 - [obd cluster takeover](https://www.oceanbase.com/docs/common-obd-cn-1000000003892230)

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