5分钟起步

zbus一般场景都是分布式运行,首先需要启动消息队列服务器,然后运行客户端程序(生产者、消费者,RPC服务提供方、RPC服务调用方)。zbus也支持嵌入式方式,队列服务器与客户端程序(JAVA)同时启动(具体参考项目示例)。

服务器

zbus服务器依赖JDK6+,如未安装,请先下载安装

JDK下载

zbus下载

快速启动: 在zbus-dist/bin 目录下执行zbus.bat(windows) 或者zbus.sh(linux/mac),即刻完成 (备注:zbus2.bat, zbus2.sh 为高可用快速启动验证)

正常启动后,可以直接访问本地监控 http://localhost:15555 , 下图仅为示例,第一次启动默认队列主题为空,客户端会自动增加队列(权限控制)

Monitor

常见问题

JVM运行参数调优

默认启动最大1G内存配置,参数调优可根据实际条件改变下面设置, zbus.bat/.sh

-server -Xms64m -Xmx1024m -XX:+UseParallelGC

个性化配置

改变zbus-dist/conf 目录下zbus.xml

<zbus compatible="false">   <!-- Enable compatible to zbus7 -->   
    <serverHost>0.0.0.0</serverHost>  
    <serverPort>15555</serverPort>  
    <serverName></serverName> <!-- 阿里云等主机需要配置外部IP地址或者域名,才能正常使用 -->   

    <!-- 启用SSL, 证书文件放在classpath即可-->
    <sslEnabled certFile="ssl/zbus.crt" keyFile="ssl/zbus.key">false</sslEnabled> 

    <mqPath>/tmp/zbus</mqPath> <!--队列存放路径-->

    <verbose>false</verbose>   

    <trackerOnly>false</trackerOnly> 
    <cleanMqInterval>3000</cleanMqInterval> <!-- Milliseconds -->
    <reportToTrackerInterval>30000</reportToTrackerInterval> <!-- Milliseconds -->

    <!-- 高可用时才需要配置Tracker的地址列表
    <trackerList>
        <serverAddress>
            <address>localhost:15556</address>  
            <sslEnabled certFile="ssl/zbus.crt">false</sslEnabled> 
            <token></token>
        </serverAddress>   
    </trackerList>  
    -->  

    <auth enabled="false" class="">  <!--启动Token权限控制时打开-->
        <token value="myrpc_all" operation="*"> 
            <topic value="MyRpc"/>
        </token>  
    </auth>
</zbus>