ActiveMQ Getting Started

最新推荐文章于 2026-08-20 11:19:17 发布

转载最新推荐文章于 2026-08-20 11:19:17 发布 · 796 阅读

收录于

Java

ActiveMQ Getting Started 翻译

难度：入门级
译者：张丹 (Conan Zhang)
日期：2008-2-25

原文：http://activemq.apache.org/getting-started.html

ActiveMQ Getting Start

介绍
这是描述如何安装和配置ActiveMQ 4.x/5.x在Unix和windows平台的说明文档。

文档结构
介绍
文档结构
安装前的准备
window平台安装
    二进制文件安装
    源码安装
    开发版本
Unix平台安装
    二进制文件安装
    源码安装
    开发版本
启动ActiveMQ
测试安装
监控ActiveMQ
停止ActiveMQ
配置ActiveMQ

安装前的准备

硬件：

ActiveMQ 4.x 安装版最少需要33兆硬盘空间
ActiveMQ 4.x 源码和开发版最少需要200兆硬盘空间

操作系统：

windows: windowsXP SP2, windows 2000
Unix: Ubuntu Linux, Powerdog Linux, MacOS, AIX, HP-UX, Solaris, 任何支持JAVA的Unix

环境：

        JDK1.4以上, JDK1.5支持编译/构建。
        设置JAVA_HOME环境变量到JDK安装目录。
        Maven1.0.2以上（以源码安装的时候）。
        Jars必需放把路径里面。

window平台安装
这部分解释了如何在window平台，安装ActiveMQ。

二进制文件安装

        下载二进制发布包(.exe)，进行安装。
        1. 从浏览器打开http://activemq.apache.org
        2. 在左边的面板中，选择下载。
        3. 选择下载“最新版本”。
        4. 下载的文件名类似于"activemq-xx.zip"
        5. 解压到指定目录
        6. 查看“启动ActiveMQ”一节的内容
        7. 查看“测试安装”一节的内容

源码安装

        下载源码发布包，注意ActiveMQ在JDK14环境运行，编译和构建需要在JDK1.5的环境进行。
        1. 从浏览器打开http://activemq.apache.org
        2. 在左边的面板中，选择下载。
        3. 选择下载“最新版本”。
        4. 下载的文件名类似于"activemq-xx-src.zip"
        5. 解压到指定目录。
        6. 用Maven2.0.4和JDK1.5以上的环境，构建ActiveMQ。

        构建ActiveMQ的方法如下：
        cd [activemq_install_dir]
        mvn clean install

        这个路径[activemq_install_dir]，为ActiveMQ的安装路径。
        测试上面构建是否成功：
        cd [activemq_install_dir]
        mvn clean install -Dmaven.test.skip=true

        1. 如果你使用IDE工具，你可以使用maven eclipse plugins:
        mvn eclipse:eclipse
        或者
        mvn idea:idea
        使用免费的IDE工具，你可以参考插件的细节。

        2. 启动ActiveMQ，例如：
        cd [activemq_install_dir]\assembly\target
        unzip activemq-x.x-SNAPSHOT.zip
        cd activemq-x.x-SNAPSHOT
        bin\activemq

        3. 查看“测试安装”一节

开发版本

        这部分介绍如何下载安装开发版本。
        下载源码发布包，注意ActiveMQ在JDK14环境运行，编译和构建需要在JDK1.5的环境进行。
        1. 从浏览器打开http://activemq.apache.org
        2. 在左边的面板中，选择下载。
        3. 选择下载开发版本(Snapshot)“最新版本”。
        4. 下载文件。
        5. 解压到指定目录。
        6. 如果下载的是二进制的开发版本，查看“启动ActiveMQ”一节。如果下载的是源代码的开发版本，查看“windows源码安装”的第6，7步骤。
        7. 查看“测试安装”一节

Unix平台安装

二进制文件安装

        这部分解释了如何在Unix平台，安装ActiveMQ。
         1. 下载activemq 的gzip文件，
            例如: > wget http://activemq.apache.org/path/tofile/apache-activemq-4.1.0-incubator.tar.gz
        2. 解压文件到指定目录，例如： > tar zxvf activemq-x.x.x.tar.gz
        3. 启动activeMQ，授权给activemq
            > cd [activemq_install_dir]/bin
            > chmod 755 activemq
        4. 查看“启动activeMQ”一节
        5. 查看“安装测试”一节

源码安装

        下载源代码发布包，进行安装。
        下载源码发布包，注意ActiveMQ在JDK14环境运行，编译和构建需要在JDK1.5的环境进行。
         1. 从浏览器打开http://activemq.apache.org
         2. 在左边的面板中，选择下载。
         3. 选择下载“最新版本”。
        4. 下载的文件名类似于"activemq-xx-src.tar.gz"
        5. 解压到指定目录: tar zxvf activemq-xx-src.tar.gz
        6. 用Maven2.0.4和JDK1.5以上的环境，构建ActiveMQ。

        构建ActiveMQ的方法如下：
            cd [activemq_install_dir]
            mvn clean install

        如果出现java.lang.OutOfMemoryError，你需要设置内存大小：
            export MAVEN_OPTS=-Xmx512M
        这个路径[activemq_install_dir]，为ActiveMQ的安装路径。
        测试上面构建是否成功：
            cd [activemq_install_dir]
            mvn clean install -Dmaven.test.skip=true 1.

        如果你使用IDE工具，你可以使用maven eclipse plugins:
            mvn eclipse:eclipse
        或者
            mvn idea:idea
        使用免费的IDE工具，你可以参考插件的细节。

        7. 查看“启动ActiveMQ”一节。
        8. 查看“测试安装”一节。

开发版本

        这部分介绍如何下载安装开发版本。
        下载源码发布包，注意ActiveMQ在JDK14环境运行，编译和构建需要在JDK1.5的环境进行。
        1. 从浏览器打开http://activemq.apache.org
        2. 在左边的面板中，选择下载。
        3. 选择下载开发版本(Snapshot)“最新版本”。
        4. 下载文件，文件名类似于"active-xxx-tar.gz 或者 activemq-xxx-src.tar.gz"。
        5. 解压到指定目录，tar zxvf activemq-xxx-tar.gz，源码方式为, tar zxvf activemq-xxx.src.tar.gz。
        6. 如果下载的是二进制的开发版本，请运行：
            cd [activemq_install_dir]/bin
            chmod 755 activemq
        7. 查看“启动ActiveMQ”一节
        8. 如果是源代码的开发版本，查看Unix 源代码安装的步骤6-8。
        9. 查看“测试安装”一节启动ActiveMQ

测试安装
    下面将介绍如何运行ActiveMQ消息代理。

windows系统

        打开命令行控件台，进入安装目录:
            cd [activemq_install_dir]
        例如安装目录为c:\Program Files\ActiveMQ-4.x.
        然后输入，bin\activemq

Unix 系统

        打开一个终端，进入安装目录：
            cd[activemq_install_dir]
        运行activemq：
            bin/activemq
         或者
            bin/activemq > /tmp/smlog 2>&1&;
          输出日记到smlog文件

更多的帮助
        其他运行代理的方式，请参考 Here.
        例如，你要在一个JMS连接中，运行一个嵌入式的代理，使用同一个进程。

测试安装
        如果ActiveMQ运行起来了也没有任何问题，在控制台中打印出：
            NFO ActiveMQ JMS Message Broker (ID:apple-s-Computer.local-5
        ActiveMQ默认的端口是61616。你可以查看61616的端口。

windows

netstat -an|find "61616"

unix

            netstat -an|grep 61616

监控ActiveMQ
        有好几种方式可以监控ActiveMQ。如果你用的是4.2或者更高的，你可以通过web控制台监控。
            http://localhost:8161/admin
        另一种方式是，使用JMX查看ActiveMQ的运行情况。

停止ActiveMQ
        不论是window平台，还是unix平台，你可以通过控制台的“CTRL - C”来停止ActiveMQ。
        如果你是在Unix的后台启动进程，你可以
            ps -ef|grep activemq
            kill [PID] where [PID] is the process id of the ActiveMQ process.

配置ActiveMQ
        ActiveMQ代理正常运行。你可以配置 Xml Configuration 的文件，作为activemq命令行的参数。另一种作法是访问Broker Configuration URI 的路径配置参数。
        你也可以查看 Configuring Transports ，使用ActiveMQConnectionFacotry进行配置。
        查看 Initial Configuration 初始化细节信息，加入必需的jar包，放里路径里。
        如果你想使用JNDI连接你的JMS提供者，你可以参考 JNDI Support。如果你使用Spring，你可以参考Spring Support。
        安装完成，ActiveMQ运行在默认配置的环境。细节的信息你可以参考Configuration 。

额外的资源
如果你是ActiveMQ的新手，运行 Web Samples或者其他的一些例子，你会学到更多的东西。

标签

#activemq #jdk #eclipse #unix #maven