单机节点

准备

官网下载http://rocketmq.apache.org/docs/quick-start
rocketmq-all-4.7.0-bin-release.zip上传服务器
解压 unzip rocketmq-all-4.7.0-bin-release.zip
rocketmq-all-4.7.0-bin-release

配置

如果您的主机是服务器请忽略，虚拟机需要 vi /bin/runbroker.sh 调整参数（不然启动会内存不足）

#JAVA_OPT="${JAVA_OPT} -server -Xms8g -Xmx8g -Xmn4m"
JAVA_OPT="${JAVA_OPT} -server -Xms1g -Xmx1g -Xmn521m"

vi runserver.sh

#AVA_OPT="${JAVA_OPT} -server -Xms4g -Xmx4g -Xmn2g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"
AVA_OPT="${JAVA_OPT} -server -Xms1g -Xmx1g -Xmn512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"

启动

启动nameserver

nohup sh mqnamesrv &

查看mqnamesrv 启动日志

tail -f ~/logs/rocketmqlogs/namesrv.log】

启动rocketmq

nohup sh mqbroker -n 10.0.61.49:9876 &
查看rocketmq启动日志
tail -f ~/logs/rocketmqlogs/broker.log

关闭服务

sh bin/mqshutdown broker
The mqbroker(36695) is running…
Send shutdown request to mqbroker(36695) OK

sh bin/mqshutdown namesrv
The mqnamesrv(36664) is running…
Send shutdown request to mqnamesrv(36664) OK

集群搭建

总的来说rocket 的集群就是在启动的时候通过不同的配置文件，实现集群节点的定义
conf目录下

drwxr-xr-x. 2 root root   118 Mar  4 01:59 2m-2s-async //多Master多Slave模式-异步复制
drwxr-xr-x. 2 root root   118 Mar  4 01:59 2m-2s-sync 多Master多Slave模式-同步双写
drwxr-xr-x. 2 root root    91 Mar  4 01:59 2m-noslave //多Master模式
-rw-r--r--. 1 root root   949 May 22 10:25 broker.conf
drwxr-xr-x. 2 root root    72 Mar  4 01:59 dledger
-rw-r--r--. 1 root root 14978 Mar  4 01:59 logback_broker.xml
-rw-r--r--. 1 root root  3836 Mar  4 01:59 logback_namesrv.xml
-rw-r--r--. 1 root root  3761 Mar  4 01:59 logback_tools.xml
-rw-r--r--. 1 root root  1305 Mar  4 01:59 plain_acl.yml
-rw-r--r--. 1 root root   834 Mar  4 01:59 tools.yml

默认执行的是broker.conf

准备

先配置两台主机，一主一从 2m-2s-async 多Master多Slave模式-异步复制
Ip brokerName 用途 角色
10.10.61.34 Broker1 NameServer ,Broker Master
10.10.61.49 Broker1 NameServer ,Broker Slave

修改配置

10.10.61.34 Master
vi broker-a.properties

namesrvAddr=10.10.61.34:9876;10.10.61.49:9876
brokerIP1=10.10.61.34
brokerName=Broker1
brokerClusterName=Cluster
brokerId=0
autoCreateTopicEnable=true
autoCreateSubscriptionGroup=true
rejectTransactionMessage=false
fetchNamesrvAddrByAddressServer=false
storePathRootDir=/root/store
storePathCommitLog=/root/store/commitlog
flushIntervalCommitLog=1000
flushCommitLogTimed=false
deleteWhen=04
fileReservedTime=72
maxTransferBytesOnMessageInMemory=262144
maxTransferCountOnMessageInMemory=32
maxTransferBytesOnMessageInDisk=65536
maxTransferCountOnMessageInDisk=8
accessMessageInMemoryMaxRatio=40
messageIndexEnable=true
messageIndexSafe=false
haMasterAddress=
brokerRole=ASYNC_MASTER
flushDiskType=ASYNC_FLUSH
cleanFileForciblyEnable=true

10.10.61.49 Slave
vi broker-a-s.properties

namesrvAddr=10.10.61.34:9876;10.10.61.49:9876
brokerIP1=10.10.61.49
brokerName=Broker1
brokerClusterName=Cluster
brokerId=1
autoCreateTopicEnable=true
autoCreateSubscriptionGroup=true
rejectTransactionMessage=false
fetchNamesrvAddrByAddressServer=false
storePathRootDir=/root/store
storePathCommitLog=/root/store/commitlog
flushIntervalCommitLog=1000
flushCommitLogTimed=false
deleteWhen=04
fileReservedTime=72
maxTransferBytesOnMessageInMemory=262144
maxTransferCountOnMessageInMemory=32
maxTransferBytesOnMessageInDisk=65536
maxTransferCountOnMessageInDisk=8
accessMessageInMemoryMaxRatio=40
messageIndexEnable=true
messageIndexSafe=false
haMasterAddress=
brokerRole=SLAVE
flushDiskType=ASYNC_FLUSH
cleanFileForciblyEnable=true

另外两台一主一从
并加入到namesrvAddr，就可以变成四台主机

启动

cd 到 bin目录
sh play.sh 或者 nohup sh mqnameserv &
通过运行jps查看服务启动情况

23409 NamesrvStartup
15868 Jps

没有broker信息
10.10.61.34 Master启动

nohup sh mqbroker -c ../conf/2m-2s-async/broker-a.properties &

tail -f nohup.out

The broker[Broker1, 10.0.61.49:10911] boot success. serializeType=JSON and name server is 10.0.61.34:9876;10.0.61.49:9876

10.10.61.49 Slave 启动

nohup sh mqbroker -c ../conf/2m-2s-async/broker-a-s.properties &

jps 查看

[root@rabbit2 bin]# jps
17986 Jps
16613 NamesrvStartup
17926 BrokerStartup

查看集群

# bin/mqadmin help ClusterList
usage: mqadmin clusterList [-h] [-i <arg>] [-m] [-n <arg>]
 -h,--help                Print help
 -i,--interval <arg>      specify intervals numbers, it is in seconds
 -m,--moreStats           Print more stats
 -n,--namesrvAddr <arg>   Name server address list, eg: 192.168.0.1:9876;192.168.0.2:9876

sh mqadmin clusterList -n 10.10.61.34:9876;10.10.61.49:9876
一般会有报错信息

RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
org.apache.rocketmq.tools.command.SubCommandException: ClusterListSubCommand command failed
       at org.apache.rocketmq.tools.command.cluster.ClusterListSubCommand.execute(ClusterListSubCommand.java:93)
       at org.apache.rocketmq.tools.command.MQAdminStartup.main0(MQAdminStartup.java:139)
       at org.apache.rocketmq.tools.command.MQAdminStartup.main(MQAdminStartup.java:90)
Caused by: org.apache.rocketmq.acl.common.AclException: [10015:signature-failed] unable to calculate a request signature. error=[10015:signature-failed] unable to calculate a request signature. error=Algorithm HmacSHA1 not available
       at org.apache.rocketmq.acl.common.AclSigner.signAndBase64Encode(AclSigner.java:84)
       at org.apache.rocketmq.acl.common.AclSigner.calSignature(AclSigner.java:73)
       at org.apache.rocketmq.acl.common.AclSigner.calSignature(AclSigner.java:68)
       at org.apache.rocketmq.acl.common.AclUtils.calSignature(AclUtils.java:69)
       at org.apache.rocketmq.acl.common.AclClientRPCHook.doBeforeRequest(AclClientRPCHook.java:44)
       at org.apache.rocketmq.remoting.netty.NettyRemotingAbstract.doBeforeRpcHooks(NettyRemotingAbstract.java:172)
       at org.apache.rocketmq.remoting.netty.NettyRemotingClient.invokeSync(NettyRemotingClient.java:368)
       at org.apache.rocketmq.client.impl.MQClientAPIImpl.getBrokerClusterInfo(MQClientAPIImpl.java:1339)
       at org.apache.rocketmq.tools.admin.DefaultMQAdminExtImpl.examineBrokerClusterInfo(DefaultMQAdminExtImpl.java:306)
       at org.apache.rocketmq.tools.admin.DefaultMQAdminExt.examineBrokerClusterInfo(DefaultMQAdminExt.java:251)
       at org.apache.rocketmq.tools.command.cluster.ClusterListSubCommand.printClusterBaseInfo(ClusterListSubCommand.java:172)
       at org.apache.rocketmq.tools.command.cluster.ClusterListSubCommand.execute(ClusterListSubCommand.java:88)
       ... 2 more
Caused by: org.apache.rocketmq.acl.common.AclException: [10015:signature-failed] unable to calculate a request signature. error=Algorithm HmacSHA1 not available
       at org.apache.rocketmq.acl.common.AclSigner.sign(AclSigner.java:63)
       at org.apache.rocketmq.acl.common.AclSigner.signAndBase64Encode(AclSigner.java:79)
       ... 13 more
Caused by: java.security.NoSuchAlgorithmException: Algorithm HmacSHA1 not available
       at javax.crypto.Mac.getInstance(Mac.java:181)
       at org.apache.rocketmq.acl.common.AclSigner.sign(AclSigner.java:57)
       ... 14 more

查看mqadmin，发现其 调用tools.sh，启动配置JAVA环境。该报错是因为缺少ext目录，在tools.sh内添加
find / -name ‘ext’ |grep jdk
/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.252.b09-2.el7_8.x86_64/jre/lib/ext
将其添加到原先配置上

JAVA_OPT="${JAVA_OPT} -Djava.ext.dirs=${BASE_DIR}/lib:${JAVA_HOME}/jre/lib/ext:${JAVA_HOME}/lib/ext:/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.252.b09-2.el7_8.x86_64/jre/lib/ext"

重新执行mqadmin
sh mqadmin clusterList -n 10.10.61.34:9876

[root@rabbit1 bin]# sh mqadmin clusterList -n 10.0.61.34:9876;10.0.61.49:9876
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
#Cluster Name     #Broker Name            #BID  #Addr                  #Version                #InTPS(LOAD)       #OutTPS(LOAD) #PCWait(ms) #Hour #SPACE
AresCluster       AresBroker1             0     10.0.61.34:10911       V4_7_0                   0.00(0,0ms)         0.00(0,0ms)          0 441723.93 0.1184
AresCluster       AresBroker1             1     10.0.61.49:10911       V4_7_0                   0.00(0,0ms)         0.00(0,0ms)          0 441723.93 0.1176
-bash: 10.0.61.49:9876: command not found

java 层面测试集群

消费端 连接 10.10.61.34:9876节点 消费消息

public class Customer {
    public static void main(String[] args) throws MQClientException, RemotingException, InterruptedException, MQBrokerException {
        DefaultMQPushConsumer customer= new DefaultMQPushConsumer("gc_rocket_cum_test");
        // customer.setNamesrvAddr("10.10.61.34:9876;10.10.61.49:9876");
        customer.setNamesrvAddr("10.10.61.34:9876");
        customer.subscribe("test","*");
        customer.registerMessageListener(new MessageListenerConcurrently() {
            public ConsumeConcurrentlyStatus consumeMessage(List<MessageExt> msgs, ConsumeConcurrentlyContext consumeConcurrentlyContext) {
                System.out.printf("%s Receive New Messages: %s %n", Thread.currentThread().getName(), msgs);
                return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
            }
        });
          customer.start();
        System.out.println("消费者已启动");
    }
}

生产端 连接 10.0.61.49:9876节点 产生消息

public class Producer {
    public static void main(String[] args) throws MQClientException, RemotingException, InterruptedException, MQBrokerException, UnsupportedEncodingException {
        DefaultMQProducer producer =new DefaultMQProducer("gc_rocket_prd_test");
        //producer.setNamesrvAddr("10.0.61.34:9876;10.0.61.49:9876");
        producer.setNamesrvAddr("10.0.61.49:9876");
        producer.start();
        for (int i=0;i<100;i++)
        {
            Message msg=new Message("test","", ("TEST ROCKET MQ "+i).getBytes(RemotingHelper.DEFAULT_CHARSET));
            SendResult sendResult=producer.send(msg);
            System.out.printf("%s%n", sendResult);
        }
        producer.shutdown();
        System.out.println("生产者结束发送");
    }
}

可以实现消息发送消费

web管理界面

https://github.com/apache/rocketmq-externals 下载项目rocketmq-console,配置nameserver
java -jar启动服务
访问
http://10.10.61.34:8080/rocketmq-console/cluster/list.do

官网文档

详见官网指定的github，中文文档非常全
官方文档https://github.com/apache/rocketmq/blob/master/docs/cn/operation.md

我直接copy一份
============================================
1 集群搭建
1.1 单Master模式
这种方式风险较大，一旦Broker重启或者宕机时，会导致整个服务不可用。不建议线上环境使用,可以用于本地测试。

1）启动 NameServer
### 首先启动Name Server
$ nohup sh mqnamesrv &
 
### 验证Name Server 是否启动成功
$ tail -f ~/logs/rocketmqlogs/namesrv.log
The Name Server boot success...
2）启动 Broker
### 启动Broker
$ nohup sh bin/mqbroker -n localhost:9876 &

### 验证Name Server 是否启动成功，例如Broker的IP为：192.168.1.2，且名称为broker-a
$ tail -f ~/logs/rocketmqlogs/Broker.log 
The broker[broker-a, 192.169.1.2:10911] boot success...
1.2 多Master模式
一个集群无Slave，全是Master，例如2个Master或者3个Master，这种模式的优缺点如下：

优点：配置简单，单个Master宕机或重启维护对应用无影响，在磁盘配置为RAID10时，即使机器宕机不可恢复情况下，由于RAID10磁盘非常可靠，消息也不会丢（异步刷盘丢失少量消息，同步刷盘一条不丢），性能最高；

缺点：单台机器宕机期间，这台机器上未被消费的消息在机器恢复之前不可订阅，消息实时性会受到影响。

1）启动NameServer
NameServer需要先于Broker启动，且如果在生产环境使用，为了保证高可用，建议一般规模的集群启动3个NameServer，各节点的启动命令相同，如下：

### 首先启动Name Server
$ nohup sh mqnamesrv &
 
### 验证Name Server 是否启动成功
$ tail -f ~/logs/rocketmqlogs/namesrv.log
The Name Server boot success...
2）启动Broker集群
### 在机器A，启动第一个Master，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-noslave/broker-a.properties &
 
### 在机器B，启动第二个Master，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-noslave/broker-b.properties &

...
如上启动命令是在单个NameServer情况下使用的。对于多个NameServer的集群，Broker启动命令中-n后面的地址列表用分号隔开即可，例如 192.168.1.1:9876;192.161.2:9876。

1.3 多Master多Slave模式-异步复制
每个Master配置一个Slave，有多对Master-Slave，HA采用异步复制方式，主备有短暂消息延迟（毫秒级），这种模式的优缺点如下：

优点：即使磁盘损坏，消息丢失的非常少，且消息实时性不会受影响，同时Master宕机后，消费者仍然可以从Slave消费，而且此过程对应用透明，不需要人工干预，性能同多Master模式几乎一样；

缺点：Master宕机，磁盘损坏情况下会丢失少量消息。

1）启动NameServer
### 首先启动Name Server
$ nohup sh mqnamesrv &
 
### 验证Name Server 是否启动成功
$ tail -f ~/logs/rocketmqlogs/namesrv.log
The Name Server boot success...
2）启动Broker集群
### 在机器A，启动第一个Master，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-2s-async/broker-a.properties &
 
### 在机器B，启动第二个Master，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-2s-async/broker-b.properties &
 
### 在机器C，启动第一个Slave，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-2s-async/broker-a-s.properties &
 
### 在机器D，启动第二个Slave，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-2s-async/broker-b-s.properties &
1.4 多Master多Slave模式-同步双写
每个Master配置一个Slave，有多对Master-Slave，HA采用同步双写方式，即只有主备都写成功，才向应用返回成功，这种模式的优缺点如下：

优点：数据与服务都无单点故障，Master宕机情况下，消息无延迟，服务可用性与数据可用性都非常高；

缺点：性能比异步复制模式略低（大约低10%左右），发送单个消息的RT会略高，且目前版本在主节点宕机后，备机不能自动切换为主机。

1）启动NameServer
### 首先启动Name Server
$ nohup sh mqnamesrv &
 
### 验证Name Server 是否启动成功
$ tail -f ~/logs/rocketmqlogs/namesrv.log
The Name Server boot success...
2）启动Broker集群
### 在机器A，启动第一个Master，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-2s-sync/broker-a.properties &
 
### 在机器B，启动第二个Master，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-2s-sync/broker-b.properties &
 
### 在机器C，启动第一个Slave，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-2s-sync/broker-a-s.properties &
 
### 在机器D，启动第二个Slave，例如NameServer的IP为：192.168.1.1
$ nohup sh mqbroker -n 192.168.1.1:9876 -c $ROCKETMQ_HOME/conf/2m-2s-sync/broker-b-s.properties &
以上Broker与Slave配对是通过指定相同的BrokerName参数来配对，Master的BrokerId必须是0，Slave的BrokerId必须是大于0的数。另外一个Master下面可以挂载多个Slave，同一Master下的多个Slave通过指定不同的BrokerId来区分。$ROCKETMQ_HOME指的RocketMQ安装目录，需要用户自己设置此环境变量。

2 mqadmin管理工具
注意：

执行命令方法：./mqadmin {command} {args}
几乎所有命令都需要配置-n表示NameServer地址，格式为ip:port
几乎所有命令都可以通过-h获取帮助
如果既有Broker地址（-b）配置项又有clusterName（-c）配置项，则优先以Broker地址执行命令，如果不配置Broker地址，则对集群中所有主机执行命令，只支持一个Broker地址。-b格式为ip:port，port默认是10911
在tools下可以看到很多命令，但并不是所有命令都能使用，只有在MQAdminStartup中初始化的命令才能使用，你也可以修改这个类，增加或自定义命令
由于版本更新问题，少部分命令可能未及时更新，遇到错误请直接阅读相关命令源码
2.1 Topic相关
名称	含义	命令选项	说明
updateTopic	创建更新Topic配置	-b	Broker 地址，表示 topic 所在 Broker，只支持单台Broker，地址为ip:port
-c	cluster 名称，表示 topic 所在集群（集群可通过 clusterList 查询）
-h-	打印帮助
-n	NameServer服务地址，格式 ip:port
-p	指定新topic的读写权限( W=2|R=4|WR=6 )
-r	可读队列数（默认为 8）
-w	可写队列数（默认为 8）
-t	topic 名称（名称只能使用字符 ^[a-zA-Z0-9_-]+$ ）
deleteTopic	删除Topic	-c	cluster 名称，表示删除某集群下的某个 topic （集群 可通过 clusterList 查询）
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-t	topic 名称（名称只能使用字符 ^[a-zA-Z0-9_-]+$ ）
topicList	查看 Topic 列表信息	-h	打印帮助
-c	不配置-c只返回topic列表，增加-c返回clusterName, topic, consumerGroup信息，即topic的所属集群和订阅关系，没有参数
-n	NameServer 服务地址，格式 ip:port
topicRoute	查看 Topic 路由信息	-t	topic 名称
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
topicStatus	查看 Topic 消息队列offset	-t	topic 名称
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
topicClusterList	查看 Topic 所在集群列表	-t	topic 名称
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
updateTopicPerm	更新 Topic 读写权限	-t	topic 名称
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-b	Broker 地址，表示 topic 所在 Broker，只支持单台Broker，地址为ip:port
-p	指定新 topic 的读写权限( W=2|R=4|WR=6 )
-c	cluster 名称，表示 topic 所在集群（集群可通过 clusterList 查询），-b优先，如果没有-b，则对集群中所有Broker执行命令
updateOrderConf	从NameServer上创建、删除、获取特定命名空间的kv配置，目前还未启用	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-t	topic，键
-v	orderConf，值
-m	method，可选get、put、delete
allocateMQ	以平均负载算法计算消费者列表负载消息队列的负载结果	-t	topic 名称
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-i	ipList，用逗号分隔，计算这些ip去负载Topic的消息队列
statsAll	打印Topic订阅关系、TPS、积累量、24h读写总量等信息	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-a	是否只打印活跃topic
-t	指定topic
2.2 集群相关
名称	含义	命令选项	说明
clusterList	查看集群信息，集群、BrokerName、BrokerId、TPS等信息	-m	打印更多信息 (增加打印出如下信息 #InTotalYest, #OutTotalYest, #InTotalToday ,#OutTotalToday)
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-i	打印间隔，单位秒
clusterRT	发送消息检测集群各Broker RT。消息发往${BrokerName} Topic。	-a	amount，每次探测的总数，RT = 总时间 / amount
-s	消息大小，单位B
-c	探测哪个集群
-p	是否打印格式化日志，以|分割，默认不打印
-h	打印帮助
-m	所属机房，打印使用
-i	发送间隔，单位秒
-n	NameServer 服务地址，格式 ip:port
2.3 Broker相关
名称	含义	命令选项	说明
updateBrokerConfig	更新 Broker 配置文件，会修改Broker.conf	-b	Broker 地址，格式为ip:port
-c	cluster 名称
-k	key 值
-v	value 值
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
brokerStatus	查看 Broker 统计信息、运行状态（你想要的信息几乎都在里面）	-b	Broker 地址，地址为ip:port
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
brokerConsumeStats	Broker中各个消费者的消费情况，按Message Queue维度返回Consume Offset，Broker Offset，Diff，TImestamp等信息	-b	Broker 地址，地址为ip:port
-t	请求超时时间
-l	diff阈值，超过阈值才打印
-o	是否为顺序topic，一般为false
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
getBrokerConfig	获取Broker配置	-b	Broker 地址，地址为ip:port
-n	NameServer 服务地址，格式 ip:port
wipeWritePerm	从NameServer上清除 Broker写权限	-b	Broker 地址，地址为ip:port
-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
cleanExpiredCQ	清理Broker上过期的Consume Queue，如果手动减少对列数可能产生过期队列	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
-b	Broker 地址，地址为ip:port
-c	集群名称
cleanUnusedTopic	清理Broker上不使用的Topic，从内存中释放Topic的Consume Queue，如果手动删除Topic会产生不使用的Topic	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
-b	Broker 地址，地址为ip:port
-c	集群名称
sendMsgStatus	向Broker发消息，返回发送状态和RT	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
-b	BrokerName，注意不同于Broker地址
-s	消息大小，单位B
-c	发送次数
2.4 消息相关
名称	含义	命令选项	说明
queryMsgById	根据offsetMsgId查询msg，如果使用开源控制台，应使用offsetMsgId，此命令还有其他参数，具体作用请阅读QueryMsgByIdSubCommand。	-i	msgId
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
queryMsgByKey	根据消息 Key 查询消息	-k	msgKey
-t	Topic 名称
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
queryMsgByOffset	根据 Offset 查询消息	-b	Broker 名称，（这里需要注意 填写的是 Broker 的名称，不是 Broker 的地址，Broker 名称可以在 clusterList 查到）
-i	query 队列 id
-o	offset 值
-t	topic 名称
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
queryMsgByUniqueKey	根据msgId查询，msgId不同于offsetMsgId，区别详见常见运维问题。-g，-d配合使用，查到消息后尝试让特定的消费者消费消息并返回消费结果	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-i	uniqe msg id
-g	consumerGroup
-d	clientId
-t	topic名称
checkMsgSendRT	检测向topic发消息的RT，功能类似clusterRT	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-t	topic名称
-a	探测次数
-s	消息大小
sendMessage	发送一条消息，可以根据配置发往特定Message Queue，或普通发送。	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-t	topic名称
-p	body，消息体
-k	keys
-c	tags
-b	BrokerName
-i	queueId
consumeMessage	消费消息。可以根据offset、开始&结束时间戳、消息队列消费消息，配置不同执行不同消费逻辑，详见ConsumeMessageCommand。	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-t	topic名称
-b	BrokerName
-o	从offset开始消费
-i	queueId
-g	消费者分组
-s	开始时间戳，格式详见-h
-d	结束时间戳
-c	消费多少条消息
printMsg	从Broker消费消息并打印，可选时间段	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-t	topic名称
-c	字符集，例如UTF-8
-s	subExpress，过滤表达式
-b	开始时间戳，格式参见-h
-e	结束时间戳
-d	是否打印消息体
printMsgByQueue	类似printMsg，但指定Message Queue	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-t	topic名称
-i	queueId
-a	BrokerName
-c	字符集，例如UTF-8
-s	subExpress，过滤表达式
-b	开始时间戳，格式参见-h
-e	结束时间戳
-p	是否打印消息
-d	是否打印消息体
-f	是否统计tag数量并打印
resetOffsetByTime	按时间戳重置offset，Broker和consumer都会重置	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-g	消费者分组
-t	topic名称
-s	重置为此时间戳对应的offset
-f	是否强制重置，如果false，只支持回溯offset，如果true，不管时间戳对应offset与consumeOffset关系
-c	是否重置c++客户端offset
2.5 消费者、消费组相关
名称	含义	命令选项	说明
consumerProgress	查看订阅组消费状态，可以查看具体的client IP的消息积累量	-g	消费者所属组名
-s	是否打印client IP
-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
consumerStatus	查看消费者状态，包括同一个分组中是否都是相同的订阅，分析Process Queue是否堆积，返回消费者jstack结果，内容较多，使用者参见ConsumerStatusSubCommand	-h	打印帮助
-n	NameServer 服务地址，格式 ip:port
-g	consumer group
-i	clientId
-s	是否执行jstack
updateSubGroup	更新或创建订阅关系	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
-b	Broker地址
-c	集群名称
-g	消费者分组名称
-s	分组是否允许消费
-m	是否从最小offset开始消费
-d	是否是广播模式
-q	重试队列数量
-r	最大重试次数
-i	当slaveReadEnable开启时有效，且还未达到从slave消费时建议从哪个BrokerId消费，可以配置备机id，主动从备机消费
-w	如果Broker建议从slave消费，配置决定从哪个slave消费，配置BrokerId，例如1
-a	当消费者数量变化时是否通知其他消费者负载均衡
deleteSubGroup	从Broker删除订阅关系	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
-b	Broker地址
-c	集群名称
-g	消费者分组名称
cloneGroupOffset	在目标群组中使用源群组的offset	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
-s	源消费者组
-d	目标消费者组
-t	topic名称
-o	暂未使用
2.6 连接相关
名称	含义	命令选项	说明
consumerConnec tion	查询 Consumer 的网络连接	-g	消费者所属组名
-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
producerConnec tion	查询 Producer 的网络连接	-g	生产者所属组名
-t	主题名称
-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
2.7 NameServer相关
名称	含义	命令选项	说明
updateKvConfig	更新NameServer的kv配置，目前还未使用	-s	命名空间
-k	key
-v	value
-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
deleteKvConfig	删除NameServer的kv配置	-s	命名空间
-k	key
-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
getNamesrvConfig	获取NameServer配置	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
updateNamesrvConfig	修改NameServer配置	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
-k	key
-v	value
2.8 其他
名称	含义	命令选项	说明
startMonitoring	开启监控进程，监控消息误删、重试队列消息数等	-n	NameServer 服务地址，格式 ip:port
-h	打印帮助
3 运维常见问题
3.1 RocketMQ的mqadmin命令报错问题
问题描述：有时候在部署完RocketMQ集群后，尝试执行“mqadmin”一些运维命令，会出现下面的异常信息：

org.apache.rocketmq.remoting.exception.RemotingConnectException: connect to <null> failed
解决方法：可以在部署RocketMQ集群的虚拟机上执行export NAMESRV_ADDR=ip:9876（ip指的是集群中部署NameServer组件的机器ip地址）命令之后再使用“mqadmin”的相关命令进行查询，即可得到结果。

3.2 RocketMQ生产端和消费端版本不一致导致不能正常消费的问题
问题描述：同一个生产端发出消息，A消费端可消费，B消费端却无法消费，rocketMQ Console中出现：

Not found the consumer group consume stats, because return offset table is empty, maybe the consumer not consume any message的异常消息。
解决方案：RocketMQ 的jar包：rocketmq-client等包应该保持生产端，消费端使用相同的version。

3.3 新增一个topic的消费组时，无法消费历史消息的问题
问题描述：当同一个topic的新增消费组启动时，消费的消息是当前的offset的消息，并未获取历史消息。

解决方案：rocketmq默认策略是从消息队列尾部，即跳过历史消息。如果想消费历史消息，则需要设置：org.apache.rocketmq.client.consumer.DefaultMQPushConsumer#setConsumeFromWhere。常用的有以下三种配置：

默认配置,一个新的订阅组第一次启动从队列的最后位置开始消费，后续再启动接着上次消费的进度开始消费,即跳过历史消息；
consumer.setConsumeFromWhere(ConsumeFromWhere.CONSUME_FROM_LAST_OFFSET);
一个新的订阅组第一次启动从队列的最前位置开始消费，后续再启动接着上次消费的进度开始消费,即消费Broker未过期的历史消息；
consumer.setConsumeFromWhere(ConsumeFromWhere.CONSUME_FROM_FIRST_OFFSET);
一个新的订阅组第一次启动从指定时间点开始消费，后续再启动接着上次消费的进度开始消费，和consumer.setConsumeTimestamp()配合使用，默认是半个小时以前；
consumer.setConsumeFromWhere(ConsumeFromWhere.CONSUME_FROM_TIMESTAMP);
3.4 如何开启从Slave读数据功能
在某些情况下，Consumer需要将消费位点重置到1-2天前，这时在内存有限的Master Broker上，CommitLog会承载比较重的IO压力，影响到该Broker的其它消息的读与写。可以开启slaveReadEnable=true，当Master Broker发现Consumer的消费位点与CommitLog的最新值的差值的容量超过该机器内存的百分比（accessMessageInMemoryMaxRatio=40%），会推荐Consumer从Slave Broker中去读取数据，降低Master Broker的IO。

3.5 性能调优问题
异步刷盘建议使用自旋锁，同步刷盘建议使用重入锁，调整Broker配置项useReentrantLockWhenPutMessage，默认为false；异步刷盘建议开启TransientStorePoolEnable；建议关闭transferMsgByHeap，提高拉消息效率；同步刷盘建议适当增大sendMessageThreadPoolNums，具体配置需要经过压测。

3.6 在RocketMQ中msgId和offsetMsgId的含义与区别
使用RocketMQ完成生产者客户端消息发送后，通常会看到如下日志打印信息：

SendResult [sendStatus=SEND_OK, msgId=0A42333A0DC818B4AAC246C290FD0000, offsetMsgId=0A42333A00002A9F000000000134F1F5, messageQueue=MessageQueue [topic=topicTest1, BrokerName=mac.local, queueId=3], queueOffset=4]
msgId，对于客户端来说msgId是由客户端producer实例端生成的，具体来说，调用方法MessageClientIDSetter.createUniqIDBuffer()生成唯一的Id；
offsetMsgId，offsetMsgId是由Broker服务端在写入消息时生成的（采用”IP地址+Port端口”与“CommitLog的物理偏移量地址”做了一个字符串拼接），其中offsetMsgId就是在RocketMQ控制台直接输入查询的那个messageId。