cetus/doc/cetus-quick-try.md

116 lines
5.3 KiB
Markdown
Raw Normal View History

2018-03-06 15:34:44 +08:00
# Cetus 快速入门
## 环境说明
MySQL建议使用5.7.16以上版本若使用读写分离功能则需要搭建MySQL主从关系若使用sharding功能则需要根据业务进行分库设计创建用户和密码并确认Cetus可以远程登录MySQL具体说明详见[Cetus MySQL准备说明](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-mysql-prepare.md)。
2018-03-06 15:34:44 +08:00
## 安装
Cetus只支持linux系统安装步骤参考[Cetus 安装说明](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-install.md)安装成功后Cetus提供了示例配置文件在/home/user/cetus_install/conf/目录下,以.example结尾用户可根据需求进行修改配置修改根据安装的不同版本详见[Cetus 读写分离版配置文件说明](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-rw-profile.md)、[Cetus 分库(sharding)版配置文件说明](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-shard-profile.md)。
2018-03-06 15:34:44 +08:00
## 部署
若使用读写分离功能则可以配置一主多从结构即配置一个主库0个或多个从库若使用sharding功能则可以根据分库规则配置多个后端数据库。
## 启动
2018-10-23 18:40:34 +08:00
启动cetus之前要保证配置文件proxy.conf/shard.conf的权限最小为660可以通过以下命令修改权限
```
chmod 660 proxy.conf
```
2018-10-19 09:50:58 +08:00
### 1. 命令行启动
2018-03-06 15:34:44 +08:00
```
bin/cetus --defaults-file=conf/proxy.conf|shard.conf [--conf-dir/home/user/cetus_install/conf/]
```
2018-10-19 09:50:58 +08:00
### 2. service命令启动
2018-10-23 12:04:05 +08:00
源码路径下的scripts文件夹中的cetus.service文件提供了启动、关闭cetus的脚本CentOS系统下的用户可以将其拷贝至系统/etc/init.d/目录下将其改名为cetus并将其CETUS_HOME修改成cetus的实际安装路径同时根据安装的cetus的读写分离版本或是分库版本修改CETUS_CONF。使用该脚本对cetus操作的命令如下
2018-10-19 09:50:58 +08:00
```
service cetus start
service cetus stop
service cetus restart
```
2018-03-06 15:34:44 +08:00
## 连接
Cetus对外暴露两类端口proxyshard端口和admin端口。proxyshard端口是Cetus的应用端口用来与后台数据库和前端应用进行交互admin端口是Cetus的管理端口用户可以连接Cetus的管理端口对Cetus的后端状态、配置参数等进行查看和修改。
### 1. 连接Cetus应用端口
```
$ mysql --prompt="proxy> " --comments -h**.**.**.** -P**** -u**** -p***
proxy>
```
在连接Cetus时使用在配置文件中确认好的用户名和密码登陆登陆的ip和端口为Cetus监听的proxy-address的ip和端口。
可同时启动监听同一个ip不同端口的Cetus。连接应用端口之后可正常发送Cetus兼容的sql语句。
具体使用说明根据版本情况详见[Cetus 读写分离版使用指南](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-rw.md)、[Cetus 分库(sharding)版使用指南](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-sharding.md)
2018-03-06 15:34:44 +08:00
### 2. 连接Cetus管理端口
2018-05-31 11:40:46 +08:00
**2.1 mysql客户端连接**
2018-03-06 15:34:44 +08:00
```
$ mysql --prompt="admin> " --comments -h**.**.**.** -P**** -u**** -p***
2018-05-31 11:40:46 +08:00
admin> show maintain status
```
**2.2 Python连接**
支持Python的pymysql模块和MySQLdb模块连接管理端口。
- pymysql
**注意:需要设置链接参数 autocommit=None**
```
#!/usr/bin/python
# -*- coding: utf-8 -*-
import pymysql as connector
conn = connector.connect(host="127.0.0.1", user="admin", passwd="admin", port=6666, autocommit=None )
cursor = conn.cursor()
cursor.execute("show maintain status")
data = cursor.fetchone()
print "maintain status: %s" % data
```
- MySQLdb
```
#!/usr/bin/python
# -*- coding: utf-8 -*-
import MySQLdb as connector
conn = connector.connect(host="127.0.0.1", user="admin", passwd="admin", port=6666)
cursor = conn.cursor()
cursor.execute("show maintain status")
data = cursor.fetchone()
print "maintain status: %s" % data
2018-03-06 15:34:44 +08:00
```
可以使用在配置文件中的admin用户名和密码登陆地址为admin-address的mysql对Cetus进行管理例如在查询Cetus的后端详细信息时可以登录后通过命令 select * from backends显示后端端口的地址、状态、读写类型以及读写延迟时间和连接数等信息。
2018-03-06 17:52:46 +08:00
具体使用说明根据版本情况详见[Cetus 读写分离版管理手册](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-rw-admin.md)、[Cetus 分库(sharding)版管理手册](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-shard-admin.md)
**注Cetus读写分离和分库两个版本的使用约束详见[Cetus 使用约束说明](https://github.com/Lede-Inc/cetus/blob/master/doc/cetus-constraint.md)**
2018-07-24 10:52:04 +08:00
## MySQL8 支持
由于MySQL8.0用户权限认证插件新增了caching\_sha2\_password并且默认创建的用户权限认证插件为该插件MySQL55/56/57不支持该认证方式。因此在使用MySQL55/56/57库编译的Cetus时配置default\-username账号应该在MySQL上创建时指定插件为mysql|_native|_password否则Cetus的监控线程无法工作影响Cetus的正常使用。
配置方法示例如下:
```
create user 'default-user'@'%' identified with mysql_native_password by 'my_password';
grant all privileges on *.* to 'default-user'@'%';
```
2018-08-28 14:46:04 +08:00
## 特别注意
在使用cetus的时候**不要**将后端MySQL的全局autocommit模式设置为OFF/0。如果需要使用隐式提交可以在业务端配置该参数例如在Java客户端的jdbcUrl中配置autoCommit=false。