整体流程及视频
https://github.com/alibaba/otter/wiki/QuickStart
一、 manager安装
1. otter manager依赖于mysql进行配置信息的存储,所以需要预先安装mysql,并初始化otter manager的系统表结构
a. 安装mysql,这里不展开,网上一搜一大把
b. 初始化otter manager系统表:
下载:
wget https://raw.github.com/alibaba/otter/master/manager/deployer/src/main/resources/sql/otter-manager-schema.sql
载入:
source otter-manager-schema.sql
2. 整个otter架构依赖了zookeeper进行多节点调度,所以需要预先安装zookeeper,不需要初始化节点,otter程序启动后会自检.
a. manager需要在otter.properties中指定一个就近的zookeeper集群机器
1. 下载otter manager
直接下载 ,可访问:https://github.com/alibaba/otter/releases ,会列出所有历史的发布版本包下载方式,比如以x.y.z版本为例子:
wget https://github.com/alibaba/otter/releases/download/otter-x.y.z/manager.deployer-x.y.z.tar.gz
or
自己编译
git clone git@github.com:alibaba/otter.git
cd otter;
mvn clean install -Dmaven.test.skip -Denv=release
编译完成后,会在根目录下产生target/manager.deployer-$version.tar.gz
2. 解压缩
mkdir /tmp/manager
tar zxvf manager.deployer-$version.tar.gz -C /tmp/manager
3. 配置修改
## otter manager domain name #修改为正确访问ip,生成URL使用
otter.domainName = 127.0.0.1
## otter manager http port
otter.port = 8080
## 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
otter.database.driver.username = root
otter.database.driver.password = hello
## otter communication port
otter.communication.manager.port = 1099
## otter communication pool size
otter.communication.pool.size = 10
## default zookeeper address,修改为正确的地址,手动选择一个地域就近的zookeeper集群列表
otter.zookeeper.cluster.default = 127.0.0.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}
4. 准备启动
sh startup.sh
5. 查看日志
vi logs/manager.log
2013-08-14 13:19:45.911 [] WARN com.alibaba.otter.manager.deployer.JettyEmbedServer - ##Jetty Embed Server is startup!
2013-08-14 13:19:45.911 [] WARN com.alibaba.otter.manager.deployer.OtterManagerLauncher - ## the manager server is running now ......
出现类似日志,代表启动成功
6. 验证
访问: http://127.0.0.1:8080/,出现otter的页面,即代表启动成功
访问:http://127.0.0.1:8080/login.htm,初始密码为:admin/admin,即可完成登录. 目前:匿名用户只有只读查看的权限,登录为管理员才可以有操作权限
7. 关闭
sh stop.sh
it's over.
二、node安装
1. otter node会受otter manager进行管理,所以需要预先安装otter manager,参见:Otter Manager Quickstart.
2. 完成manager安装后,需要在manager页面为node定义配置信息,并生一个唯一id.
a. 首先访问manager页面的机器管理页面,点击添加机器按钮
几点说明:
node这种设计,是为解决单机部署多实例而设计的,允许单机多node指定不同的端口
b. 机器添加完成后,跳转到机器列表页面,获取对应的机器序号nid
通过这两部操作,获取到了node节点对应的唯一标示,称之为node id,简称:nid. 记录该nid,后续启动nid时会使用
3. node节点进行跨机房传输时,会使用到HTTP多线程传输技术,目前主要依赖了aria2c做为其下载客户端,后续会推出java版本.
a. aria2 官方首页: http://aria2.sourceforge.net/
b. 下载页面: http://sourceforge.net/projects/aria2/files/stable/
当前测试过多个HTTP多线程下载客户端,比如wget,curl,axel,oget,proz,aria2c,测试结果aria2c下载效率最快,基本可以压满网卡.
注意:下载完成或者编译完成后,将对应的aria2c包加入到PATH路径即可.
1. 下载otter node
直接下载 ,可访问:https://github.com/alibaba/otter/releases ,会列出所有历史的发布版本包下载方式,比如以x.y.z版本为例子:
wget https://github.com/alibaba/otter/releases/download/otter-x.y.z/node.deployer-x.y.z.tar.gz
or
自己编译
git clone git@github.com:alibaba/otter.git
cd otter;
mvn clean install -Dmaven.test.skip -Denv=release
编译完成后,会在根目录下产生target/node.deployer-$version.tar.gz
2. 解压缩
mkdir /tmp/node
tar zxvf node.deployer-$version.tar.gz -C /tmp/node
3. 配置修改
a. nid配置 (将环境准备中添加机器后获取到的序号,保存到conf目录下的nid文件,比如我添加的机器对应序号为1)
echo 1 > conf/nid
b. otter.properties配置修改
# otter node root dir
otter.nodeHome = ${user.dir}/../node
## 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 = 90s
otter.zookeeper.sessionTimeout = 90000
## otter communication pool size
otter.communication.pool.size = 10
## otter arbitrate & node connect manager config , 修改为正确的manager服务地址
otter.manager.address = 127.0.0.1:1099
4. 准备启动
sh startup.sh
5. 查看日志
如果manager页面的ip配置不正确,会出现类似错误:
打开日志: vi logs/node/node.log
Exception in thread "main" java.lang.IllegalArgumentException: node[1] ip[127.0.0.1] port[2088] , but your host ip[10.12.48.215] is not matched!
at com.alibaba.otter.node.etl.OtterController.checkNidVaild(OtterController.java:245)
at com.alibaba.otter.node.etl.OtterController.initNid(OtterController.java:230)
at com.alibaba.otter.node.etl.OtterController.start(OtterController.java:73)
at com.alibaba.otter.node.deployer.OtterLauncher.main(OtterLauncher.java:25)
此时修改ip为对应的host ip后,再次启动即可。
vi logs/node/node.log
2013-08-14 15:42:16.886 [main] INFO com.alibaba.otter.node.deployer.OtterLauncher - INFO ## the otter server is running now ......
看到如下日志,代表node启动完成.
6. 验证
访问: http://127.0.0.1:8080/node_list.htm,查看对应的节点状态,如果变为了已启动,代表已经正常启动。(ps,如果是未启动,会是一个红色高亮)
7. 关闭
sh stop.sh
关闭后,可查看下manager页面,检查下节点状态.
it's over.
两部分摘自
1、https://github.com/alibaba/otter/wiki/Manager_Quickstart
2、https://github.com/alibaba/otter/wiki/Node_Quickstart