使用Apache ActiveMQ
使用Apache ActiveMQ
为了有助于使用ApacheActiveMQ 5，你也许希望从Version5 Getting Started手册或ConfiguringVersion 5 Transports开始。除此之外，下面还有一份手册列表：
l Configure version 5 Brokers（版本5代理的配置）
l Configuring Version 5Transports（版本5端口配置）
l LDAP Broker Discovery Mechanism（LDAP代理查找机制）
l Version 5 Examples（实例）
l Version 5 Getting Started（开始）
l Version 5 Hello World（你好）
l Version 5 Initial Configuration（初始化配置）
l Version 5 Installation（安装）
l Version 5 Performance Tuning（性能调整）
l Version 5 Run Broker（运行代理）
l Version 5 Topologies（架构）
l Version 5 Web Samples（Web实例）
l Version 5 XML Configuration（XML配置）
开始使用
介绍
本文档描述了如何在Windows和Unix平台上安装和配置AcitiveMQ。
目录
ActiveMQ的开始向导包含下面这些内容：
安装前的要求
硬件：
n 40MB的可用空间用于执行文件的安装。
n 200MB的可用空间用于开发版的安装。
操作系统：
n Windows：windows XP SP2，windows 2000。
n Unix：Ubuntu Linux，powerdog Linux，MacOS，HP-UX，Solarix，or支持java的Unix平台。
所需的环境：
n java Developer Kit（JDK）1.5.x 或者更高级的版本。
n 安装完JDK后，必须设置JAVA_HOME环境变量。
n maven1.0.2或更高级的版本。
n JARs要增加到classpath中。
安装过程
Windows安装过程
本节描述了在Windows平台上如何安装执行文件和源代码两种方式的ActiveMQ。
执行程序安装
下面的步骤描述了在windows系统中直接安装执行文件的过程：
1. 打开浏览器，输入网址activemq.apache.org/。
2. 在导航面板上（左面板）点击download链接。
3. 在Latest Release区，点击ActiveMQ Release链接，进入新的网页。
4. 在Download here区，选择你想要的发行版，执行文件发行版的文件名类似于activemq-x.x.x.zip。
5. 解压ZIP文件到某个你选定的目录。
6. 阅读本文档的开始ActiveMQ段。
7. 启动ActiveMQ，并阅读本文档的测试安装。
源代码安装
本段描述了在windows系统中如何下载并安装ActiveMQ的源代码发行版的过程：
1. 打开浏览器，输入网址activemq.apache.org/。
2. 在导航面板上（左面板）点击download链接。
3. 在Latest Release区，点击ActiveMQ Release链接，进入新的网页。
4. 在Download here区，选择你想要的发行版，执行文件发行版的文件名类似于activemq-x.x-src.zip。
5. 解压此文件到你指定的目录中。
6. 使用Maven 2.0.4或更高的版本和java 1.5来编译ActiveMQ。
下面的命令用于编译ActiveMQ。
cd [activemq_install_dir]
mvn clean install
[activemq_install_dir]是你安装activeMQ的目录。
1、如果上面的编译在一些测试中失败，输入下面的命令：
cd [activemq_install_dir]
mvn clean install –Dmaven.test.skip-true
如果你更喜欢使用IDE，那么你可以使用maven插件自动生成IDE项目：
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
注意：工作目录的建立是相对于当前目录建立的。为了建立合适的工作目录，ActiveMQ必须从他的home/installation目录中运行。
3、参考测试安装段。
开发板
本段描述了如何下载并安装最新的开发版：
1. 打开浏览器，输入网址activemq.apache.org/。
2. 在导航面板上（左面板）点击download链接。
3. 点击Current Development SNAPSHOT release链接，进入新的网页。
4. 选择你想要下载的发行版（如果看不见，向下滚动知道看到ActiveMQ snapshots）。
5. 解压此文件到你指定的目录中。
6. 如果下载的是执行文件的版本，参阅开始ActiveMQ段。
如果下载的是源代码版本，执行源代码安装的第6和7步骤。
7. 跟着启动，并测试安装。
Unix安装过程
执行程序的安装
下面的步骤演示了如何下载并安装可执行程序的发行版到Unix系统中：
注意：还有其他的方法完成此安装过程。
1. 下载gzip文件到unix系统中，可以使用浏览器、wget、scp、ftp等等：
> wget http://activemq.apache.org/path/tofile/apache-activemq-5.0-tar.gz
2. 解压文件
> tar zxvf activemq-x.x.x.tar.gz
3. 如果ActiveMQ启动脚本不能执行，更改它的权限，ActiveMQ脚本位于bin目录中，例如：
> cd [activemq_install_dir]/bin
> chmod 755 activemq
4. 继续执行开始ActiveMQ段。
5. 安装启动的步骤，测试安装。
源代码的安装
本段演示了如何在Unix系统中下载和安装源代码的发行版。这个过程假定你的Unix机器有浏览器。在没有浏览器的情况下请参阅前面的执行程序的安装。
注意：ActiveMQ需要java 5来运行和编译。
1. 打开浏览器，输入网址activemq.apache.org/。
2. 在导航面板上（左面板）点击download链接。
3. 在Latest Release区，点击ActiveMQ 4.x Release链接，进入新的网页。
4. 在Download here区，选择你想要的发行版，执行文件发行版的文件名类似于activemq-x.x-src.tar.gz。
5. 解压ZIP文件到某个你选定的目录。
tar zxvf activemq.x.x-src.tar.gz
6. 使用Maven 2.0.4和java 5编译ActiveMQ。如下所示：
cd [activemq_install_dir]
mvn clean install
如果Maven因溢出内存而崩溃，你需要这样做：
export MAVEN_OPTS=-Xmx512M
如果编译失败，做以下的步骤：
cd [activemq_install_dir]
mvn clean install -Dmaven.test.skip=true
如果使用IDE，你也可以使用maven插件自动生成IDE的项目：
mvn eclipse:eclipse
或者
mvn idea:idea
你可以任意使用可用的IDE，详细内容参阅插件参考。
注意：要建立的工作目录是相对于当前目录的，为了在合适的位置建立工作目录，你必须在home/installation目录中运行ActiveMQ。
7. 继续开始ActiveMQ那一段。
8. 继续测试安装那一段。
开发板的安装
本段演示了如何下载并安装最新的开发版快照。
注意：ActiveMQ需要java 5来运行和编译。
1. 打开浏览器，输入网址activemq.apache.org/。
2. 在导航面板上（左面板）点击download链接。
3. 点击Current development SNAPSHOT release链接，进入新的网页。
4. 选择你想要的发行版，发行版的文件名类似于activemq-x.x.x-src.tar.gz。
5. activemq-x.x-src.tar.gz。
6. 解压ZIP文件到某个你选定的目录。
tar zxvf activemq.x.x-src.tar.gz
7. 使用Maven 2.0.4和java 5编译ActiveMQ。如下所示：
cd [activemq_install_dir]
mvn clean install
如果Maven因溢出内存而崩溃，你需要这样做：
export MAVEN_OPTS=-Xmx512M
如果编译失败，做以下的步骤：
cd [activemq_install_dir]
mvn clean install -Dmaven.test.skip=true
如果使用IDE，你也可以使用maven插件自动生成IDE的项目：
mvn eclipse:eclipse
或者
mvn idea:idea
你可以任意使用可用的IDE，详细内容参阅插件参考。
注意：要建立的工作目录是相对于当前目录的，为了在合适的位置建立工作目录，你必须在home/installation目录中运行ActiveMQ。
8. 继续开始ActiveMQ那一段。
9. 继续测试安装那一段。
开始ActiveMQ
下面跟着指令来运行ActiveMQ消息代理（ActiveMQ Message Broker）。
windows系统：
在控制台窗口，进入要运行ActiveMQ的目录：
cd [activemq_install_dir]
activemq_install_dir表示为ActiveMQ安装的目录，例如：c:\ProgramFiles\ActiveMQ-5.x。
接着输入：
bin\activemq
Unix系统：
在控制台窗口，进入要运行ActiveMQ的目录：
cd [activemq_install_dir]
activemq_install_dir表示为ActiveMQ安装的目录，例如：/usr/local/activemq-5.x。
接着输入：
bin\activemq start
或者
bin/activemq start > /tmp/smlog 2>&1 &;
注意: /tmp/smlog也可以更改为其他的文件名。
更多的帮助：
其他运行代理的方法看这个。你也可以将代理嵌入到你的程序中而不必运行为单独的线程。
测试安装
如果ActiveMQ成功运行，Windows控制台窗口或Unix命令行下将显示如下信息：
INFO ActiveMQ JMS Message Broker (ID: apple-s-Computer.local-51222-1140729837569-0:0)has started
ActiveMQ的缺省端口为61616。可以在打开一个窗口来运行netstat并查找端口61616。
在控制台窗口中输入：
netstat -an|find"61616"
或者
在Unix命令行下输入：
netstat -an|grep61616
监控ActiveMQ
有几种不同的方法来监视ActiveMQ，如果是4.2或者更新版本的ActiveMQ，你可以在浏览器中使用Web控制台的方式进行监控，网址是：
http://localhost:8161/admin
或者使用JMX支持来查看已经处于运行状态的ActiveMQ。
停止ActiveMQ
不论是windows系统还是Unix系统都可以使用“CTRL-C”的方式来终止ActiveMQ的运行。
如果ActiveMQ是在Unix的后台运行，可以终止进程，如下所示：
在控制台窗口，进入要运行ActiveMQ的目录：
cd [activemq_install_dir]
activemq_install_dir表示为ActiveMQ安装的目录，例如：/usr/local/activemq-5.x。
接着输入：
bin\activemq stop
或者输入下面的命令也可以
ps -ef|grep activemq
kill [PID]
[PID]是ActiveMQ的进程号。
配置ActiveMQ
现在ActiveMQ应该可以运行了，你要配置代理可以通过定义XmlConfiguration文件来配置ActiveMQ。你也可以使用BrokerConfiguration URI来在命令行进行简明方式的配置。
ConfiguringTransports这一章可以告诉你在ActiveMQConnectionFactory中使用链接URL如何配置不同的连接、端口和代理选项。
初始化配置（Initial Configuration）这一章详细的告诉你在你的java代码中使用ActiveMQ需要哪些jar文件包。
如果你要使用JNDI连接到你的JMS提供者，那么请参阅JNDI支持。如果你是Spring的用户，请参阅Spring支持。
在安装完成后，ActiveMQ只在基本配置的情况下运行，更详细的内容请参阅配置那一章。
额外的资源
如果你是一个ActiveMQ的新手，运行Web示例或示例集将会更好的学习activeMQ。