基本操作

查看版本

ODP 安装后，有以下三种方法可以确定 ODP 的版本：

1. 新版本 ODP 的目录会带版本号，如 obproxy-3.2.3 目录名表示 3.2.3 版本的 ODP

2. 在 ODP 的目录下执行 ./bin/obproxy -V 可查看该 ODP 的版本，以 V4.0.0 为例：

   [admin@test obproxy]# ./bin/obproxy -V
   ./bin/obproxy -V
   obproxy (OceanBase 4.0.0 5)
   REVISION: 1-local-9d5c90e562c61d9fcf8894993187aa20239db47e
   BUILD_TIME: Oct 28 2022 23:01:19
   

3. 使用 root@proxysys 账号登录 ODP 后，执行 show proxyinfo binary 可查看该 ODP 的版本，以 V4.0.0 为例：

   MySQL [(none)]> show proxyinfo binary\G
   *************************** 1. row ***************************
   name: binary info
   info: ObProxy-OceanBase 4.0.0-5
   version:RELEASE_UNKNOWN
   MD5:
   REVISION:1-local-9d5c90e562c61d9fcf8894993187aa20239db47e
   BUILD_TIME:Oct 28 2022 23:01:19
   

连接 OceanBase

您可通过如下命令使用 OBClient 或 MySQL 客户端连接 OceanBase 集群：

obclient -h<obproxy_ip> -u<user> -P<obproxy_port> -p<obproxy_pwd>
或
mysql -h<obproxy_ip> -u<user> -P<obproxy_port> -p<obproxy_pwd>

# 示例
obclient -h10.10.10.1 -uroot@sys#obcluster -P2883 -p******

说明：

• -h：提供 OceanBase 数据库连接 IP，这里需是一个 ODP 的 IP 地址。

• -u：提供租户的连接账户，格式有两种：用户名@租户名#集群名 或者 集群名:租户名:用户名。

• -P：提供 OceanBase 数据库连接端口，也就是 ODP 的监听端口，默认是 2883，可以自定义。

• -p：提供账户密码，为了安全可以不提供，改为在后面提示符下输入，密码文本不可见。

ODP 重启

ODP 的进程退出后，obproxyd.sh 将在 1s 内重新拉起，有时根本察觉不到 ODP 退出过。在生产环境，该机制可以快速恢复服务，起到止血作用。

若想要手动重启，可先使用 kill 命令将 obproxy 进程停止，因为第一次启动后，就会在 etc 和 .conf 目录下生成配置文件并将配置信息持久化，所以直接执行 ./bin/obproxy 命令启动即可完成重启。

如果还想用默认配置，需要执行 rm -rf etc .conf 删除持久化的配置信息，然后执行首次启动命令。

ODP 中可以通过查询启动时间确认是否重启过，查看启动时间的方法有很多，可通过日志 succ to init logger 确定启动时间，该日志只在启动时打印一次，也可通过如下命令查看启动时间：

[admin@test ~]$ ls -l /proc/`pidof obproxy` -d
dr-xr-xr-x 158 root root 0 Nov  7 17:17 /proc/

目录介绍

ODP 的目录结构如下：

[admin@test obproxy]$ ls -alrt
total 44
-rw-r--r--  1 admin admin  910 Nov  8 16:33 obproxyd.sh
drwxrwxr-x  2 admin admin 4096 Nov  9 15:05 lib
drwxr-xr-x  6 admin admin 4096 Nov  9 15:05 ..
drwxrwxr-x  2 admin admin 4096 Nov  9 15:05 bin
drwxrwxr-x  2 admin admin 4096 Nov  9 15:06 sharding-config
drwxrwxr-x  2 admin admin 4096 Nov  9 15:06 control-config
drwxrwxr-x  2 admin admin 4096 Nov  9 15:06 log
drwxrwxr-x 10 admin admin 4096 Nov  9 15:06 .
drwxrwxr-x  2 admin admin 4096 Nov 12 17:46 run
drwxrwxr-x  2 admin admin 4096 Nov 12 17:46 etc
drwxrwxr-x  2 admin admin 4096 Nov 12 17:46 .conf

比较重要的目录和文件包括：

• obproxyd.sh：守护脚本，内容简单，大家可以通过阅读脚本代码了解实现原理

• bin 目录：保存 ODP 的二进制文件

• sharding-config 目录：保存 Sharding 相关的配置文件

• log 目录：保存日志文件的目录，磁盘占用最大，日志文件也分为多种，帮助排查定位问题

• etc 和 .conf 目录：保存配置信息，其中 .conf 是 etc 的备份，如果 etc 目录被删除，会使用 .conf 中的内容