RocketMQ提供有控制台及一系列控制台命令,用于管理员对主题,集群,broker等信息的管理;
使用步骤
进入rocketmq目录下的bin目录,可以看到该目录下有个mqadmin脚本
常用命令
查看帮助:
sh mqadmin help 命令名称
例如,查看updateTopic的使用
sh mqadmin help updateTopic
创建(修改)topic
指令 |
updateTopic |
类路径 |
com.alibaba.rocketmq.tools.command.topic.UpdateTopicSubCommand |
||
参数 |
是否必填 |
说明 |
|||
-b |
如果 -c为空,则必填 |
broker地址,表示topic建在该broker |
|||
-c |
如果 -b为空,则必填 |
cluster名称,表示topic建在该集群(集群可通过clusterList查询) |
|||
-h |
否 |
打印帮助 |
|||
-n |
是 |
nameserve服务地址列表,格式ip:port;ip:port;... |
|||
-p |
否 |
指定新topic的权限限制( W|R|WR ) |
|||
-r |
否 |
可读队列数(默认为8) |
|||
-w |
否 |
可写队列数(默认为8) |
|||
-t |
是 |
topic名称(名称只能使用字符 ^[a-zA-Z0-9_-]+$ ) |
|||
举例 |
在集群DefaultCluster上创建主题ZTEExample,nameserve地址为10.45.47.168:9876 |
||||
sh mqadmin updateTopic –n 10.45.47.168:9876 –c DefaultCluster –t ZTEExample |
删除topic
指令 |
deleteTopic |
类路径 |
com.alibaba.rocketmq.tools.command.topic.DeleteTopicSubCommand |
||
参数 |
是否必填 |
说明 |
|||
-c |
是 |
cluster名称,表示删除某集群下的某个topic (集群可通过clusterList查询) |
|||
-h |
否 |
打印帮助 |
|||
-n |
是 |
nameserve服务地址列表,格式ip:port;ip:port;… |
|||
-t |
是 |
topic名称(名称只能使用字符 ^[a-zA-Z0-9_-]+$ ) |
|||
举例 |
在集群DefaultCluster上删除主题ZTEExample,nameserve地址为10.45.47.168:9876 |
||||
sh mqadmin deleteTopic –n 10.45.47.168:9876 –c DefaultCluster –t ZTEExample |
创建(修改)订阅组
指令 |
updateSubGroup |
类路径 |
com.alibaba.rocketmq.tools.command.consumer.UpdateSubGroupSubCommand |
||
参数 |
是否必填 |
说明 |
|||
-b |
如果 –c为空,则必填 |
broker地址,表示订阅组建在该broker |
|||
-c |
如果 –b为空,则必填 |
cluster名称,表示topic建在该集群(集群可通过clusterList查询) |
|||
-d |
否 |
是否容许广播方式消费 |
|||
-g |
是 |
订阅组名 |
|||
-i |
否 |
从哪个broker开始消费 |
|||
-m |
否 |
是否容许从队列的最小位置开始消费,默认会设置为false |
|||
-q |
否 |
消费失败的消息放到一个重试队列,每个订阅组配置几个重试队列 |
|||
-r |
否 |
重试消费最大次数,超过则投递到死信队列,不再投递,并报警 |
|||
-s |
否 |
消费功能是否开启 |
|||
-w |
否 |
发现消息堆积后,将Consumer的消费请求重定向到另外一台Slave机器 |
|||
-h |
否 |
打印帮助 |
|||
-n |
是 |
nameserve服务地址列表,格式ip:port;ip:port;... |
|||
举例 |
|
||||
|
删除订阅组配置
指令 |
deleteSubGroup |
类路径 |
com.alibaba.rocketmq.tools.command.consumer.DeleteSubscriptionGroupCommand |
||
参数 |
是否必填 |
说明 |
|||
-b |
如果 –c为空,则必填 |
broker地址,表示订阅组建在该broker |
|||
-c |
如果 –b为空,则必填 |
cluster名称,表示topic建在该集群(集群可通过clusterList查询) |
|||
-g |
是 |
订阅组名 |
|||
-h |
否 |
打印帮助 |
|||
-n |
是 |
nameserve服务地址列表,格式ip:port;ip:port;... |
|||
举例 |
|
||||
|
更新broker配置文件
指令 |
updateBrokerConfig |
类路径 |
com.alibaba.rocketmq.tools.command.broker.UpdateBrokerConfigSubCommand |
||
参数 |
是否必填 |
说明 |
|||
-b |
如果 –c为空,则必填 |