Apache ActiveMQ -- Version 5入门指南

介绍

本文档描述了如何在Unix和Windows的平台上安装和配置ActiveMQ。

文档组织

ActiveMQ的入门指南包含以下部分

介绍
文档组织
预装要求
Windows上的安装步骤
     Windows安装包安装
     Windows源码安装
     Windows开发者方式
Unix上的安装步骤
     Unix安装包安装
     Unix源码安装
     Unix开发者方式
启动ActiveMQ
    Windows
    Unix
更多帮助
安装验证
停止ActiveMQ
使用不同配置启动ActiveMQ
     ActiveMQ5.8及以前版本
     ActiveMQ5.9及以后版本
配置ActiveMQ
其它资源

预装要求

硬件：

• ActiveMQ的二进制发行版（安装包）需要60M的空闲硬盘空间
• ActiveMQ的源码（开发者发行版）需要200M的空闲硬盘空间

操作系统：

• Windows: Windows XP SP2, Windows 2000
• Unix: Ubuntu Linux, Powerdog Linux, MacOS, AIX, HP-UX, Solaris, or any Unix platform that supports Java

环境：

• Java开发工具包(JDK)1.6.x或更高版本用来部署，使用1.6.x(Java 6)来编译/构建
• 环境变量JAVA_HOME必须设置到JDK的安装目录，如：c:\Program Files\jdk.1.6.0_xx_xx
• Maven3.0或更高版本（当使用源码或者开发者发现版安装时才需要）
• 必须将jar包添加到classpath类路径中

Windows上的安装步骤

下面将介绍如何在Windows上通过安装包和源码两种方式安装ActiveMQ。

Windows安装包安装

这部分将说明怎么下载安装包，并在windows系统上安装。

1. 打开浏览器，在地址栏输入ActiveMQ 访问
2. 单击页面左边面板导航窗口的Download(下载)链接
3. 选择最新发布版Latest Releases(老版本选择past releases,点击Download Archives)。 二进制安装包,文件名类似于:activemq-x.x.x.zip
4. 解压ZIP文件到您选择的目录中
5. 开始运行ActiveMQ，请阅读本文 “启动ActiveMQ”部分
6. 启动后，需验证安装是否成功，请阅读本文“安装验证”部分

Windows源码安装

这部分将说明怎么下载源码，并在windows系统上安装。

1. 打开浏览器，在地址栏输入ActiveMQ 访问
2. 单击页面左边面板导航窗口的Download(下载)链接
3. 选择最新发布版Latest Releases(老版本选择past releases,点击Download Archives)。 源码安装包文件名类似于:activemq-x.x-src.zip
4. 解压ZIP文件到您选择的目录中
5. 使用java1.6和maven2.1或更高版本进行编译构建

推荐的构建方法如下：

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插件自动生成IDE项目文件

mvn eclipse:eclipse

或者

mvn idea:idea

如果您想使用其它的IDE，更多细节请访问 maven插件

2.从目标目录启动ActiveMQ，参考如下

cd [activemq_install_dir]\assembly\target
unzip activemq-x.x-SNAPSHOT.zip
cd activemq-x.x-SNAPSHOT
bin\activemq

注意：工作目录创建相对于当前目录，在适当的地方创建工作目录，必须从它的home或者安装目录启动ActiveMQ

警告：在Windows下使用Cygwin构建ActiveMQ 5.x有路径名称长度的限制。如果路径名长度超过,你可能看到构建错误，解决该错误的方法是，将ActiveMQ源目录放到高层目录中，如：/cygdrive/c/d/sm

Windows开发者方式

这部分将说明怎么在windows系统上下载安装最新开发者版。

注意：ActiveMQ需要Java6编译和运行

1. 打开浏览器，在地址栏输入ActiveMQ 访问
2. 单击页面左边面板导航窗口的Download(下载)链接
3. 点击ActiveMQ的maven快照(SNAPSHOT)链接
4. 选择ActiveMQ版本进行下载
5. 解压ZIP文件到您选择的目录中
6. 如果下载的时安装包快照，请阅读本文 “启动ActiveMQ”部分；如果下载的是源码快照，请参考Windows源码安装的第6步和第7步
7. 启动后，需验证安装是否成功，请阅读本文“安装验证”部分

Unix上的安装步骤

Unix安装包安装

这部分将说明怎么下载安装包，并在Unix系统上安装。

注意：有几种不同的方式来执行这种类型的安装

1.将activemq gzip文件下载到Unix电脑上可以使用浏览器或工具,如:wget,scp、ftp等，如：

wget http://activemq.apache.org/path/tofile/apache-activemq-5.8-tar.gz

2.解压gzip文件到您选择的目录中，如：

tar zxvf activemq-x.x.x.tar.gz

3.执行ActiveMQ start-up 脚本时，提示没有权限，需要赋予该脚本执行权限，这个脚本位于解压出来的目录的bin目录中，如：
 

cd [activemq_install_dir]/bin
chmod 755 activemq

4.开始运行ActiveMQ，请阅读本文 “启动ActiveMQ”部分

5.启动后，需验证安装是否成功，请阅读本文“安装验证”部分
 

Unix源码安装

这部分将说明怎么下载源码包，并在Unix系统上安装，这个过程是假设你的unix系统有浏览器。如果没有浏览器，则参考上面的步骤（Unix安装包安装）怎么进行安装ActiveMQ

注意：需要java 6进行编译和运行ActiveMQ

1.打开浏览器，在地址栏输入http://activemq.apache.org 访问
2.单击页面左边面板导航窗口的Download(下载)链接
3.点击ActiveMQ的maven快照(SNAPSHOT)链接
4.选择ActiveMQ版本进行下载，源码发行版的名字类似于activemq-x.x-src.tar.gz

5.解压gzip文件到您选择的目录中，如

tar zxvf activemq.x.x-src.tar.gz

6.使用java1.6和maven3或更高版本进行编译构建， 构建ActiveMQ的首选方法如下

cd [activemq_install_dir]
mvn clean install

如果Maven命令运行时崩溃了提示 java.lang.OutOfMemoryError错误，你需要首先执行下面命令（假设用的是Bourne-like shell）

export MAVEN_OPTS=-Xmx1024M

如果上面的构建因为测试用例没通过而失败，则输入下面内容重新编译

cd [activemq_install_dir]
mvn clean install -Dmaven.test.skip=true

如果你喜欢使用IDE（集成开发环境），那么您可以使用maven插件自动生成IDE项目文件
 

mvn eclipse:eclipse

或者

mvn idea:idea

如果您想使用其它的IDE，更多细节请访问 maven插件
注意：工作目录创建相对于当前目录，在适当的地方创建工作目录，必须从它的home或者安装目录启动ActiveMQ

7.开始运行ActiveMQ，请阅读本文 “启动ActiveMQ”部分

8.启动后，需验证安装是否成功，请阅读本文“安装验证”部分
 

Unix开发者方式

这部分将说明怎么在Unix系统上下载安装最新开发者版。

注意：需要java 6进行编译和运行ActiveMQ

1.打开浏览器，在地址栏输入http://activemq.apache.org 访问
2.单击页面左边面板导航窗口的Download(下载)链接
3.点击ActiveMQ的maven快照(SNAPSHOT)链接
4.选择ActiveMQ版本进行下载

5.解压gzip文件到您选择的目录中，如

tar zxvf activemq-x.x.x.tar.gz

开发者包的快照

tar zxvf activemq-x.x.x-src.tar.gz

6.如果下载的是二进制安装包，需要赋予该脚本执行权限，这个脚本位于解压出来的目录的bin目录中，如：
 

cd [activemq_install_dir]/bin
chmod 755 activemq

7.如果下载的是二进制安装包快照，请阅读本文 “启动ActiveMQ”部分

8.如果下载的是源码安装包快照，请参考“Unix源码安装”第6到8步

9.启动后，需验证安装是否成功，请阅读本文“安装验证”部分
 

启动ActiveMQ

现在说明如何运行 ActiveMQ Message Broker.

提示：使用不同的配置文件运行ActiveMQ请点击链接

Windows

打开一个控制台命令窗口（cmd），并把目录切换到ActiveMQ的安装目录

cd [activemq_install_dir]

activemq_install_dir这个目录就是你安装ActiveMQ的目录，如：c:\Program Files\ActiveMQ-5.x

不同版本的ActiveMQ，运行方式不一样

ActiveMQ5.10及以后版本

bin\activemq start

ActiveMQ5.9及其以前版本

bin\activemq

注意：工作目录创建相对于当前目录，在适当的地方创建工作目录，必须从它的home或者安装目录启动ActiveMQ
 

Unix

打开一个终端窗口，并把目录切换到ActiveMQ的安装目录

cd [activemq_install_dir]

activemq_install_dir这个目录就是你安装ActiveMQ的目录，如：/usr/local/activemq-5.x

然后输入

bin/activemq start
 
OR
 
bin/activemq start > /tmp/smlog  2>&1 &;
#提示：/tmp/smlog可以改成其它的文件

提示：工作目录创建相对于当前目录，在适当的地方创建工作目录，必须从它的home或者安装目录启动ActiveMQ
注意：不要关闭启动ActiveMQ的终端或命令窗口，如果关了ActiveMQ也会停止运行，除非它是以nohup方式启动的。

<span style="background-color: rgb(255, 204, 204);">nohup bin/activemq > /tmp/smlog 2>&1 &</span>

更多帮助

其它方式运行broker请看 这里。例如：您可以在JMS连接中嵌入式运行broker以避免单独启动一个进程。

安装验证

如果ActiveMQ已经启动并且运行没有问题，那么在windows的命令窗口或者unix的终端窗口中将会显示如下类似的日志信息

INFO  ActiveMQ JMS Message Broker (ID:apple-s-Computer.local-<span style="color:#00cccc;">51222-1140729837569-0:0</span>) has started

ActiveMQ的默认端口是61616，从另一个窗口运行netstat并查找61616端口

在windows命令窗口中输入

netstat -an|find "61616"

或者，在unix终端中输入

netstat -an|grep 61616

您可以通过 Web Console来监视ActiveMQ，需要在浏览器中输入

http://localhost:8161/admin
提示：自从ActiveMQ5.8以后版本，打开上面web应用会弹出安全认证框。默认的用户名和密码是 admin/admin，您可以在conf/jetty-real.properties文件中配置。
或者您可以使用 JMX查看ActiveMQ的运行状态。

更多信息请查看安装目录中的docs/WebConsole-README.txt文件。

停止ActiveMQ

对于Windows和Unix安装上,终止ActiveMQ通过键入ctrl - c在在运行的控制台或命令终端，

如果ActiveMQ是在Unix后台运行的,这个进程可以被杀死,请输入：

cd [activemq_install_dir]
bin/activemq stop

或者输入

ps -ef|grep activemq
kill [PID]

上面的PID是ActiveMQ的进程PID号
 

使用不同配置启动ActiveMQ

默认情况下ActiveMQ使用conf/activemq.xml作为主要的配置文件启动。如果你想使用一个不同的配置文件可以指定这是一个参数。

ActiveMQ5.8及以前版本

例如使用conf/activemq-demo.xml,它包括了web演示，输入:

bin/activemq console xbean:conf/activemq-demo.xml

使用 conf/activemq-demo.xml文件在控制台启动ActiveMQ，你需要输入xbean:前缀。

如果需要在后台运行，则输入

bin/activemq start xbean:conf/activemq-demo.xml

ActiveMQ5.9及以后版本

例如使用examples/conf/activemq-demo.xml,它包括了web演示，输入:

bin/activemq console xbean:examples/conf/activemq-demo.xml

使用examples/ conf/activemq-demo.xml文件在控制台启动ActiveMQ，你需要输入xbean:前缀。

如果需要在后台运行，则输入

bin/activemq start xbean:examples/conf/activemq-demo.xml

配置ActiveMQ

ActiveMQ broker现在应该运行。你可以通过指定 xml配置文件作为activemq命令参数来配置broker。另外一种方式是通过 配置URI来达到简洁的命令格式（如果您使用java或者xml，这种配置方式将会很少使用到），您也可以阅读 配置传输协议 以告诉您如何配置不同的连接、传输协议和broker选项使用连接URL在ActiveMQConnectionFactory上。

有关详细信息请参考 初始配置，在java代码中使用activemq需要将所需的jar加入到classpath中。

如果你想使用JNDI连接到JMS提供者请查看 JNDI的支持。如果你是一个Spring用户应该了解 Spring的支持。

安装后,运行ActiveMQ用的是基本配置。关于配置选项的详细信息,请参阅 配置部分。

其它资源

如果你是第一次使用ActiveMQ，想学习更多关于ActiveMQ的东西，那么运行 Web Samples或者 Examples是不错的选择。

本文翻译自： ActiveMQ

如需转载请注明：转自IccBoY（ Apache ActiveMQ -- Version 5入门指南_IccBoY的博客-CSDN博客）