使用Apache ActiveMQ

随风飞世

　　使用Apache ActiveMQ
　　为了有助于使用ApacheActiveMQ 5，你也许希望从Version5 Getting Started手册或ConfiguringVersion 5 Transports开始。除此之外，下面还有一份手册列表：
　　lConfigure version 5 Brokers（版本5代理的配置）
　　lConfiguring Version 5Transports（版本5端口配置）
　　lLDAP Broker Discovery Mechanism（LDAP代理查找机制）
　　lVersion 5 Examples（实例）
　　lVersion 5 Getting Started（开始）
　　lVersion 5 Hello World（你好）
　　lVersion 5 Initial Configuration（初始化配置）
　　lVersion 5 Installation（安装）
　　lVersion 5 Performance Tuning（性能调整）
　　lVersion 5 Run Broker（运行代理）
　　lVersion 5 Topologies（架构）
　　lVersion 5 Web Samples（Web实例）
　　lVersion 5 XML Configuration（XML配置）
　　开始使用
介绍
　　本文档描述了如何在Windows和Unix平台上安装和配置AcitiveMQ。
目录
　　ActiveMQ的开始向导包含下面这些内容：
安装前的要求
　　硬件：
　　n40MB的可用空间用于执行文件的安装。
　　n200MB的可用空间用于开发版的安装。
　　操作系统：
　　nWindows：windows XP SP2，windows 2000。
　　nUnix：Ubuntu Linux，powerdog Linux，MacOS，HP-UX，Solarix，or支持java的Unix平台。
　　所需的环境：
　　njava Developer Kit（JDK）1.5.x 或者更高级的版本。
　　n安装完JDK后，必须设置JAVA_HOME环境变量。
　　nmaven1.0.2或更高级的版本。
　　nJARs要增加到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。