使用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等等:
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控制台的方式进行监控,网址是:
或者使用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。