使用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等等：
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。
轉自：http://blog.csdn.net/fox_lht/article/details/7194209