![]() |
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 命令的 -args 参数(请参阅表 C-2)并准确指定您希望 imqbrokerd 命令使用的选项(请参阅启动代理)。用来控制代理操作的命令仍然是 imqcmd。
当作为 Windows 服务运行时,任务管理器将代理列为两个可执行的进程。第一个是本地 Windows 服务包装程序 imqbrokersvc.exe。第二个是实际运行代理的 Java 运行时。
一次只能安装一个代理并作为 Windows 服务运行。
服务管理器实用程序 (imqsvcadmin)
可以使用服务管理器实用程序 (imqsvcadmin) 安装、查询和删除作为 Windows 服务运行的代理。本节介绍了 imqsvcadmin 命令的基本语法,提供了一个子命令列表,概述了 imqsvcadmin 命令选项,并说明了如何使用这些命令执行特定的任务。
命令语法
imqsvcadmin 命令的一般语法如下:
imqsvcadmin subcommand [options]
imqsvcadmin -h
请注意,如果指定 -v、-h 或 -H 选项,将不会执行命令行中指定的其它子命令。例如,输入以下命令将显示帮助信息,而不是执行 query 子命令。
imqsvcadmin query -h
imqsvcadmin 子命令
表 C-1 列出了 MQ 服务管理器实用程序 (imqsvcadmin) 包含的子命令:
表 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 选项指定的信息存储在 Windows 注册表关键字 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
疑难解答
如果试图启动服务时收到错误消息,可以通过执行以下操作查看记录的错误事件。
查看记录的服务错误事件的步骤
- 启动事件查看器。
- 找到“日志”>“应用程序”。
- 选择“查看”>“刷新”,以查看错误事件。