版本 5 入門

使用 ActiveMQ Classic 5 > 版本 5 入門

簡介

本文件描述如何在 Unix 和 Windows 平台上安裝和設定 ActiveMQ Classic。

安裝前需求

硬體

  • ActiveMQ Classic 二進位發行版本需要 60 MB 的可用磁碟空間。
  • ActiveMQ Classic 原始碼或開發人員發行版本需要 200 MB 的可用磁碟空間。

作業系統

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

環境

  • 用於部署的 Java 開發套件 (JDK) 1.7.x 或更高版本，以及用於編譯/建置的 1.7.x (Java 7)。
  • 必須將 JAVA_HOME 環境變數設定為 JDK 的安裝目錄，例如 c:\Program Files\jdk.1.7.0_xx_xx。
  • Maven 3.0 或更高版本（安裝原始碼或開發人員發行版本時需要）。
  • 必須將將使用的 JAR 新增至類別路徑。

Windows 安裝程序

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

Windows 二進位安裝

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

  1. 從瀏覽器中，導覽至 activemq.apache.org/。
  2. 按一下導覽窗格（左窗格）中的 下載 連結。
  3. 選取最新的發行版本（對於較舊的版本，請按一下連結至封存檔）。
    對於二進位發行版本，檔案名稱會類似： activemq-x.x.x.zip。
  4. 將 ZIP 檔案中的檔案解壓縮到您選擇的目錄中。
  5. 繼續閱讀本文件的 #啟動 ActiveMQ Classic 一節。
  6. 啟動後，前往本文件的 #測試安裝 一節。

Windows 原始碼安裝

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

注意： ActiveMQ Classic 需要 Java 7 才能執行和建置

  1. 從瀏覽器中，導覽至 activemq.apache.org/。
  2. 按一下導覽窗格（左窗格）中的 下載 連結。
  3. 選取最新的發行版本（對於較舊的版本，請按一下連結至封存檔）。
    對於原始碼發行版本，檔案名稱會類似： activemq-x.x-src.zip。
  4. 將 ZIP 檔案中的 ActiveMQ Classic 解壓縮到您選擇的目錄中。
  5. 使用 Maven 2.1 或更高版本和 Java 1.7 建置 ActiveMQ Classic。

建議的建置 ActiveMQ Classic 方法如下

cd [activemq_install_dir]
mvn clean install

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

如果上述建置在某些測試中失敗，請輸入以下內容

cd [activemq_install_dir]
mvn clean install -Dmaven.test.skip=true
  1. 如果您偏好使用 IDE，則可以使用 maven 外掛程式自動產生 IDE 的專案檔案
    mvn eclipse:eclipse

    或

    mvn idea:idea

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

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

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

  3. 繼續前往 #測試安裝 一節。

警告

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

Windows 開發人員發行版本

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

注意： ActiveMQ Classic 需要 Java 7 才能執行和建置

  1. 從瀏覽器中，導覽至 activemq.apache.org/。
  2. 按一下導覽窗格（左窗格）中的 下載 連結。
  3. 按一下 Maven ActiveMQ Classic SNAPSHOT 連結。
  4. 選取要下載的 ActiveMQ Classic 版本
  5. 將 ZIP 檔案中的檔案解壓縮到您選擇的目錄中。
  6. 如果已下載二進位快照，請繼續前往本文件的 #啟動 ActiveMQ Classic 一節。
    如果已下載原始碼快照，請執行 #Windows 原始碼安裝 程序的步驟 6 和步驟 7。
  7. 啟動後，繼續前往 #測試安裝 一節。

Unix 安裝程序

Unix 二進位安裝

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

注意： 執行此類型安裝有幾種替代方法。

  1. 使用瀏覽器或工具 (例如 wget、scp、ftp 等) 將 activemq gzip 檔案下載到 Unix 機器。例如
    \> wget https://activemq.dev.org.tw/path/tofile/apache-activemq-5.8-tar.gz
  2. 將 gzip 檔案中的檔案解壓縮到您選擇的目錄中。例如
    \> tar zxvf activemq-x.x.x.tar.gz
  3. 如果 activemq 啟動指令碼不是可執行檔，請變更其權限。 activemq 指令碼位於 bin 目錄中。例如
    \> cd [activemq_install_dir]/bin
\> chmod 755 activemq
  4. 繼續閱讀本文件的 #啟動 ActiveMQ Classic 一節。
  5. 啟動後，前往 #測試安裝 一節。

Unix 原始碼安裝

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

注意： ActiveMQ Classic 需要 Java 7 才能執行和建置

  1. 從瀏覽器中，導覽至 activemq.apache.org/。
  2. 按一下導覽窗格（左窗格）中的 下載 連結。
  3. 按一下 Maven ActiveMQ Classic SNAPSHOT 連結。
  4. 選取要下載的 ActiveMQ Classic 版本
    對於原始碼發行版本，檔案名稱會類似： activemq-x.x-src.tar.gz。
  5. 將 ZIP 檔案中的檔案解壓縮到您選擇的目錄中。例如
    tar zxvf activemq.x.x-src.tar.gz
  6. 使用 Maven 3.0 或更高版本和 Java 7 建置 ActiveMQ Classic
    建議的建置 ActiveMQ Classic 方法如下
    cd [activemq_install_dir]
mvn clean install

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

    export MAVEN_OPTS=-Xmx1024M

    如果上述建置在某些測試中失敗，請執行下列動作

    cd [activemq_install_dir]
mvn clean install -Dmaven.test.skip=true

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

    mvn eclipse:eclipse

    或

    mvn idea:idea

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

  7. 繼續閱讀本文件的 #啟動 ActiveMQ Classic 一節。
  8. 繼續前往 #測試安裝 一節。

Unix 開發人員發行版本

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

注意： ActiveMQ Classic 需要 Java 7 才能執行和建置

  1. 從瀏覽器中，導覽至 activemq.apache.org/。
  2. 按一下導覽窗格（左窗格）中的 #下載 連結。
  3. 按一下 Maven ActiveMQ Classic SNAPSHOT 連結。
  4. 選取要下載的 ActiveMQ Classic 版本
  5. 將 gzip 檔案中的檔案解壓縮到您選擇的目錄中。例如
    對於二進位開發人員快照
    tar zxvf activemq-x.x.x.tar.gz

    對於原始碼開發人員快照

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

啟動 ActiveMQ Classic

現在將說明如何執行 ActiveMQ Classic 訊息代理程式。

另請參閱 使用不同的設定檔啟動 ActiveMQ Classic

在 Windows 上

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

cd [activemq_install_dir]

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

然後輸入 (取決於 ActiveMQ Classic 版本)

ActiveMQ Classic 5.10 以後版本

bin\activemq start

`ActiveMQ Classic 5.9 或更舊版本**

bin\activemq

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

在 Unix 上

從命令 Shell 中，變更為安裝目錄並執行 activemq

cd [activemq_install_dir]

其中 activemq_install_dir 是安裝 ActiveMQ Classic 的目錄，例如 /usr/local/activemq-5.x。
然後輸入

bin/activemq start

或

bin/activemq start > /tmp/smlog  2>&1 &;
Note: /tmp/smlog may be changed to another file name.

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

警告

請勿關閉啟動 ActiveMQ Classic 的主控台或 Shell，因為這會終止 ActiveMQ Classic (除非 ActiveMQ Classic 是使用 nohup 啟動)。

nohup bin/activemq > /tmp/smlog 2>&1 &

更多說明

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

測試安裝

如果 ActiveMQ Classic 執行中且沒有問題，Windows 主控台視窗或 Unix 命令 Shell 會顯示類似下列記錄行的資訊

INFO  ActiveMQ JMS Message Broker (ID:apple-s-Computer.local-51222-1140729837569-0:0) has started

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

從 Windows 主控台中，輸入

netstat -an|find "61616"

或

從 Unix 命令 Shell 中，輸入

netstat -an|grep 61616

監控 ActiveMQ Classic

您可以使用 Web 主控台 監控 ActiveMQ Classic，方法是將瀏覽器指向

https://127.0.0.1:8161/admin

從 ActiveMQ Classic 5.8 以後，Web 應用程式會預設進行保護。
預設的使用者名稱和密碼是 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]

其中 activemq_install_dir 是安裝 ActiveMQ Classic 的目錄，例如 /usr/local/activemq-5.x。
然後輸入

bin/activemq stop

或者，您可以執行以下操作

ps -ef|grep activemq
kill [PID]

其中 [PID] 是 ActiveMQ Classic 程序的程序 ID。

使用不同的設定檔啟動 ActiveMQ Classic

預設情況下，ActiveMQ Classic 在啟動時會使用 conf/activemq.xml 作為主要設定檔。如果您想使用不同的設定檔，您可以將其指定為參數。

ActiveMQ Classic 5.8 或更早版本

例如，要使用包含網頁範例的 conf/activemq-demo.xml，您可以按照以下步驟操作

bin/activemq console xbean:conf/activemq-demo.xml

要在主控台模式下啟動 Active 並載入 conf/activemq-demo.xml 檔案，請注意您需要使用 xbean: 作為前綴。

若要作為背景程序啟動，您可以執行

bin/activemq start xbean:conf/activemq-demo.xml

ActiveMQ Classic 5.9 及更新版本

例如，要使用包含網頁範例的 examples/conf/activemq-demo.xml，您可以按照以下步驟操作

bin/activemq console xbean:examples/conf/activemq-demo.xml

要在主控台模式下啟動 Active 並載入 examples/conf/activemq-demo.xml 檔案，請注意您需要使用 xbean: 作為前綴。

若要作為背景程序啟動，您可以執行

bin/activemq start xbean:examples/conf/activemq-demo.xml

設定 ActiveMQ Classic

現在 ActiveMQ Classic 訊息代理程式應該正在運行。您可以透過將 Xml 設定檔 作為參數傳遞給 activemq 命令來設定訊息代理程式。另一種方法是使用 訊息代理程式設定 URI，以簡潔的格式在命令列上設定（儘管設定選項不如使用 Java 或 XML 程式碼來得廣泛）。您也可以

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

請參閱 初始設定，以了解在 Java 程式碼中開始使用 ActiveMQ Classic 需要將哪些 JAR 檔案新增至類別路徑。

如果您想使用 JNDI 連接到您的 JMS 提供者，請參閱 JNDI 支援。如果您是 Spring 使用者，您應該閱讀 Spring 支援。

安裝後，ActiveMQ Classic 會以基本設定運行。有關設定選項的詳細資訊，請參閱 設定 章節。

其他資源

如果您是第一次使用 ActiveMQ Classic，運行 網頁範例 或 範例 會是進一步了解 ActiveMQ Classic 的好方法。

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