| Sun ONE Message Queue 3.0.1 SP2 安裝指南 |
第 1 章
介紹本章提供了安裝 MQ 產品的全面介紹。涵蓋下列主題：
產品版本Sun™ ONE Message Queue 產品具有以下兩種版本：平台版與企業版 每種版本對應於不同的授權容量，如下所述。(若要將 MQ 從一種版本升級至另一種版本，請參閱「MQ 安裝指南」中的說明。)
平台版
該版本可以從 Sun 網站免費下載，也可以隨附最新的 Sun ONE Application Server 平台。平台版未對每項 MQ 訊息服務所支援的 JMS 用戶端連接做出數量限制。該版本附帶有兩種授權，如下所述：
- 基本授權。該授權提供基本的 JMS 支援 (它是一個完整的 JMS 供應程式)，但不包括下列企業功能，如：負載平衡 (多重代理程式訊息服務)、HTTP/HTTPS 連接、安全連接服務、可延伸式連接功能以及多重佇列遞送策略。該授權的有效期沒有限定，因此可以用於無較高要求的生產環境。
- 具有 90 天試用期的企業授權。該授權包括基本授權中未提供的所有企業功能 (如支援多重代理程式訊息服務、HTTP/HTTPS 連接、安全連接服務、可延伸式連接功能以及多重佇列遞送策略)。然而，軟體強制規定該授權只有 90 天的有效期，所以，它適合於評估企業版產品提供的企業功能 (請參閱企業版)。
企業版
該版本用於在生產環境中佈署與執行訊息傳送應用程式。它包括對多重代理程式訊息服務、HTTP/HTTPS 連接、安全連接服務、可延伸式連接功能以及多重佇列遞送策略的支援。您也可以使用企業版來進行開發、載入測試訊息傳送應用程式與組件並對其進行除錯。企業版具有無限制的授權有效期，並且該授權對多重代理程式訊息服務中的代理程式數量也沒有限制，但是指定了受支援的 CPU 數量。
受支援的平台與產品Solaris、Linux 以及 Windows 等作業系統與平台均支援 MQ 3.0.1, SP2。對該產品的支援還取決於下表中指示的其他技術。也可以使用其他版本或其他供應商實作，但是它們沒有經過 Sun Microsystems 測試，因此不受支援。
表格 1-1 MQ 3.0.1 產品支援矩陣
平台/產品
用於
受支援的平台/產品版本1
Java 執行環境 (JRE)
(僅用於 Sun Microsystems 生產版本)MQ 代理程式 (訊息伺服器) 與 MQ 管理工具
JDK/JRE 1.4.1_03：
JDK/JRE 1.4.1：
Java Software Development Kit (JDK), Standard Edition
(僅用於 Sun Microsystems 生產版本)JMS 用戶端開發
(僅在 JDK 1.4.1_03 上才支援 SOAP 訊息傳送用戶端)
版本 1.4.1_032：
版本 1.3.1_053：
版本 1.2.2_08：不受支援，但仍可使用 (假使您無法升級至更高版本)
LDAP Directory Server
MQ 使用者儲存庫與管理物件支援
Sun ONE Directory Server 版本 5.1
Web Server
HTTP 與 HTTPS 支援
Sun ONE Web Server, Enterprise Edition 6.0 SP4
資料庫
插接的持續性支援
Cloudscape (版本 3.0)
Oracle 8i 版本 8.1.7 與 Oracle 9i 版本 9.0.1
JNDI
管理物件支援
1檢查「MQ 版次注意事項」以查看受支援版本的所有更新
2從以下網站下載此 JDK：http://java.sun.com/j2se/1.4/index.html
3從以下網站下載此 JDK：http://java.sun.com/j2se/1.3/index.html
MQ 軟體模組下表指示出 MQ 產品中所包括的全部軟體模組 (請參閱表格 1-2，以查看它們的安裝位置)。
經由 Web 與 CD-ROM 安裝您可以選擇從 Sun ONE 網站下載 MQ 3.0.1, SP2 產品，也可以選擇經由 CD-ROM 安裝該產品。如需詳細說明，請參閱後面章節中平台特定的說明。
安裝的目錄結構以下安裝影像反映了完整 Solaris 安裝 (所有套裝軟體) 或完整 (「典型」) Windows 安裝。如果您執行的是部分安裝，該影像可能會不同。
表格 1-3 安裝的目錄結構
檔案與目錄
(Solaris)檔案與目錄 (Windows 與 Linux)1
內容
COPYRIGHT (未安裝)
./COPYRIGHT
版權文字檔
LICENSE (未安裝)
./LICENSE
授權文字檔
README (未安裝)
./README
README 文字檔
/usr/bin 目錄
./bin 目錄
包含用於代理程式 (imqbrokerd) 與下列 MQ 管理工具的可執行檔：
在 Windows 上，上面命名的檔案的副檔名為 .bat。本目錄還包括將代理程式作為 Windows 服務 (imqsvcadmin) 和其他可執行檔 (imqbrokersvc) 安裝與解除安裝的公用程式。
/usr/share/lib 目錄
./lib 目錄
包含支援 MQ 用戶端執行階段的檔案：
/*jar 包含用於建立與執行 JMS 用戶端應用程式的 jar 檔案
/usr/share/lib/imq 目錄
./lib 目錄
包含用於支援 MQ 工具與程序的檔案：
/ext/*jar 位置，用於放置插接持續性功能需要的 jar 檔案
/props 子目錄包含代理程式的預設配置檔案
/help 子目錄包含 MQ 輔助說明檔案
/images
/etc/imq 目錄
./etc 目錄
包含授權檔案、安全性相關檔案 (如 passfile、存取控制檔案和平面檔使用者儲存庫) 以及可用於自動啟動的 rc 程序檔配置檔案 (僅適用於 Solaris)。
/var/imq 目錄
./var 目錄
用於 MQ 的工作儲存目錄。
/instances 子目錄，將包含用於每個代理程式實例的配置檔案、日誌檔以及基於檔案的持續性資料儲存區。
/usr/share/javadoc/imq 目錄
./javadoc 目錄
包含以 Javadoc (HTML) 形式發行的 MQ 與 JMS API 說明文件
/usr/demo/imq 目錄
./demo 目錄
如何執行用戶端範例應用程式的源代碼與有關說明
./jre 目錄
JRE 1.4 檔案 (僅適用於 Windows)
從版本 2.0 進行升級MQ 3.0.1, SP2 與 MQ 3.0.1 以及 MQ 3.0.1 SP1 完全相容，從 MQ 3.0.1 或 MQ 3.0.1 SP1 升級至 MQ 3.0.1, SP2 不需要對代理程式配置、管理物件、管理工具或用戶端應用程式進行任何變更。
但是，MQ 3.0.1 版本通常與 iMQ 2.0 不相容，主要是因為 MQ 3.0.1 版本所使用的內部與外部資料發生了變更。鑑於此原因，強烈建議您在安裝任何 MQ 3.0.1 版本之前，首先解除安裝 iMQ 2.0，請勿嘗試在安裝有 iMQ 2.0 的基礎上安裝 MQ 3.0.1。
解除安裝 iMQ 2.0
如果您執行的是 iMQ 2.0 Service Pack 1，應該首先使用「Service Pack 安裝指南」中的解除安裝說明來解除安裝 Service Pack，然後使用「iMQ 2.0 安裝指南」中的解除安裝說明來解除安裝 iMQ 2.0。
解除安裝作業不會移除 iMQ 2.0 IMQ_VARHOME 目錄。該目錄 (預設為 Solaris 與 Linux 作業系統上的 /var/opt/SUNWjmq，以及 Windows 系統上的 c:\Program files\iPlanetMessageQueue2.0\var) 包含暫態檔案和安全性相關檔案 (請參閱表格 1-4)。該資料的某些部分與 MQ 3.0.1 相容，可以使用下一節中的說明加以保留。
相容性與不相容性
MQ 3.0.1 版本進行了一些用於提昇功能的變更，因此它通常與 iMQ 2.0 不相容。特別是當您從 iMQ 2.0 升級至 MQ 3.0.1, SP2 時，可能需要解決下列問題：
代理程式的相容性
MQ 3.0.1 代理程式與 iMQ 2.0 代理程式不會進行互通，因為代理程式特性與持續性儲存區綱目發生了變更。但是，某些 iMQ 2.0 資料與 MQ 3.0.1 相容，如表格 1-4 所示，可以在升級至 MQ 3.0.1 時保留這些資料。從 iMQ 2.0 升級至 MQ 3.0.1 時，您應該考量以下方面：
- 您可以將 iMQ 2.0 config.properties 檔案複製到其他位置，大多數情況下，在配置 MQ 3.0.1 代理程式時參考它們所包含的特性設定。
- 任何持續性 iMQ 2.0 資料 (訊息、目標、持久性訂閱) 均無法重複使用。特別是，您需要在 MQ 3.0.1 代理程式中重新建立 iMQ 2.0 目標。
- 您可以在安裝完 MQ 3.0.1 之後繼續使用 iMQ 2.0 使用者儲存庫以及存取控制特性檔案。MQ 3.0.1 安裝程式不會覆寫這些檔案。您必須將它們移至適當的 MQ 3.0 位置 (請參閱「MQ 管理員指南」的附錄 C)。
管理物件的相容性
MQ 3.0.1 管理物件已經透過新屬性進行了增強，並且重新命名了 iMQ 2.0 屬性。因此，從 iMQ 2.0 升級至 MQ 3.0.1 時，您應該考量以下方面：
- 您可以使用同一個物件儲存區以及在 iMQ 2.0 中建立的管理物件，但是，最好在安裝 MQ 3.0.1 之後升級您的管理物件。執行升級作業時，管理主控台 (imqadmin) 與 ObjectManager 指令行公用程式 (imqobjmgr) 會將 iMQ 2.0 管理物件轉換為 MQ 3.0.1 管理物件。
- MQ 3.0.1 用戶端執行階段會透過將 iMQ 2.0 管理物件轉換為本機 MQ 3.0.1 管理物件來查找、創設 iMQ 2.0 管理物件。但是，該作業不會將物件儲存區中的 iMQ 2.0 管理物件轉換為 MQ 3.0.1 管理物件。
- 直接創設管理物件的 JMS 用戶端 (應用程式和/或組件) 即，有賴於 JMS 供應程式 需要被重新撰寫，以適應新的管理物件屬性名稱 (請參閱 MQ 開發人員指南 的第 4 章與附錄 A，以取得有關管理物件屬性的資訊)。
- 啟動 JMS 用戶端的程序檔以及使用指令行選項設定管理物件屬性值的程序檔均需要重新撰寫，以適應新的管理物件屬性名稱 (請參閱 MQ 開發人員指南 的第 4 章與附錄 A，以取得有關管理物件屬性的資訊)。
管理工具的相容性
由於已經對許多檔案與目錄進行了重新命名 (具體來說是用字串「imq」取代了「jmq」)，因此，所有 MQ 3.0.1 指令行公用程式、代理程式特性、管理物件屬性以及內部檔案名稱均發生了變更。因此，從 iMQ 2.0 升級至 MQ 3.0.1 時，您應該考量以下方面：
- 任何使用指令行公用程式 (imqbrokerd、imqcmd、imqobjmgr 等等) 的程序檔均需要進行編輯，以便用新命名的指令取代舊指令。尤其請注意，jmqbroker 指令現在已變更為 imqbrokerd。
- 管理主控台 (imqadmin) 可讓您同時管理數個代理程式和/或物件儲存區，並儲存顯示在螢幕左側導航窗格中的管理實體清單。這樣，每次啟動主控台時均會重新顯示管理實體的清單。儲存 iMQ 2.0 管理主控台中使用者設定的目錄之名稱已經針對 MQ 3.0.1 進行了變更。從 iMQ 2.0 升級至 MQ 3.0.1 時，如果希望保留舊的主控台設定，則需要將儲存 brokerlist.properties 檔案與 objstorelist.properties 檔案的目錄名稱從 user.home/.jmq/admin 變更為 user.home/.imq/admin，其中，user.home 為 java 系統的特性。
用戶端的相容性
從 iMQ 2.0 升級至 MQ 3.0.1 時，您應該考量以下方面：
如何執行下一步當您準備在特定平台上安裝 MQ 時，請參閱適用於您平台 (Solaris、Linux 或 Windows) 的章節。每章均包含硬體與軟體需求、安裝程序以及其他相關說明，例如如何升級版本以及如何在安裝後繼續執行作業等。
