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