环境准备

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

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

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

几点说明：

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

b. 机器添加完成后，跳转到机器列表页面，获取对应的机器序号nid

通过这两部操作，获取到了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版本为例子：

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

1. 解压缩

mkdir /tmp/node
tar zxvf node.deployer-$version.tar.gz  -C /tmp/node  

1. 配置修改

   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

1. 准备启动

sh startup.sh

1. 查看日志

   如果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启动完成.

1. 验证

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

1. 关闭

sh stop.sh

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

it's over.

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