环境准备

  1. otter node会受otter manager进行管理,所以需要预先安装otter manager,参见:Otter Manager Quickstart.

  2. 完成manager安装后,需要在manager页面为node定义配置信息,并生一个唯一id.

    a. 首先访问manager页面的机器管理页面,点击添加机器按钮

Node_QuickStart - 图1 几点说明:

  • 机器名称:可以随意定义,方便自己记忆即可
  • 机器ip:对应node节点将要部署的机器ip,如果有多ip时,可选择其中一个ip进行暴露. (此ip是整个集群通讯的入口,实际情况千万别使用127.0.0.1,否则多个机器的node节点会无法识别)
  • 机器端口:对应node节点将要部署时启动的数据通讯端口,建议值:2088
  • 下载端口:对应node节点将要部署时启动的数据下载端口,建议值:9090
  • 外部ip :对应node节点将要部署的机器ip,存在的一个外部ip,允许通讯的时候走公网处理。
  • zookeeper集群:为提升通讯效率,不同机房的机器可选择就近的zookeeper集群.
    node这种设计,是为解决单机部署多实例而设计的,允许单机多node指定不同的端口
  1. b. 机器添加完成后,跳转到机器列表页面,获取对应的机器序号nid

Node_QuickStart - 图2

通过这两部操作,获取到了node节点对应的唯一标示,称之为node id,简称:nid. 记录该nid,后续启动nid时会使用

  1. 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版本为例子:

  1. wget https://github.com/alibaba/otter/releases/download/otter-x.y.z/node.deployer-x.y.z.tar.gz

or

  1. 自己编译
  1. git clone git@github.com:alibaba/otter.git
  2. cd otter;
  3. mvn clean install -Dmaven.test.skip -Denv=release

编译完成后,会在根目录下产生target/node.deployer-$version.tar.gz

  1. 解压缩
  1. mkdir /tmp/node
  2. tar zxvf node.deployer-$version.tar.gz -C /tmp/node
  1. 配置修改

    a. nid配置 (将环境准备中添加机器后获取到的序号,保存到conf目录下的nid文件,比如我添加的机器对应序号为1)

  1. echo 1 > conf/nid
  1. b. otter.properties配置修改
  1. # otter node root dir
  2. otter.nodeHome = ${user.dir}/../node
  3. ## otter node dir
  4. otter.htdocs.dir = ${otter.nodeHome}/htdocs
  5. otter.download.dir = ${otter.nodeHome}/download
  6. otter.extend.dir= ${otter.nodeHome}/extend
  7. default zookeeper sesstion timeout = 90s

  8. otter.zookeeper.sessionTimeout = 90000

  9. otter communication pool size

  10. otter.communication.pool.size = 10

  11. otter arbitrate & node connect manager config 修改为正确的manager服务地址

  12. otter.manager.address = 127.0.0.1:1099

  1. 准备启动
  1. sh startup.sh
  1. 查看日志

    如果manager页面的ip配置不正确,会出现类似错误:

    打开日志: vi logs/node/node.log

  1. 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!
  2. at com.alibaba.otter.node.etl.OtterController.checkNidVaild(OtterController.java:245)
  3. at com.alibaba.otter.node.etl.OtterController.initNid(OtterController.java:230)
  4. at com.alibaba.otter.node.etl.OtterController.start(OtterController.java:73)
  5. at com.alibaba.otter.node.deployer.OtterLauncher.main(OtterLauncher.java:25)

此时修改ip为对应的host ip后,再次启动即可。

  1. vi logs/node/node.log
  1. 2013-08-14 15:42:16.886 [main] INFO com.alibaba.otter.node.deployer.OtterLauncher - INFO ## the otter server is running now ......

看到如下日志,代表node启动完成.

  1. 验证

    访问: http://127.0.0.1:8080/node_list.htm,查看对应的节点状态,如果变为了已启动,代表已经正常启动。(ps,如果是未启动,会是一个红色高亮)

Node_QuickStart - 图3

  1. 关闭
  1. sh stop.sh

关闭后,可查看下manager页面,检查下节点状态.

it's over.

原文: https://github.com/alibaba/otter/wiki/Node_Quickstart