使用 OBD 部署 OceanBase 数据库 
============================================

本文介绍如何使用 OBD 部署 OceanBase 数据库。

名词解释 
-------------------------

* 中控机器

  存储 OceanBase 数据库安装包和集群配置信息的机器。
  

* 目标机器

  安装 OceanBase 数据库的机器。
  




前提条件 
-------------------------

在连接 OceanBase 数据库之前，请您确认以下信息：

* 您已经在中控机器安装了 OBD。详细信息，参考 [安装 OBD](../2.quickstart/3.use-obd-to-obtain-the-oceanbase-database.md)。

  

* 您已经在目标机器安装了 OceanBase 数据库。

  

* 您已经在中控机器安装了 OceanBase 数据库的客户端 OBClient。详细信息，参考 [OBClient 文档](https://github.com/oceanbase/obclient/blob/master/README.md)。

  




修改配置文件 
---------------------------

1. 从 GitHub 上下载对应的配置文件模板。

   如果您采用本地安装，即中控机器和目标机器是同一台机器，请下载 [本地安装配置文件](https://github.com/oceanbase/obdeploy/blob/master/example/mini-single-example.yaml)。

   如果您采用单机安装，即中控机器和目标机器不是同一台机器，且目标机器只有一台，请下载 [单机安装配置文件](https://github.com/oceanbase/obdeploy/blob/master/example/mini-local-example.yaml)。

   如果您采用分布式安装，即中控机器和目标机器不是同一台机器，且目标机器有多台，请下载 [分布式安装配置文件](https://github.com/oceanbase/obdeploy/blob/master/example/mini-distributed-example.yaml)。
   **注意**

   

   此处以本地安装为例，介绍如何修改配置文件。您必须按照您的安装方式选择对应的配置文件模板。
   

2. 在配置文件顶部添加用户密码信息。

   ```yaml
   user:
   username: <您的账号名>
   password: <您的登录密码>
   key_file: <您的私钥路径>
   ```

   

   其中，`username` 为登录到目标机器的用户名，确保您的用户名有 observer 进程工作目录 `home_path` 的权限。
   **注意**

   

   通常情况下，您只能使用登录密码或者私钥登录中的一种方式目标机器。
   

3. 修改配置文件中的 IP 地址。

   ```yaml
   oceanbase-ce:
     servers:
       - name: z1
         # Please don't use hostname, only IP can be supported
         ip: 11.166.80.01
   ```

   

4. 修改配置文件中的 `devname` 变量和 `home_path`。

   ```yaml
   oceanbase-ce:
     global:
       home_path: <your_observer_work_path>
       # Please set devname as the network adaptor's name whose ip is  in the setting of severs.
       # if set severs as "127.0.0.1", please set devname as "lo"
       # if current ip is 192.168.1.10, and the ip's network adaptor's name is "eth0", please use "eth0"
       devname: bond0
   ```

   
   **注意**

   您需要拥有 `home_path` 目录的权限。
   




启动 OceanBase 数据库 
-------------------------------------

1. 运行以下命令部署集群：

   ```bash
   obd cluster deploy <deploy_name> -c <deploy_config_path>
   ```

   

   其中，`deploy_name` 为集群名称。一个集群只能有一个名称，且集群名称不能重复。
   

2. 运行以下命令启动集群：

   ```bash
   obd cluster start <deploy_name> 
   ```

   

3. 运行以下命令查看集群状态：

   ```bash
   obd cluster display <deploy_name>
   ```

   




连接 OceanBase 数据库 
-------------------------------------

按照以下步骤连接 OceanBase 数据库：

1. 安装 OceanBase 数据库客户端 OBClient：

   如您的机器已添加 OceanBase 官方 YUM 源作为软件源，使用以下命令直接安装：

   ```unknow
   sudo yum install -y obclient
   ```

   

   否则您需要在机器上准备好离线安装包，并执行以下命令安装：

   ```unknow
   sudo yum install -y libobclient-2.0.0-2.el7.x86_64.rpm
   sudo yum install -y obclient-2.0.0-2.el7.x86_64.rpm
   ```

   
   **注意**

   

   您必须首先下载 OBClient 的依赖包 LibOBClient。示例中的安装包可能不是最新版本，建议您下载最新的安装包。详细信息，参考 [下载中心](https://open.oceanbase.com/softwareCenter/community)。
   

2. 运行以下命令，使用 OBClient 客户端连接 OceanBase 数据库：

   ```unknow
   obclient -h<your_ip> -P<observer_mysql_port> -uroot
   ```

   

   其中，`your_ip` 为您 OceanBase 实例所在的机器 IP 地址。`observer` 默认使用端口 `2881` 连接 OBClient。如果您对端口做了更改，此处使用您实际的端口号。

   返回以下信息：

   ```unknow
   Welcome to the MariaDB monitor.  Commands end with ; or \g.
   Your MySQL connection id is 3221546072
   Server version: 5.7.25 OceanBase 3.1.0 (r1-) (Built Apr  7 2021 08:14:49)
   
   Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
   
   Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
   
   MySQL [(none)]>
   ```

   
   




（可选）验证集群 
-----------------------------

连接 OceanBase 数据库，运行以下命令验证集群：

```sql
MySQL [oceanbase]> USE oceanbase; 
MySQL [oceanbase]> SELECT * FROM __all_server;
```



返回以下结果：

```sql
+----------------------------+----------------------------+---------------+----------+----+-------+------------+-----------------+--------+-----------------------+--------------------------------+-----------+--------------------+--------------+----------------+-------------------+
| gmt_create                 | gmt_modified               | svr_ip        | svr_port | id | zone  | inner_port | with_rootserver | status | block_migrate_in_time | build_version                  | stop_time | start_service_time | first_sessid | with_partition | last_offline_time |
+----------------------------+----------------------------+---------------+----------+----+-------+------------+-----------------+--------+-----------------------+--------------------------------+-----------+--------------------+--------------+----------------+-------------------+
| 2021-04-21 10:59:04.967158 | 2021-04-21 10:59:20.344774 | 11.166.80.01  |    2882 |  1 | zone1 |      2881 |               1 | active |                     0 | 3.1.0_1-(Apr  7 2021 08:14:49) |         0 |   1618973957346877 |            0 |              1 |                 0 |
| 2021-04-21 10:59:04.956632 | 2021-04-21 10:59:20.223340 | 11.166.80.02  |    2882 |  2 | zone2 |      2881 |               0 | active |                     0 | 3.1.0_1-(Apr  7 2021 08:14:49) |         0 |   1618973958225270 |            0 |              1 |                 0 |
| 2021-04-21 10:59:03.956853 | 2021-04-21 10:59:22.415147 | 11.166.81.103 |    2882 |  3 | zone3 |      2881 |               0 | active |                     0 | 3.1.0_1-(Apr  7 2021 08:14:49) |         0 |   1618973958416271 |            0 |              1 |                 0 |
+----------------------------+----------------------------+---------------+----------+----+-------+------------+-----------------+--------+-----------------------+--------------------------------+-----------+--------------------+--------------+----------------+-------------------+
3 rows in set (0.00 sec)
```



以上返回结果说明集群部署成功。



