第 4 章 快速入门

4.1 10 分钟入门

MyCAT 是使用 JAVA 语言进行编写开发,使用前需要先安装 JAVA 运行环境(JRE),由于 MyCAT 中使用了JDK7 中的一些特性,所以要求必须在 JDK7 以上的版本上运行。

4.1.1 环境准备

  1. JDK 下 载 http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html 注:必须 JDK7 或更高版本.
  2. MySQL 下载 http://dev.mysql.com/downloads/mysql/5.5.html#downloads​ 注:MyCAT 支持多种数据库接入,如:MySQL、SQLServer、Oracle、MongoDB 等,推荐使用 MySQL 做集群。
  3. MyCAT 项目主页 https://github.com/MyCATApache/ 注:MyCAT 相关源码、文档都可以在此地址下进行下载。

4.1.2 环境安装与配置

如果是第一次刚接触 MyCAT,建议先下载 MyCAT-Server 源码到本地,通过 Eclipse 等工具进行配置和运行,

便于深入了解和调试程序运行逻辑。

  1. MyCAT-Server 源码下载 由于 MyCAT 源码目前主要托管在 github 上,需要先在本地安装和配置好相关环境,具体参考群共享中 “github-eclipse 开发指南.docx”,这说明有很详细的配置说明,按照文档中的步骤把 MyCAT-Server 源码下 载到本地即可。 MyCAT-Server 仓库地址:https://github.com/MyCATApache/Mycat-Server.git
  2. 源码调试与配置 MyCAT 目前主要通过配置文件的方式来定义逻辑库和相关配置: • MYCAT_HOME/conf/schema.xml 中定义逻辑库,表、分片节点等内容; • MYCAT_HOME/conf/rule.xml 中定义分片规则; • MYCAT_HOME/conf/server.xml 中定义用户以及系统相关变量,如端口等。 注:以上几个文件的具体配置请参考前面章节中的具体说明.
  3. 源码运行 MyCAT 入口程序是 io.mycat.MycatStartup.java,右键 run as 出现下面的界面,需要设置 MYCAT_HOME 目录,为你工程当前所在目录(src/main):快速学习-Mycat快速入门_配置文件 设置完 MYCAT 主目录后即可正常运行 MyCAT 服务。

注:若启动报错,DirectBuffer 内存不够,则可以再加 JVM 系统参数:

XX:MaxDirectMemorySize=128M

4.2 快速镜像方式体验 MyCAT

此方式通过将已经安装和配置好的 MySQL+MyCAT 做成镜像,可实现快速运行和体验 MyCAT 服务。镜像文件及快速运行体验文档下载地址:

暂无

4.3 服务安装与配置

4.3.1 linux

MyCAT 有提供编译好的安装包,支持 windows、Linux、Mac、Solaris 等系统上安装与运行。

linux 下可以下载 Mycat-server-xxxxx.linux.tar.gz 解压在某个目录下,注意目录不能有空格,在Linux(Unix)下,建议放在 usr/local/Mycat 目录下,如下:

快速学习-Mycat快速入门_配置文件_02

下面是修改 MyCAT 用户密码的方式(仅供参考):

快速学习-Mycat快速入门_linux_03

快速学习-Mycat快速入门_linux_04

目录解释如下:

  • bin 程序目录,存放了 window 版本和 linux 版本,除了提供封装成服务的版本之外,也提供了 nowrap 的
  • shell 脚本命令,方便大家选择和修改,进入到 bin 目录:**Linux 下运行:./mycat console,首先要 chmod +x ***注:mycat 支持的命令{ console | start | stop | restart | status | dump }
  • conf 目录下存放配置文件,server.xml 是 Mycat 服务器参数调整和用户授权的配置文件,schema.xml 是逻辑库定义和表以及分片定义的配置文件,rule.xml 是分片规则的配置文件,分片规则的具体一些参数信息单独存放为文件,也在这个目录下,配置文件修改,需要重启 Mycat 或者通过 9066 端口 reload.
  • lib 目录下主要存放 mycat 依赖的一些 jar 文件.

日志存放在 logs/mycat.log 中,每天一个文件,日志的配置是在 conf/log4j.xml 中,根据自己的需要,可以调整输出级别为 debug,debug 级别下,会输出更多的信息,方便排查问题.

注意:Linux 下部署安装 MySQL,默认不忽略表名大小写,需要手动到/etc/my.cnf 下配置 lower_case_table_names=1 使 Linux 环境下 MySQL 忽略表名大小写,否则使用 MyCAT 的时候会提示找不到表的错误!

4.3.2 windows

MyCAT 有提供编译好的安装包,支持 windows、Linux、Mac、Solaris 等系统上安装与运行。

windows 下可以下载 Mycat-server-xxxxx-win.tar.gz 解压在某个目录下,建议解压到本地某个盘符根目录下,如下:

快速学习-Mycat快速入门_配置文件_05

目录解释如下:

  • bin 程序目录,存放了 window 版本和 linux 版本,除了提供封装成服务的版本之外,也提供了 nowrap 的shell 脚本命令,方便大家选择和修改,进入到 bin 目录:Windows 下运行:运行: mycat.bat 在控制台启动程序,也可以装载成服务,若此程序运行有问题,也可以运行 startup_nowrap.bat,确保 java 命令可以在命令执行。
  • Windows 下将 MyCAT 做成系统服务:MyCAT 提供 warp 方式的命令,可以将 MyCAT 安装成系统服务并可启动和停止。
  1. 进入 bin 目录下, 输入 ./mycat start 启动 mycat 服务。
  • conf 目录下存放配置文件,server.xml 是 Mycat 服务器参数调整和用户授权的配置文件,schema.xml 是逻辑库定义和表以及分片定义的配置文件,rule.xml 是分片规则的配置文件,分片规则的具体一些参数信息单独存放为文件,也在这个目录下,配置文件修改,需要重启 Mycat 或者通过 9066 端口 reload。
  • lib 目录下主要存放 mycat 依赖的一些 jar 文件。

日志存放在 logs/mycat.log 中,每天一个文件,日志的配置是在 conf/log4j.xml 中,根据自己的需要,可以调整输出级别为 debug,debug 级别下,会输出更多的信息,方便排查问题。

4.4 服务启动与启动设置

4.4.1 linux

MyCAT 在 Linux 中部署启动时,首先需要在 Linux 系统的环境变量中配置 MYCAT_HOME,操作方式如下:

  1. vi /etc/profile,在系统环境变量文件中增加 MYCAT_HOME=/usr/local/Mycat。
  2. 执行 source /etc/profile 命令,使环境变量生效。如果是在多台 Linux 系统中组建的 MyCAT 集群,那需要在 MyCAT Server 所在的服务器上配置对其他 ip 和主机名的映射,配置方式如下:
vi /etc/hosts

例如:我有 4 台机器,配置如下:

IP 主机名:

192.168.100.2 sam_server_1
192.168.100.3 sam_server_2
192.168.100.4 sam_server_3
192.168.100.5 sam_server_4

编辑完后,保存文件。

经过以上两个步骤的配置,就可以到/usr/local/Mycat/bin 目录下执行:

./mycat start

即可启动 mycat 服务!

4.4.2 windows

MyCAT 在 windows 中部署时,建议放在某个盘符的根目录下,如果不是在根目录下,请尽量不要放在包含中文的目录下

如:D:\Mycat-server-1.4-win

命令行方式启动:从 cmd 中执行命令到达 D:\Mycat-server-1.4-win\bin​ 目录下,执行 startup_nowrap.bat 即可启动MyCAT 服务。

注:执行此命令时,需要确保 windows 系统中已经配置好了 JAVA 的环境变量,并可执行 java 命令。jdk 版本必须是 1.7 及以上版本。

服务方式启动:

未封装

4.5 基于 zk 的启动

1.5 开始会支持本地 xml 启动,以及从 zk 加载配置转为本地 xml 的两种方式,conf 下的 zk.conf 文件里设

置 loadfromzk 参数默认为 false

如果没有这个文件,或者没有 loadfromzk 为 true 的参数,即从本地加载。下面介绍从 ZK 启动相关配置。

Zk-create.yaml 说明

1.5 正式引入 zookeeper(以下简称 zk)管理 Mycat-Server,启动 server 第一步是初始化 zk 数据,下面介绍初

始化 zk 数据步骤,信息在 zk-create.yaml。Mycat ZK 配置文件详解:

https://github.com/MyCATApache/Mycatdoc/blob/master/%E8%AE%BE%E8%AE%A1%E6%96%87%E6%A1%A3/2.0/Mycat%20ZK%E9%85%
8D%E7%BD%AE%E6%96%87%E4%BB%B6%E8%AF%A6%E8%A7%A3.docx

1、zk-create 总体结构

快速学习-Mycat快速入门_大数据_06

2、参数说明

2.1、zkURL,zk 连接地址

2.2、mycat-cluster

快速学习-Mycat快速入门_mysql_07

快速学习-Mycat快速入门_配置文件_08

快速学习-Mycat快速入门_配置文件_09

快速学习-Mycat快速入门_linux_10

快速学习-Mycat快速入门_大数据_11

快速学习-Mycat快速入门_xml_12

2.3、mycat-hosts

快速学习-Mycat快速入门_配置文件_13

2.4、mycat-zones

快速学习-Mycat快速入门_mysql_14

2.5、mycat-nodes

快速学习-Mycat快速入门_xml_15

2.6、mycat-mysqls

快速学习-Mycat快速入门_大数据_16

2.7、mysql-reps

快速学习-Mycat快速入门_大数据_17

Zk 初始化

1、进入 MYCAT/bin 目录

cd /data/test1/mycat/bin

快速学习-Mycat快速入门_linux_18

2、修改 MYCAT/conf/zk-create.yaml 内容

修改方法见“Zk-create.yaml 说明”。

3、启动 ZK

启动 ZK: bin/zkServer.sh start

快速学习-Mycat快速入门_xml_19

登陆 ZK: bin/zkCli.sh

快速学习-Mycat快速入门_xml_20

4、初始化 ZK 数据

sh create_zookeeper_data.sh

等待执行结束后,检查 ZK 数据

5、检查 ZK 数据

快速学习-Mycat快速入门_xml_21

OK,数据初始化成功。

4.6 demo 使用

springMVC+ibatis+FreeMarker 连接 mycat 示例:

http://pan.baidu.com/s/1qWr4AF6