|
| |
| Sun Java System Message Queue 3.5 SP1 管理指南 | |
附录 D
使用代理作为 Windows 服务本附录说明如何使用服务管理器 (imqsvcadmin) 实用程序安装、查询和删除作为 Windows 服务运行的代理。
将代理作为 Windows 服务运行安装 Message Queue 时，可以选择将代理安装为 Windows 服务。安装了 Message Queue 后，还可以使用 imqsvcadmin 将代理安装为 Windows 服务。
将代理安装为 Windows 服务意味着它将在系统启动时启动，并在后台运行直到系统关闭。因此，不使用 imqbrokerd 命令启动代理，除非希望启动其他实例。要将任何启动选项传递给代理，可以使用 imqsvcadmin 命令的 -args 参数（请参见表 D-2）并准确指定您希望 imqbrokerd 命令使用的选项（请参见“启动代理”）。照常使用 imqcmd 命令来控制代理操作。
当作为 Windows 服务运行时，任务管理器将代理列为两个可执行的进程。第一个是本地 Windows 服务包装程序 imqbrokersvc.exe。第二个是实际运行代理的 Java 运行时。
一次只能安装一个代理并作为 Windows 服务运行。
服务管理器实用程序 (imqsvcadmin)可以使用服务管理器实用程序 (imqsvcadmin) 安装、查询和删除作为 Windows 服务运行的代理。本节介绍了 imqsvcadmin 命令的基本语法，提供了一个子命令列表，概述了 imqsvcadmin 命令选项，并说明了如何使用这些命令执行特定的任务。
imqsvcadmin 命令语法
imqsvcadmin 命令的一般语法如下：
imqsvcadmin subcommand [options]
imqsvcadmin -h
请注意，如果指定 -v、-h 或 -H 选项，将不会执行命令行中指定的其他子命令。例如，输入以下命令将显示帮助信息，而不是执行 query 子命令。
imqsvcadmin query -h
imqsvcadmin 子命令
表 D-1 列出了 Message Queue 服务管理器实用程序 (imqsvcadmin) 包含的子命令：
表 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 选项。
疑难解答
如果试图启动服务时收到错误消息，可以通过执行以下操作查看记录的错误事件。
查看记录的服务错误事件