基本操作

查看版本

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

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

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

   [admin@test obproxy]# ./bin/obproxy -V
   ./bin/obproxy -V
   obproxy (OceanBase 3.2.3 2)
   REVISION: 6-local-99faebfc7130b70ad0f56330a28cab6a32ec9a33
   BUILD_TIME: Mar 30 2022 01:53:08
   

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-20221103165243.el7
   version:RELEASE_7U
   MD5:
   REVISION:20221103165243-7c7e5821009b2d3924d1bc7a8165edf7384f6ed3
   BUILD_TIME:Nov  3 2022 16:57:16
   

连接 OceanBase 数据库

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

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

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

说明：

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

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

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

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

• -c：表示在 OBClient 运行环境中不要忽略注释。

  说明

  Hint 是特殊的注释，不受 -c 影响。

• -A：表示在 OBClient 连接数据库时不自动获取统计信息。

ODP 重启

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

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

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

操作步骤

1. 使用启动 ODP 进程的用户登录到 obproxy 进程所在机器

2. 执行如下命令查看 obproxy 进程的进程号

   -bash-4.2$ ps -ef | grep obproxy
   

   输出如下，obproxy 进程号为 37360。

   admin     37360      0  6 11:35 ?        00:00:09 bin/obproxy
   admin     43055  36750  0 11:37 pts/10   00:00:00 grep --color=auto obproxy
   root      85623      1  0 Jun02 ?        00:15:19 /home/admin/ocp_agent/obagent/obstat2 -o http://xx.xx.xx.xx:81 -c test323 __obproxy__ -f 20
   

3. 执行如下命令，根据查询到的进程号，停止 obproxy 进程

   -bash-4.2$ kill -9 37360
   

4. 停止成功后，再次查询 obproxy 进程的进程号，确认 obproxy 进程是否已不存在

   -bash-4.2$ ps -ef | grep obproxy
   

   输出如下，obproxy 进程已不存在。

   admin     43055  36750  0 11:37 pts/10   00:00:00 grep --color=auto obproxy
   root      85623      1  0 Jun02 ?        00:15:19 /home/admin/ocp_agent/obagent/obstat2 -o http://xx.xx.xx.xx:81 -c test323 __obproxy__ -f 20
   

5. 根据实际情况选择如下任一方式启动 obproxy 进程

   • 若想参照上次启动的配置进行启动，在 ODP 家目录下直接执行 ./bin/obproxy 命令启动即可完成重启。

   • 若想重新进行配置并启动，需在 ODP 家目录下执行 rm -rf etc .conf 删除持久化的配置信息，之后执行启动命令。详细的启动方法可参考 通过命令行部署 ODP 中 启动 ODP 部分内容。

6. 验证是否重启

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

   -bash-4.2$ ls -l /proc/`pidof obproxy` -d
   dr-xr-xr-x 8 admin admin 0 Nov 14 14:18 /proc/118273
   

目录介绍

ODP 的目录结构如下：

-bash-4.2$ ls -alrt
total 48
-rw-r--r-- 1 admin admin 14245 Nov  3 16:57 start_obproxy.sh
drwxr-xr-x 2 admin admin  4096 Nov 14 14:15 bin
drwxr-xr-x 2 admin admin  4096 Nov 14 14:15 tools
lrwxrwxrwx 1 admin admin    28 Nov 14 14:15 log -> /home/admin/logs/obproxy/log
lrwxrwxrwx 1 admin admin    33 Nov 14 14:15 minidump -> /home/admin/logs/obproxy/minidump
drwxr-xr-x 1 root  root   4096 Nov 14 14:16 ..
drwxrwxr-x 2 admin admin  4096 Nov 14 14:18 sharding-config
drwxrwxr-x 2 admin admin  4096 Nov 14 14:18 control-config
drwxr-xr-x 8 admin admin  4096 Nov 14 14:18 .
drwxrwxr-x 2 admin admin  4096 Nov 14 14:18 etc
drwxrwxr-x 2 admin admin  4096 Nov 14 14:18 .conf

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

• start_obproxy.sh：守护脚本，内容简单，大家可以通过阅读脚本代码了解实现原理，使用 obd 部署的 ODP 中守护脚本为 obproxyd.sh

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

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

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

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