备注：
笔者单机环境搭建过程参照：Quick Start-github-alibaba/RocketMQ，本篇文章为Quick Start的解释和补充，为了您更好的理解，请参照Quick Start阅读。
###安装环境
您需要安装以下软件：
- 64位操作系统，最好有Linux / Unix / Mac;
- 64bit JDK 1.6+;
- Maven 3.x
- Git
- screen(方便后台运行服务，不安装也可以)
笔者环境：
- Centos 7.X
- RocketMQ 3.5.9
通过yum一键安装，首先保证联网，ping通
yum install git // 安装git
yum install java //安装JDK
// 安装maven，如果执行yum install apache-maven提示报错，输入第一行命令-wget
wget http://repos.fedorapeople.org/repos/dchen/apache-maven/epel-apache-maven.repo -O /etc/yum.repos.d/epel-apache-maven.repo
yum -y install apache-maven
yum install screen // screen安装
- yum默认安装的jdk是open jdk，经笔者测试open jdk同样可用，只要保证jdk唯一就行。
- 建议maven和jdk统一采用yum安装，因为maven依赖java环境，如果环境为oracle jdk而yum默认安装的maven依赖的是open jdk，后面会遇到冲突问题。
- screen的作用是方便后台运行namesrv或broker服务，其他文章里时常可以遇到
nohup命令，或者./xx服务 &都是类似的作用。
###Clone & Build
打开终端，去某个有权限创建文件和文件夹的地方
- git clone https://github.com/alibaba/RocketMQ.git
- cd RocketMQ
- bash install.sh
耐心等待，安装成功后可以看到devenv文件夹，内含所有必须的文件和库。其实这个文件是 /RocketMQ/target/alibaba-xxxx的快捷方式
###环境变量
确保正确设置以下环境变量：JAVA_HOME
jdk环境会对安装造成很大影响，请保证单一jdk使用环境
现在设置ROCKETMQ_HOME环境变量：
cd devenv //进到devenv文件夹
echo "ROCKETMQ_HOME=`pwd`" >> ~/.bash_profile //将当前路径赋予全局常量写到.bash_profile中，方便后面调用
使新环境变量生效：
source ~/.bash_profile
###启动RocketMQ name server和broker
在devenv目录下cd bin
- 启动Name Server服务(前文比喻的信号塔)
screen bash mqnamesrv
或者在bin目录，直接使用
./mqnamesrv &
如果您看到```The Name Server boot success. serializeType=JSON```，这意味着名称服务器成功启动。按```Ctrl + A```，然后按```D```断开会话。
* 启动Broker服务
screen bash mqbroker -n localhost:9876 //-n 是mqbroker服务一个可选参数，意为选择nameserver地址，此处默认本机ip，端口9876
如果看到如下输出：
>broker[xxxxx-Lenovo，172.30.30.233:10911]启动成功。 serializeType = JSON和名称服务器是localhost：9876
表示Broker成功启动，Broker默认的端口10911，可以在broker.properties中修改
您还可以检查日志文件以验证如下：
tail -f ~/logs/rocketmqlogs/broker.log
检查是否有类似于续集文本的心跳事件：
>2016-xx-xx xx:xx:xx INFO BrokerControllerScheduledThread1 - 注册broker到名称服务器localhost：9876 OK
还可以输入命令```jps```查询当前java进程，此时应该可以看到**NamesrvStartup**,**BrokerStartup**，说明上述两个服务成功启动了
###Send & Receive Messages
在发送/接收消息之前，我们需要告诉客户端名称服务器所在的位置。为了简单起见，我们使用环境变量`NAMESRV_ADDR`，（producer/consumer初始化时会调用NAMESRV_ADDR，设置成环境变量或者代码里直接声明都可以）
export NAMESRV_ADDR = localhost:9876
现在我们准备好发送/接收消息。
bash tools.sh com.alibaba.rocketmq.example.quickstart.Productcer
你会看到几百条消息被发送给broker。
要使用刚刚在上一步中发送的消息，
bash tools.sh com.alibaba.rocketmq.example.quickstart.Consumer
到此单机环境搭建成功，并成功启动了Producer和Consumer进行了消息收发的测试。
***
### 下面开始划重点
>nameserver端口默认为：9876
>broker监听端口默认为：10911
接着[（一）RockeMQ初步认知](www.xxxx.com)中的介绍的四个角色，根据本章实践复习和补充下：
**Producer：**
* 一般由业务系统产生消息，通过topic来标示
* 存在Producer Group的概念（后文涉及）
**Consumer：**
* 有两种实现方式，一种push Consumer，第二种是 pull Consumer。
* 本章启动的示例Consumer为push consumer。在consumer对象注册一个listener接口，一接收到消息，consumer对象立刻回调 Listener方法。
* push Consumer和pull Consumer的区别简单理解：两者基本原理相同，push是封装好了，傻瓜调用。pull需要自主实现，由应用控制。（深入研究后再行补充）
* 存在Consumer Group的概念（后文涉及）
**Broker**：
* 消息中转角色，负责存储消息，转发消息。
* 拥有Master、slave（主备）的概念，主备有同步复制、异步双写功能来保持数据同步（未深研）。标识：Master的BrokerId 为 0 ，Slave的BrokerId 非0。
* 部署模式：
* 单Master无Slave（脆弱）
* 单Master多Slave（单点故障就瘫，开源版无主备切换功能）
* 多Master无Slave（无单点故障，线上生产常用模式）
* 多Master多Slave（无单点故障）
* Broker 与 Name Server 集群中的**所有节点建立长连接**，定时（心跳）注册 Topic 信息到所有 Name Server。
**Name Server**：
* 无状态节点，可集群部署，**节点之间无任何信息同步**（Broker与每个namesrv连接，可以保证信息同步性）
----------
##FAQ
1. 本地网络连接正常，（linux）联网失败，ping不通？
**解决方案**：修改 /etc/resolv.conf dns 文件 添加 nameserver 8.8.8.8 && 8.8.4.4
2. Directory '/var/run/screen' must have mode 777，执行screen命令提示权限不足？
**现象描述**：
**解决方案**：`chmod -R 777 /var/run/screen` 赋予报错中的文件路径以777权限，`-R`对其子文件也生效
3. 启动 mqnamesrv / mqbroker服务报错，显示内存不够，需大于2G？
**现象描述**：
"_VM warning: INFO: OS::commit_memory(0x00000006c0000000, 2147483648, 0) faild; error='Cannot allocate memory' (errno=12)_"
**解决方案**：修改`/RocketMQ/devnev/bin/` 下的服务启动脚本 `runserver.sh` 、`runbroker.sh` 中对于内存的限制，改成如下示例：
JAVA_OPT="${JAVA_OPT} -server -Xms128m -Xmx128m -Xmn128m -XX:PermSize=128m -XX:MaxPermSize=128m"
4. UseCMSComactAtFullCollection is deprecated and will likely be removed in a future release.java.net.BindException: 地址正在使用？
**问题原因**：上述情况是系统存在多个Jdk同时使用导致的，如本文开头安装maven时讲到的冲突问题
**解决方案**：删除/停止多余jdk，__保证系统使用唯一jdk源__。
5. 启动Broker遇到提示cannot stat '/root/rmq_bk_gc.log':No such file or directory：
cp:cannot stat '/root/rmq_bk_gc.log':No such file or directory OpenJDK 64-Bit Server VM warning: Cannot open file /root/tmpfs/logs/gc.log due to No such file or directory
**解答**：经测试，上叙情况不会影响Broker的正常启动，出现此提示请耐心等待Broker服务启动。如图所示：
6. 待补充，欢迎留言~~~
1755
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
