ActiveMQ Classic 入門指南

簡介

本文件說明如何在 Unix 和 Windows 平台上安裝和設定 ActiveMQ Classic 5.x。

文件組織

ActiveMQ Classic 5.x 的入門指南包含以下章節

安裝前需求

硬體

  • ActiveMQ Classic 5.x 二進位發行版需要約 60 MB 的可用磁碟空間。
    （您需要額外的磁碟空間來儲存到磁碟的持久訊息）
  • ActiveMQ Classic 5.x 原始碼或開發人員發行版需要約 300 MB 的可用磁碟空間。

作業系統：

  • Windows：Windows XP SP2、Windows 2000、Windows Vista、Windows 7。
  • Unix：Ubuntu Linux、Powerdog Linux、MacOS、AIX、HP-UX、Solaris 或任何支援 Java 的 Unix 平台。

環境

  • Java 執行環境 (JRE)  JRE 1.8 或更高版本（版本 <= 5.15.0 為 1.7，版本 <= 5.10.0 為 1.6）
    （如果您計劃重新編譯原始碼，則需要 JDK）
  • JAVA_HOME 環境變數必須設定為 JRE 安裝所在的目錄
    （Unix：二進位「java」必須可由 PATH 變數解析；執行「which java」來驗證）
  • Maven 3.0.0 建置系統
    （僅當您計劃重新編譯原始碼時才需要）
  • 必須將要使用的 JAR 新增至類別路徑。
    （僅當您計劃重新編譯原始碼時才需要）

Windows 安裝程序

本入門指南的本節說明如何在 Windows 系統上安裝 ActiveMQ Classic 的二進位和原始碼發行版。

Windows 二進位安裝

此程序說明如何在 Windows 系統上下載和安裝二進位發行版。

  1. 下載最新版本
    （請參閱下載 ->「最新的穩定版本」->「apache-activemq-x.x.x-bin.zip」）
  2. 將 ZIP 檔案中的檔案解壓縮到您選擇的目錄中。
  3. 繼續執行本文件的 #啟動 ActiveMQ Classic 章節。
  4. 啟動後，請前往本文件的 #測試安裝 章節。

Windows 原始碼安裝

此程序說明如何在 Windows 系統上下載和安裝原始碼發行版。

  1. 下載最新版本
    （請參閱下載 ->「最新的穩定版本」->「apache-activemq-x.x.x-source-release.zip」）
  2. 將 ActiveMQ Classic 從 ZIP 檔案中解壓縮到您選擇的目錄中。
  3. 建議的建置 ActiveMQ Classic 方法如下
    REM add "-Dmaven.test.skip=true" if tests are failing on your system (should not happen)
mvn clean install

    其中 [activemq_install_dir] 是安裝 ActiveMQ Classic 的目錄。

  4. 如果您偏好使用 IDE，則可以使用 Maven 外掛程式自動產生 IDE 的專案檔案
    mvn eclipse:eclipse

    或

    mvn idea:idea

    您可以隨意使用任何其他適用的 IDE。請參閱 外掛程式參考 以取得更多詳細資訊。

  5. 從目標目錄啟動 ActiveMQ Classic，例如
    cd [activemq_install_dir]\assembly\target
unzip activemq-x.x-SNAPSHOT.zip
cd activemq-x.x-SNAPSHOT
bin\activemq

    注意：工作目錄是相對於目前目錄建立的。若要在正確的位置建立工作目錄，必須從其主目錄/安裝目錄啟動 ActiveMQ Classic。

  6. 繼續執行 #測試安裝 章節。

    警告

    如果您在 Windows 下使用 Cygwin 建置 ActiveMQ Classic 4.x，則路徑名稱長度會受到限制。如果路徑名稱長度超過限制，您可能會看到建置錯誤。若要修正此問題，請將 ActiveMQ Classic 原始碼目錄移到檔案系統樹狀結構中較高的位置，例如 /cygdrive/c/d/sm。

Windows 開發人員版本

此程序說明如何下載和安裝最新的開發人員快照。

  1. 開啟發行版封存檔：https://repository.apache.org/content/repositories/snapshots/org/apache/activemq/apache-activemq/
    （開啟其中一個 SNAPSHOT 目錄）
  2. 選取要下載的 ActiveMQ Classic 版本（如有必要，請向下捲動以查看 ActiveMQ Classic 快照）。
  3. 將 ZIP 檔案中的檔案解壓縮到您選擇的目錄中。
  4. 如果下載了二進位快照，請繼續執行本文件的 #啟動 ActiveMQ Classic 章節。
    如果下載了原始碼快照，請執行 #Windows 原始碼安裝 程序中的步驟 6 和步驟 7。
  5. 啟動後，請繼續執行 #測試安裝 章節。

Unix 安裝程序

Unix 二進位安裝

此程序說明如何在 Unix 系統上下載和安裝二進位發行版。
注意：有幾種替代方法可以執行此類安裝。

  1. 使用瀏覽器或工具（例如 wget、scp、ftp 等）將 activemq zip 壓縮的 tarball 檔案下載到 Unix 機器，例如
    （請參閱下載 ->「最新的穩定版本」）
    wget https://activemq.dev.org.tw/path/tofile/apache-activemq-x.x.x-bin.tar.gz
  2. 將壓縮的 tarball 中的檔案解壓縮到您選擇的目錄中。例如
    cd [activemq_install_dir]
tar zxvf activemq-x.x.x-bin.tar.gz

  3. 繼續執行本文件的 #啟動 ActiveMQ Classic 章節。

  4. 啟動後，請前往 #測試安裝 章節。

在 OSX 上使用 Homebrew 安裝程式

如果您使用 OSX 作為平台，則可以使用 Homebrew 套件管理員輕鬆安裝 Apache ActiveMQ Classic。

  1. 成功安裝 Homebrew 套件管理員後，只需執行
    $ brew install apache-activemq

    您會看到以下輸出

    ==\> Downloading http://www.gossipcheck.com/mirrors/apache/activemq/apache-activemq/x.x.x/apache-activemq-x.x.x-bin.tar.gz
######################################################################## 100.0%
==\> Caveats
Software was installed to:
  /usr/local/Cellar/apache-activemq/x.x.x/libexec
==\> Summary
/usr/local/Cellar/apache-activemq/x.x.x: 406 files, 35M, built in 2 seconds

ActiveMQ Classic 將安裝在 /usr/local/Cellar/apache-activemq/x.x.x/ 目錄中（其中 x.x.x 表示正在安裝的實際版本）。

現在，您可以繼續執行 #啟動 ActiveMQ Classic 和 #測試安裝 章節。

Unix 原始碼安裝

此程序說明如何在 Unix 系統上下載和安裝原始碼發行版。此程序假設 Unix 機器有瀏覽器。請參閱先前的 #Unix 二進位安裝 章節，以瞭解如何在沒有瀏覽器的情況下安裝 ActiveMQ Classic。

  1. 下載最新的原始碼發行版
    （請參閱下載 ->「最新的穩定版本」->「activemq-parent-x.x.x-source-release.zip」）
  2. 將 ZIP 檔案中的檔案解壓縮到您選擇的目錄中。例如
    tar zxvf activemq.x.x-src.tar.gz
  3. 使用 Maven 建置 ActiveMQ Classic
    建議的建置 ActiveMQ Classic 方法如下
    cd [activemq_install_dir]
mvn clean install # add "-Dmaven.test.skip=true" if tests are failing on your system (should not happen)

    如果 Maven 因 java.lang.OutOfMemoryError 而當機，您需要先執行此操作（假設使用類似 Bourne 的 Shell）

    export MAVEN_OPTS="-Xmx512M"

    如果您偏好使用 IDE，則可以使用 Maven 外掛程式自動產生 IDE 的專案檔案

    mvn eclipse:eclipse

    或

    mvn idea:idea

    您可以隨意使用任何其他適用的 IDE。請參閱 外掛程式參考 以取得更多詳細資訊。
    注意：工作目錄是相對於目前目錄建立的。若要在正確的位置建立工作目錄，必須從其主目錄/安裝目錄啟動 ActiveMQ Classic。

  4. 繼續執行本文件的 #啟動 ActiveMQ Classic 章節。
  5. 繼續執行 #測試安裝 章節。

Unix 開發人員版本

此程序說明如何下載和安裝最新的開發人員快照。

  1. 開啟發行版封存檔：https://repository.apache.org/content/repositories/snapshots/org/apache/activemq/apache-activemq/
    （開啟其中一個 SNAPSHOT 目錄）
  2. 選取要下載的 ActiveMQ Classic 版本（您可能必須向下捲動以查看 ActiveMQ Classic 快照）。
    檔案名稱將類似於：activemq-x.x.x-tar.gz。
  3. 將 gzip 檔案中的檔案解壓縮到您選擇的目錄中。例如
    對於二進位開發人員快照
    tar zxvf activemq-x.x.x.tar.gz

    對於原始碼開發人員快照

    tar zxvf activemq-x.x.x-src.tar.gz
  4. 如果下載了二進位快照，若要使其可執行，則可能需要變更 activemq 指令碼的權限
    cd [activemq_install_dir]/bin
chmod 755 activemq
  5. 對於二進位快照，請繼續執行本文件的 #啟動 ActiveMQ Classic 章節。
  6. 如果下載了原始碼快照，請執行 #Unix 原始碼安裝 程序中的步驟 6-8。
  7. 繼續執行 #測試安裝 章節。

啟動 ActiveMQ Classic

接下來將提供關於如何執行 ActiveMQ Classic 訊息代理程式的說明。

在 Windows 上

從主控台視窗中，變更到安裝目錄並執行 activemq

cd [activemq_install_dir]

其中 [activemq_install_dir] 是安裝 ActiveMQ Classic 的目錄，例如 c:\Program Files\ActiveMQ-5.x。
然後輸入

bin\activemq start

注意：工作目錄是相對於目前目錄建立的。若要在正確的位置建立工作目錄，必須從其主目錄/安裝目錄啟動 ActiveMQ Classic。

在 Unix 上

從命令 shell 中，變更到安裝目錄並以前景程序執行 activemq

cd [activemq_install_dir]/bin
./activemq console

從命令 shell 中，變更到安裝目錄並以常駐程序執行 activemq

cd [activemq_install_dir]/bin
./activemq start

更多說明

若要瞭解執行代理程式的其他方法，請參閱此處。例如，您可以在您的 JMS 連線內執行一個內嵌代理程式，以避免啟動個別的程序。

測試安裝

使用管理介面

  • 開啟管理介面
  • 導覽至「佇列」
  • 新增佇列名稱並按一下建立
  • 按一下「傳送到」以傳送測試訊息

日誌檔案和控制台輸出

如果 ActiveMQ Classic 正常運作，則 Windows 主控台視窗或 Unix 命令 shell 將會顯示類似於以下日誌行的資訊（請參閱 stdout 輸出或「[activemq_install_dir]/data/activemq.log」）

Apache ctiveMQ 5.11.1 (localhost, ID:ntbk11111-50816-1428933306116-0:1) started | org.apache.activemq.broker.BrokerService | main

監聽埠

ActiveMQ Classic 的預設埠為 61616。從另一個視窗執行 netstat 並搜尋埠 61616。

從 Windows 主控台中，輸入

netstat -an|find "61616"

或

從 Unix 命令 shell 中，輸入

netstat -nl|grep 61616

監控 ActiveMQ Classic

您可以透過將瀏覽器指向 https://127.0.0.1:8161/admin，使用網頁主控台來監控 ActiveMQ Classic。

從 ActiveMQ Classic 5.8 開始，網頁應用程式已預設受到保護。
預設的使用者名稱和密碼是 admin/admin。您可以在 conf/jetty-real.properties 檔案中設定此設定。

或者，您可以使用 JMX 支援來檢視 ActiveMQ Classic 的執行狀態。

如需更多資訊，請參閱發行版中的 docs/WebConsole-README.txt 檔案。

停止 ActiveMQ Classic

對於 Windows 和 Unix 安裝，請在執行 ActiveMQ Classic 的主控台或命令 shell 中輸入「CTRL-C」，以終止 ActiveMQ Classic。

如果 ActiveMQ Classic 在 Unix 上於背景啟動，則可以使用以下命令來終止該程序

cd [activemq_install_dir]/bin
./activemq stop

設定 ActiveMQ Classic

ActiveMQ Classic 代理程式現在應該可以執行了。您可以透過指定 Xml 設定檔案作為 activemq 命令的參數來設定代理程式。另一種方法是使用代理程式設定 URI，以簡潔的格式在命令列上設定設定（但設定選項不如使用 Java 或 XML 程式碼廣泛）。您也可以

另請參閱設定傳輸，以瞭解如何使用 ActiveMQConnectionFactory 中的連線 URL 來設定各種連線、傳輸和代理程式選項。

請參閱初始配置，以了解在 Java 程式碼中使用 ActiveMQ Classic 時，需要將哪些 JAR 檔案加入類別路徑的詳細資訊。

如果您想使用 JNDI 連線到您的 JMS 提供者，請查看JNDI 支援。如果您是 Spring 使用者，則應閱讀Spring 支援。

安裝完成後，ActiveMQ Classic 會以基本配置執行。如需配置選項的詳細資訊，請參閱配置章節。

其他資源

如果您是 ActiveMQ Classic 的新手，執行Web 範例或範例會是進一步了解 ActiveMQ Classic 的好方法。

在問題頁面上列出的商業供應商可能也有額外的文件、範例、教學等，可以幫助您入門。

Apache、ActiveMQ、Apache ActiveMQ、Apache 羽毛標誌和 Apache ActiveMQ 專案標誌是 The Apache Software Foundation 的商標。版權所有 © 2024，The Apache Software Foundation。依據Apache 授權 2.0 授權。