Amoeba for MySQL读写分离配置

一、      安装和运行Amoeba

1. Amoeba for MySQL 架构：


2. 验证Java的安装
Amoeba框架是基于Java SE1.5开发的，建议使用Java SE1.5以上的版本。
#  java  -version
java version "1.6.0_35"
Java(TM) SE Runtime Environment (build 1.6.0_35-b10)
Java HotSpot(TM) 64-Bit Server VM (build 20.10-b01, mixed mode)
注：JDK的安装方法不再阐述，不会的可以参考：http://www.minunix.com/2013/05/install_tomcat/  安装JDK部分。
3.  安装MySQL数据库及配置主从复制部分此处不再阐述，不会者可参考：http://www.minunix.com/2013/05/mysql-slave/。
4.  下载Amoeba
本例使用版本：amoeba-mysql-3.0.5-RC-distribution.zip
下载地址：http://pan.baidu.com/s/1fkno
5.  安装Amoeba
把下载的压缩包解压完了之后放到 /usr/local/ 目录下即可。
# mkdir  /usr/local/amoeba
# unzip  amoeba-mysql-3.0.5-RC-distribution.zip
# /bin/cp –rf amoeba-mysql-3.0.5-RC/*  /usr/local/amoeba

二、      配置Amoeba for MySQL：
Amoeba for MySQL的使用是很简单的，主要是通过xml文件来实现的。
1. 配置文件介绍：
(1.) dbServers.xml   想象Amoeba作为数据库代理层，它一定会和很多数据库保持通信，因此它必须知道由它代理的数据库如何连接，比如最基础的：主机IP、端口、Amoeba使用的用户名和密码等等。这些信息存储在$AMOEBA_HOME/conf/dbServers.xml中。
(2.) rule.xml  Amoeba为了完成数据切分提供了完善的切分规则配置，为了了解如何分片数据、如何将数据库返回的数据整合，它必须知道切分规则。与切分规则相关的信息存储在$AMOEBA_HOME/conf/rule.xml中。
(3.) functionMap.xml  当我们书写SQL来操作数据库的时候，常常会用到很多不同的数据库函数，比如：UNIX_TIMESTAMP()、SYSDATE()等等。这些函数如何被Amoeba解析呢？$AMOEBA_HOME/conf/functionMap.xml描述了函数名和函数处理的关系。
(4.) ruleFunctionMap.xml  对$AMOEBA_HOME/conf/rule.xml进行配置时，会用到一些我们自己定义的函数，比如我们需要对用户ID求HASH值来切分数据，这些函数在$AMOEBA_HOME/conf/ruleFunctionMap.xml中定义。
(5.) access_list.conf  Amoeba可以制定一些可访问以及拒绝访问的主机IP地址，这部分配置在$AMOEBA_HOME/conf/access_list.conf中。
(6.) log4j.xml  Amoeba允许用户配置输出日志级别以及方式，配置方法使用log4j的文件格式，文件是$AMOEBA_HOME/conf/log4j.xml。
其中，我们主要用到dbServer.xml 和 amoeba.xml 。
2. dbServer.xml 的配置：

<dbServer name=”abstractServer” abstractive=”true”>
<factoryConfig class=”com.meidusa.amoeba.mysql.net.MysqlServerConnectionFactory”>
<property name=”connectionManager”>${defaultManager}</property>
<property name=”sendBufferSize”>64</property>
<property name=”receiveBufferSize”>128</property>

<!—mysql port --><!—代理连接数据库使用的端口号-->
<property name=”port”>3306</property>

<!—mysql schema --><!—代理连接数据库所使用的数据库-->
<property name=”schema”>test</property>

<!—mysql user --><!—代理连接数据库使用的用户名-->
<property name=”user”>minunix</property>
<!—代理连接数据库使用的密码-->
<property name=”password”>minunix.com</property>
</factoryConfig>

<poolConfig class=”com.meidusa.toolkit.common.poolable.PoolableObjectPool”>
<property name=”maxActive”>500</property>
<property name=”maxIdle”>500</property>
<property name=”minIdle”>1</property>
<property name=”minEvictableIdleTimeMillis”>600000</property>
<property name=”timeBetweenEvictionRunsMillis”>600000</property>
<property name=”testOnBorrow”>true</property>
<property name=”testOnReturn”>true</property>
<property name=”testWhileIdle”>true</property>
</poolConfig>
</dbServer>

<!--- 配置真实的数据库的地址-->
<!--- 配置主从服务器及服务器连接池-->
<dbServer name="server1"  parent="abstractServer">

<factoryConfig>

<!-- mysql ip -->

<property name="ipAddress">192.168.0.162</property>

</factoryConfig>

</dbServer>

<dbServer name=”server2”  parent=”abstractServer”>

<factoryConfig>

<!—mysql ip -->

<property name=”ipAddress”>192.168.0.171</property>

</factoryConfig>

</dbServer>



<dbServer name=”multiPool” virtual=”true”>

<poolConfig class=”com.meidusa.amoeba.server.MultipleServerPool”>

<!—Load balancing strategy: 1=ROUNDROBIN , 2=WEIGHTBASED , 3=HA-->

<property name=”loadbalance”>1</property>



<!—Separated by commas,such as: server1,server2,server1 -->

<property name=”poolNames”>server1,server2</property>

</poolConfig>

</dbServer>

3. amoeba.xml 配置：
客户端连接Amoeba时所绑定的IP地址、端口、用户名和密码。及IP访问限制。

<service name="Amoeba for Mysql" >
<!-- port -->

<property name="port">8066</property>



<!-- bind ipAddress -->

<!--

<property name="ipAddress">127.0.0.1</property>

-->



<property name="connectionFactory">

<bean >

<property name="sendBufferSize">128</property>

<property name="receiveBufferSize">64</property>

</bean>

</property>



<property name="authenticateProvider">

<bean >

<property name="user">root</property>

<property name="password">minunix</property>



<property name="filter">

<bean>

<property name="ipFile">${amoeba.home}/conf/access_list.conf</property>

</bean>

</property>

</bean>

</property>



</service>

以下内容是定义读写分离：

<queryRouter >
<property name="ruleLoader">

<bean >

<property name="ruleFile">${amoeba.home}/conf/rule.xml</property>

<property name="functionFile">${amoeba.home}/conf/ruleFunctionMap.xml</property>

</bean>

</property>

<property name="sqlFunctionFile">${amoeba.home}/conf/functionMap.xml</property>

<property name="LRUMapSize">1500</property>

<property name="defaultPool">multiPool</property>



<property name="writePool">server1</property>

<property name="readPool">server2</property>



<property name="needParse">true</property>

</queryRouter>

通过以上简单配置，已经可以实现数据库的读写分离了。

三、      测试
# cd  /usr/local/bin/
# ./launcher   \  (也可通过nohup后台启动，或者自己写一个脚本来启动。 )
启动的Amoeba默认端口为8066
在客户端连接Amoeba测试：
# mysql  -uroot –pminunix  -h192.168.0.161  --port 8066
mysql> show databases;
mysql> CREATE DATABASE  minunix;  \  创建数据库，之后在主从库分别查看
通过Amoeba登录，进行数据的查询及插入更新等操作，并查看mysql-log日志，可发现所执行的INSERT 、UPDATE、DELETE等操作在主库server1上操作，SELECT查询语句在从库server2上执行。