上一章 目錄 索引 下一章 |
Sun Java System Message Queue 3.5 SP1 管理指南

> ## 附錄D
> 將代理程式用作 Windows 服務

> 本附錄介紹如何使用服務管理員 (imqsvcadmin) 公用程式來安裝、查詢和移除作為 Windows 服務執行的代理程式。

> ##

> 將代理程式作為 Windows 服務執行

> 安裝 Message Queue 時，您可以選擇將代理程式作為 Windows 服務安裝。您也可以在安裝 Message Queue 後，使用 imqsvcadmin 將代理程式作為 Windows 服務安裝。

> 將代理程式作為 Windows 服務安裝，意味著此代理程式將在系統啟動時啟動，並在後台執行直至關機。因此，您不必使用 imqbrokerd 指令啟動代理程式，除非您要啟動其他實例。若要將所有啟動選項傳送至代理程式，您可以使用 imqsvcadmin 指令 (請參閱表 D-2) 的 -args 引數，並確切地指定您已為 imqbrokerd 指令 (請參閱「啟動代理程式」) 使用的相同選項。使用 imqcmd 指令以控制代理程式照常作業。

> 當代理程式作為 Windows 服務執行時，[工作管理員] 會將代理程式作為兩個可執行程序列出。第一個程序是 imqbrokersvc.exe，這是原生 Windows 服務包裝。第二個程序是實際執行代理程式的 Java 運行時間。

> 每次只能將一個代理程式作為 Windows 服務安裝並執行。

> ##

> 服務管理員公用程式 (imqsvcadmin)

> 服務管理員公用程式 (imqsvcadmin) 可讓您安裝、查詢和移除代理程式 (作為 Windows 服務執行)。本節描述 imqsvcadmin 指令的基本語法、提供子指令的清單、總結 imqsvcadmin 指令選項，並介紹如何使用這些指令來完成特定的工作。

> ### imqsvcadmin 指令的語法

> imqsvcadmin 指令的一般語法如下：

> imqsvcadmin subcommand [options]

> imqsvcadmin -h

> 請注意，如果您指定 -v、-h、或 -H 選項，則系統不會執行指令行上指定的其他子指令。例如，如果您輸入以下指令，則系統會顯示說明資訊但不會執行 query 子指令。

> imqsvcadmin query -h

> ### imqsvcadmin 子指令

> Message Queue 服務管理員公用程式 (imqsvcadmin) 包括表 D-1 中列出的子指令：

> 表 D-1 imqsvcadmin 子指令

> 子指令 | 說明
> --- | ---
> install | 安裝服務並指定啟動選項。
> query | 顯示 imqsvcadmin 指令的啟動選項。這包括服務是手動啟動還是自動啟動、服務的位置、Java 運行時間的位置以及啟動時傳送至代理程式的引數的值。
> remove | 移除服務。

> ### imqsvcadmin 選項摘要

> 表 D-2 列出imqsvcadmin 指令的選項。如需它們用法的說明，請參閱以下基於工作的各節。

> 表 D-2 imqsvcadmin 選項

> 選項 | 說明
> --- | ---
> -h | 顯示用法說明。不執行指令行上的其他任何指令。
> -javahome path | 指定要使用的替代 Java 2 相容運行時間的路徑 (預設為使用系統上的運行時間，或 Message Queue 隨附的運行時間)。 範例︰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.5\bin\imqbrokersvc
> JavaHome: c:\j2sdk1.4.0
> Broker Args: -passfile d:\imqpassfile

> ### 疑難排解

> 如果嘗試啟動服務時出現錯誤，您可以查閱透過執行以下作業記錄的錯誤事件。

> #####
> 查閱記錄的服務錯誤事件

> 1. 啟動 [事件檢視器]
> 2. 查看 [日誌] > [應用程式]。
> 3. 選取 [檢視] > [重新顯示]，以查閱所有錯誤事件。

> 上一章 目錄 索引 下一章

> Copyright 2004 Sun Microsystems, Inc. All rights reserved.