|
| Sun ONE Message Queue, Version 3.0.1 管理員指南 |
本附錄介紹如何使用服務管理員 (imqsvcadmin) 公用程式來安裝、查詢和移除作為 Windows 服務執行的代理程式。
將代理程式作為 Windows 服務執行
當您安裝 Sun™ ONE Message Queue (MQ) 3.0.1 時，您可以選擇將代理程式作為 Windows 服務安裝。在安裝 MQ 3.0.1 之後，您還可以使用 imqsvcadmin 將代理程式作為 Windows 服務安裝。
將代理程式作為 Windows 服務安裝，意味著此代理程式將在系統啟動時啟動，並在後台執行直至關機。因此，您不必使用 imqbrokerd 指令啟動代理程式，除非您要啟動其他實例。若要將所有啟動選項傳送至代理程式，您可以使用 imqsvcadmin 指令 (請參閱表格 C-2) 的 -args 引數，並確切地指定您已為 imqbrokerd 指令 (請參閱啟動代理程式) 使用的相同選項。使用 imqcmd 指令以控制代理程式照常作業。
當代理程式作為 Windows 服務執行時，[工作管理員] 會將代理程式作為兩個可執行程序列出。第一個程序是 imqbrokersvc.exe，這是原生 Windows 服務包裝。第二個程序是實際執行代理程式的 Java 運行時間。
每次只能將一個代理程式作為 Windows 服務安裝並執行。
服務管理員公用程式 (imqsvcadmin)
服務管理員公用程式 (imqsvcadmin) 可讓您安裝、查詢和移除代理程式 (作為 Windows 服務執行)。本節描述 imqsvcadmin 指令的基本語法、提供子指令的清單、總結 imqsvcadmin 指令選項，並介紹如何使用這些指令來完成特定的工作。
指令的語法
imqsvcadmin 指令的一般語法如下：
imqsvcadmin subcommand [options]
imqsvcadmin -h
請注意，如果您指定 -v、-h、或 -H 選項，則系統不會執行指令行上指定的其他子指令。例如，如果您輸入以下指令，則系統會顯示說明資訊但不會執行 query 子指令。
imqsvcadmin query -h
imqsvcadmin 子指令
MQ 服務管理員公用程式 (imqsvcadmin) 包括表格 C-1 中列出的子指令：
表格 C-1 imqsvcadmin 子指令
子指令
描述
install
安裝服務並指定啟動選項。
query
顯示 imqsvcadmin 指令的啟動選項。這包括服務是手動啟動還是自動啟動、服務的位置、Java 運行時間的位置以及啟動時傳送至代理程式的引數的值。
remove
移除服務。
imqsvcadmin 選項摘要
表格 C-2 列出 imqsvcadmin 指令的選項。如需它們用法的說明，請參閱以下基於工作的各節。
表格 C-2 imqsvcadmin 選項
選項
描述
-h
顯示用法說明。不執行指令行上的其他任何指令。
-javahome path
指定替代 Java 2 相容的 JDK 的路徑。預設為使用隨附的運行時間。
範例︰imqsvcadmin -install -javahome d:\jdk1.4
-jrehome path
指定 Java 2 相容的 JRE 的路徑。
範例︰imqsvcadmin -install -jrehome d:\jre\1.4
-vmargs arg [[arg]...]
指定要傳送至正在執行代理程式服務的 Java VM 的其他引數。(您還可以在 [Windows 服務控制台] 的 [啟動參數] 欄位中指定這些引數。)
範例︰-vmargs "-Xms16m -Xmx128m"
-args arg [[arg]...]
指定要傳送至代理程式服務的其他指令行引數。如需 imqbrokerd 選項的描述，請參閱啟動代理程式。
(您還可以在 [Windows 服務控制台] 的 [啟動參數] 欄位中指定這些引數。)例如，
imqsvcadmin -install
-args "-passfile d:\imqpassfile"
您使用 -javahome、-vmargs 和 -args 選項指定的資訊，儲存在 Window 登入檔中的關鍵字 JavaHome、JVMArgs 和 ServiceArgs 下，路徑為
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
\Services\iMQ_Broker\Parameters移除代理程式服務
在移除代理程式服務之前，您應使用 imqcmd shutdown bkr 指令關閉代理程式。然後使用 imqsvcadmin remove 指令移除服務，並重新啟動電腦。
重新配置代理程式服務
若要重新配置服務，請先移除此服務，然後將其重新安裝，並指定帶有 -args 引數的不同啟動選項。
使用替代 Java 運行時間
您可以使用 -javahome 或 -jrehome 選項來指定替代 Java 運行時間的位置。您還可以在 [Windows 服務控制台] 的 [啟動參數] 欄位中指定這些選項。請注意，[啟動參數] 欄位將反斜線 (\) 看作一個退出字元，因此當將反斜線用作路徑分割元時，您必須將其鍵入兩次；例如，-javahome d:\\jdk1.3。
查詢代理程式服務
若要確定代理程式服務的啟動選項，請使用 imqsvcadmin 指令的 -q 選項。
imqsvcadmin -query
Service iMQ_Broker is installed.
Display Name:iMQ_Broker
Start Type:Manual
Binary location:c:\Program Files\Sun Microsystems\
Message Queue 3.0\bin\imqbrokersvc
JavaHome:c:\j2sdk1.4.0
Broker Args:-passfile d:\imqpassfile
疑難排解
如果嘗試啟動服務時出現錯誤，您可以查閱透過執行以下作業記錄的錯誤事件。
查閱記錄的服務錯誤事件
- 啟動 [事件檢視器]。
- 查看 [日誌] > [應用程式]。
- 選取 [檢視] > [重新顯示]，以查閱所有錯誤事件。