第 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快速入门_xml_02

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

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

快速学习-Mycat快速入门_mysql_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快速入门_xml_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快速入门_xml_08

快速学习-Mycat快速入门_linux_09

快速学习-Mycat快速入门_linux_10

快速学习-Mycat快速入门_linux_11

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

2.3、mycat-hosts

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

2.4、mycat-zones

快速学习-Mycat快速入门_mysql_14

2.5、mycat-nodes

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

2.6、mycat-mysqls

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

2.7、mysql-reps

快速学习-Mycat快速入门_mysql_17

Zk 初始化

1、进入 MYCAT/bin 目录

cd /data/test1/mycat/bin

快速学习-Mycat快速入门_mysql_18

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

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

3、启动 ZK

启动 ZK: bin/zkServer.sh start

快速学习-Mycat快速入门_linux_19

登陆 ZK: bin/zkCli.sh

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

4、初始化 ZK 数据

sh create_zookeeper_data.sh

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

5、检查 ZK 数据

快速学习-Mycat快速入门_linux_21

OK,数据初始化成功。

4.6 demo 使用

springMVC+ibatis+FreeMarker 连接 mycat 示例：

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