基于阿里巴巴开源的分布式数据同步系统安装配置文档otter

otter项目开源地址：https://github.com/alibaba/otter

canal项目开源地址：https://github.com/alibaba/canal

我们的用这个系统的背景：主要是做异地容灾，可是我们需要的现网的数据需要同步到容灾区。

工作原理：

原理描述：

1.基于Canal开源产品，获取数据库增量日志数据。 什么是Canal, 请点击

2.典型管理系统架构，manager(web管理)+node(工作节点)

a. manager运行时推送同步配置到node节点

b. node节点将同步状态反馈到manager上

3.基于zookeeper，解决分布式状态调度的，允许多node节点之间协同工作.

组件解释：

canal：

什么是canal？  otter之前开源的一个子项目，开源链接地址：http://github.com/alibaba/canal

定位：基于数据库增量日式解析，提供增量数据订阅&消费，目前主要支持了mysql

工作原理：

原理相对简单：类似MYSQL原有的主从复制机制。

1.canal模拟mysql slave 的交互协议，伪装自己为mysql slave，想mysql master发送dump协议

2.mysql master收到dump请求，开始推送binary log给slave（也就是canal）

3.canal解释binary log 对象（原始为byte流）

相关文档：

See the wiki page for : wiki文档

环境配置：

canal、otter依赖jdk环境、node依赖 aria2启动：

apt-get update && apt-get install default-jdk aria2 -y

组件安装配置：

canal：

a. canal原理基于mysql  binlog技术；需要binlog的支持，而且log的format格式为ROW：

[mysqld]

log-bin=mysql-bin #添加这一行就ok

binlog-format=ROW #选择row模式

server_id=1 #配置mysql replaction需要定义，不能和canal的slaveId重复

b. 授权slave同步：

CREATE USER canal IDENTIFIED BY 'canal';

GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'canal'@'%';

或者：GRANT ALL PRIVILEGES ON *.* TO 'canal'@'%' ;

FLUSH PRIVILEGES;

解压直接使用。

配置文件：

vi conf/example/instance.properties

#################################################

## mysql serverId

canal.instance.mysql.slaveId = 1234

# position info，需要改成自己的数据库信息

canal.instance.master.address = 127.0.0.1:3306  #指定master 的ip:port

canal.instance.master.journal.name =  #配置binlog的file 可以不用配置（默认是以当前启动）

canal.instance.master.position =          #配置binlog的postion 可以不用配置（默认是以当前启动）

canal.instance.master.timestamp =

#canal.instance.standby.address =

#canal.instance.standby.journal.name =

#canal.instance.standby.position =

#canal.instance.standby.timestamp =

# username/password，需要改成自己的数据库信息

canal.instance.dbUsername = canal    #配置为授权的账号

canal.instance.dbPassword = canal    #配置授权的密码

canal.instance.defaultDatabaseName =  #可以指定数据库

canal.instance.connectionCharset = UTF-8  #配置编码格式

# table regex

canal.instance.filter.regex = .*\\..*

#################################################

启动、停止：

bin/startup.sh  bin/stop.sh

zookeeper:

安装配置：

配置所有的zk主机的hosts文件

192.168.56.1  zk

192.168.56.2  re

192.168.56.3  yt

zk配置文件：

vim conf/zoo.cfg

#################################################

# The number of milliseconds of each tick

tickTime=2000

# The number of ticks that the initial

# synchronization phase can take

initLimit=10

# The number of ticks that can pass between

# sending a request and getting an acknowledgement

syncLimit=5

# the directory where the snapshot is stored.

# do not use /tmp for storage, /tmp here is just

# example sakes.

dataDir=/usr/local/zk_cluster/zookeeper-3.4.6_node1/data  #目录需要创建

#dataLogDir

# the port at which the clients will connect

clientPort=2181                        #每一个节点的port也不一样

server.1=zk:2887:3892              #不管是前面的port还是后面的port。每一个节点都不一样

server.2=zk:2888:3893

server.3=zk:2889:3894

server.4=re:3386:3388:observer  #远端的zkobserver角色

server.5=re:3387:3389:observer  #远端的zkobserver角色

server.6=yt:2892:3895:observer  #远端的zkobserver角色

# the maximum number of client connections.

# increase this if you need to handle more clients

observer配置：

# The number of milliseconds of each tick

tickTime=2000

# The number of ticks that the initial

# synchronization phase can take

initLimit=10

# The number of ticks that can pass between

# sending a request and getting an acknowledgement

syncLimit=5

peerType=observer  #指定此节点为observer类型

# the directory where the snapshot is stored.

# do not use /tmp for storage, /tmp here is just

# example sakes.

dataDir=/usr/local/zk_cluster/zookeeper-3.4.6_node4/data

#dataLogDir

# the port at which the clients will connect

clientPort=2184

server.1=zk:2887:3892

server.2=zk:2888:3893

server.3=zk:2889:3894

server.4=re:2890:3890:observer

server.5=re:2891:3891:observer

server.6=yt:2892:3895:observer

# the maximum number of client connections.

# increase this if you need to handle more clients

启动、停止：

zookeeper-3.4.6_node4/bin/zkServer.sh start  zookeeper-3.4.6_node4/bin/zkServer.sh stop

注意：每一个节点都有一个唯一的myid,这个需要在data目录下创建一个myid文件并将本地节点对应的server.x  x的id写入myid中。data目录需要建立哦

列如： 第一个节点：

server.1=zk:2887:3892  只需要在myid文件中输入 1即可

otter：

manager：

manager是web管理界面，需要mysql数据库的支持，在manager上部署mysql、授权。还需要原始的数据、载入原始数据；网上下载即可：

wget https://raw.github.com/alibaba/otter/master/manager/deployer/src/main/resources/sql/otter-manager-schema.sql

配置文件：

vim conf/otter.properties

## otter manager domain name #修改为正确访问ip，生成URL使用

otter.domainName = 192.168.56.4    #配置访问的域名或者ip

## otter manager http port

otter.port = 8080                        #配置web访问的port

## jetty web config xml

otter.jetty = jetty.xml

## otter manager database config ，修改为正确数据库信息

otter.database.driver.class.name = com.mysql.jdbc.Driver

otter.database.driver.url = jdbc:mysql://127.0.01:3306/ottermanager  #配置manager链接数据库

otter.database.driver.username = otter                                                #配置连接数据库的用户名

otter.database.driver.password = otter                                                #配置连接数据库的密码

## otter communication port

otter.communication.manager.port = 1099                                        #配置node链接的port

## otter communication pool size

otter.communication.pool.size = 10

## default zookeeper address，修改为正确的地址，手动选择一个地域就近的zookeeper集群列表

otter.zookeeper.cluster.default = 192.168.56.1:2181,192.168.56.1 :2182,192.168.56.1:2183,192.168.56.2:3384,192.168.56.2:3385,192.168.56.3:2186  #配置一个就近的zk群集地址 写离manager最近的一个也可以 例　　　　　　如：192.168.56.1:2181

## default zookeeper sesstion timeout = 90s

otter.zookeeper.sessionTimeout = 90000

## otter arbitrate connect manager config

otter.manager.address = ${otter.domainName}:${otter.communication.manager.port

启动、停止：

bin/startup.sh    bin/stop.sh

访问url：

http://192.168.168.4:8080

默认账号密码：admin/admin

node：

vim conf/otter.properties

# otter node root dir

otter.nodeHome = ${user.dir}/../

## otter node dir

otter.htdocs.dir = ${otter.nodeHome}/htdocs

otter.download.dir = ${otter.nodeHome}/download

otter.extend.dir= ${otter.nodeHome}/extend

## default zookeeper sesstion timeout = 60s

otter.zookeeper.sessionTimeout = 60000

## otter communication pool size

otter.communication.pool.size = 10

## otter arbitrate & node connect manager config

otter.manager.address = 192.168.56.4:1099  # 指定manager的ip:port

启动、停止：注：node启动需要先配置nid，下面解释。

bin/startup.sh  bin/stop.sh

注意：这里提到一个nid，这是node唯一的标识 我们如何得到这个nid的标识号呢？这个在manager上面添加的node产生的，下面会提到。这个nid文件需要在node的conf目录；也是只是添加标识号即可。nid位于conf目录下。