| Sun ONE Message Queue 3.0.1 SP2 安裝指南 |
第 2 章
Solaris 安裝本章解釋了適用於 Solaris 安裝的下列主題：
硬體與軟體需求您的 Solaris™ 開發系統 (SPARC™ Platform Edition) 至少應該滿足下表所指示的最低需求。
表格 2-1 適用於 Solaris 的硬體與軟體需求
組件
需求
作業系統
Solaris 8 或 Solaris 9 (SPARC 平台)
Solaris 9, Update 4 或更高版本 (SPARC 與 x86 平台)注意：若要確保 MQ 能夠正確作業，您應該安裝所有必需的 Solaris 修補程式 (用於 Java 2)。如需有關修補程式的最新資訊，或者要下載建議使用的所需修補程式，請參閱：
CPU
具有 TCP/IP 網路的 Sun Ultra™ 1 (或相容) 工作站
RAM
128 MB
硬碟空間
壓縮的安裝檔案大約需要 6 MB 的硬碟空間。
用於解壓縮安裝檔案的暫存工作目錄另外需要 8 MB 的硬碟空間。
安裝的產品大約需要 8 MB 的硬碟空間。但是，如果代理程式要在本機儲存持續性訊息，MQ 可能會需要更多空間。
Java 2 Standard Edition (J2SE)
請參閱表格 1-1，以取得 Solaris 支援的 Java 執行環境 (JRE) 與 Java 軟體開發工具 (JDK) 的支援版本。
MQ software distribution CD 在發行時包含了所需的 JRE 版本。
在 Solaris 上安裝 MQMQ 產品可以從 Sun ONE 網站下載，也可以經由產品 CD-ROM 安裝。請參閱下面適當的章節，以取得詳細資訊。
經由 Web 安裝
以下說明解釋了如何從 Sun ONE 網站下載 MQ 產品並在 Solaris 上進行安裝。
在 Solaris 上安裝從 Web 下載的 MQ
- 將 MQ 產品從網站下載至空白的暫存工作目錄。
- 執行以下指令程序檔：
sh imq3_0_1-edition-solsparc.sh
其中，edition 套用下列值之一：plt 或 ent，分別對應於安裝平台版或企業版。
該指令會顯示產品授權的首頁。
- 閱讀產品授權。必須接受授權合約，才能安裝與使用該產品。
- 若要一次在一個頁面上顯示整個授權，請重複按下空格鍵。當您閱讀到授權的末尾時，程式會提示您接受授權。
- 解壓縮歸檔檔案：
/bin/zcat imq3_0_1-edition-solsparc.tar.Z | tar xvfp -
將建立新目錄 imq3_0_1-pkgs。
- 變更目錄：
cd imq3_0_1-pkgs
- 成為 root：
su root
- 請確定哪一個 (若有) 隨附MQ 的共用套裝軟體已被安裝在系統上。
若要查看此類套裝軟體的清單，請輸入：
pkginfo SUNWaclg SUNWjaf SUNWjhrt SUNWjmail SUNWxsrt
輸出結果會顯示已經安裝的套裝軟體以及無法找到的套裝軟體。
- 執行 pkgadd 指令以安裝套裝軟體：
pkgadd -d ./
pkgadd 公用程式將列示目錄中可用於安裝的所有套裝軟體名稱 (請參閱表格 2-2)。當出現提示時，請指示您要安裝的套裝軟體。(請勿安裝步驟 8 中所找到的任何共用套裝軟體。)
pkgadd 公用程式會安裝您指定的套裝軟體，也許會要求您提供其他資訊，最後返回至原來的提示，顯示可用於安裝的套裝軟體清單。
表格 2-3 提供了針對不同使用方案需要的套裝軟體的指南：
- 輸入 q 以退出。
- 退出 root shell。
- 備份暫存工作目錄中的 imq3_0_1-edition-solsparc.sh 檔案。
該檔案是您的邏輯媒體。將此檔案和任何其他安裝媒體一樣看待。將該檔案的副本放置在安全的位置，以便在出現需要重新安裝產品的情形時 (如系統發生故障) 使用。
- 清除暫存工作目錄中所有剩餘的檔案。
經由 CD-ROM 安裝
以下說明解釋了如何經由 CD-ROM 在 Solaris 上安裝 MQ 產品。
經由 CD-ROM 在 Solaris 上安裝 MQ
- 以 root 身份登入或變更為超級使用者。
例如，在指令提示下輸入以下內容：
su root
然後輸入您的超級使用者密碼。
- 將 MQ CD 插入 CD-ROM 光碟機。
如果您的機器上正在執行 Volume Manager™ 軟體，則 CD-ROM 會自動裝載至 /cdrom/messagequeue3_0_1 目錄。
如果您的機器上沒有執行 Volume Manager：
- 變更為 CD 中包含安裝套裝軟體的目錄。例如，輸入：
cd /cdrom/messagequeue3_0_1/solaris/imq3_0_1-pkgs
該目錄的內容根據產品版本的不同而有所變更。
- 執行 pkgadd 指令以安裝套裝軟體：
pkgadd -d ./
pkgadd 公用程式將列示目錄中可用於安裝的所有套裝軟體名稱。當出現提示時，請指示您要安裝的套裝軟體 (請參閱表格 2-2)。
- 當 pkgadd 提示返回時，請輸入 q 以退出。
- 退出 root shell。
配置 MQ 以進行自動啟動如果您要將代理程式 (MQ 訊息伺服器) 設定為自動啟動，則需要成為 root，然後編輯以下配置檔案：
/etc/imq/imqbrokerd.conf
表格 2-4 中顯示了您可以在此配置檔案中設定的啟動特性：
若要檢查啟動變更是否正確 (未啟動系統)，您可以以 root 身份，在「除錯」模式下明確執行 MQ 初始化程序檔 (S52imq)：
env DEBUG=1 /etc/rc3.d/S52imq start
針對 MQ 配置 Java 執行階段啟動時，代理程式 (MQ 訊息伺服器) 會進行檢查，以確定它可以存取所需的 Java 執行階段版本 (JDK/JRE 1.4)。
您必須安裝正確的 JDK/JRE 才能執行 MQ。如需有關 MQ 所支援的 JDK/JRE 之更多資訊，請參閱表格 1-1。
您可以使用許多方法來配置或設定代理程式所使用的 JRE。以下清單依照優先順序顯示了這些方法：
若要查明代理程式為何要挑選特定 JDK/JRE，您可以透過以下指令啟動代理程式：
imqbrokerd -verbose
升級版本MQ 具有兩個版本，如產品版本中所述。
若要從平台版升級至企業版，您需要安裝企業版授權。該安裝不會覆寫已安裝的 MQ 模組，也不會修改 MQ 訊息傳送系統的配置。
若要安裝企業版授權，您只需取得企業版中包含的 SUNWiqlen 套裝軟體。執行安裝指令程序檔、解壓縮檔案歸檔、解壓縮歸檔檔案之後，SUNWiqlen 套裝軟體會自動放置在 imq3_0_1-pkgs 目錄 (Web 安裝) 或 solaris/imq3_0_1-pkgs 目錄 (CD-ROM 安裝) 中。
在 Solaris 上升級至企業版
如何執行下一步讀取 README 與 MQ 版次注意事項檔案。
如需 Sun ONE Message Queue 概念摘要以及撰寫與編譯用戶端應用程式的簡短說明，請參閱「MQ 開發人員指南」。
如需有關配置代理程式與管理 MQ 訊息傳送系統的詳細資訊，請參閱「MQ 管理員指南」。
如需撰寫用戶端應用程式時使用的類別與成員資訊，請瀏覽 /usr/share/javadoc/imq 目錄中的 API 說明文件。
若要解除安裝產品，請參閱下面的章節。
解除安裝 Solaris 上的 MQ以下說明解釋了如何解除安裝 MQ。
解除安裝 Solaris 上的 MQ
- 停止正在執行的任何用戶端應用程式。
- 停止正在執行的任何代理程式。
imqcmd shutdown bkr -u name -p password [-b hostName:port]
- 除非您要保留動態代理程式資料，否則，請移除與每個代理程式實例關聯的所有資料檔。
imqbrokerd -name brokerName -remove instance
- 如果想保留 MQ 平面檔使用者儲存庫以及 MQ 存取控制檔案，請在移除 MQ 套裝軟體 (可以在重新安裝或升級 MQ 之後復原這些檔案) 之前，將下列檔案複製到某個安全的位置：
/etc/imq/passwd
/etc/imq/accesscontrol.properties
- 確定要安裝的 MQ 套裝軟體。
若要使用 pkginfo 查看系統上安裝的 MQ 套裝軟體清單，請輸入：
pkginfo | grep SUNWiq
輸出結果不會顯示系統上由 MQ 安裝的共用套裝軟體 (SUNWaclg、SUNWjaf、SUNWjhrt、SUNWjmail 以及 SUNWxsrt)。除非您升級至更高版本的 MQ，(從而用更新版本的套裝軟體取代這些共用套裝軟體)，否則，建議您不要移除共用套裝軟體。
- 透過輸入以下指令來成為 root：
su root
當出現提示時，輸入您的 root 密碼。
- 移除透過 pkgadd 安裝的 MQ 套裝軟體。
發出以下指令：
pkgrm packageName
其中，packageName 為透過 pkgadd 安裝的任意 MQ 套裝軟體或共用套裝軟體。若要移除多個套裝軟體，請以空格隔開各個套裝軟體的名稱。
由於其他產品可能正在使用 MQ 套裝軟體，因此，移除這些套裝軟體時需格外小心。在移除套裝軟體之前，pkgrm 指令會警告您注意該套裝軟體上的附屬物件。
- 當出現提示時，透過輸入 y，確認您的移除要求。
