Sun ONE logo     上一个      目录      索引      下一个     
Sun ONE Message Queue, Version 3.0.1 管理员指南



附录 C   使用代理作为 Windows 服务

本附录说明如何使用服务管理器 (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 注册表关键字 JavaHomeJVMArgsServiceArgs 下,路径为

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

疑难解答

如果试图启动服务时收到错误消息,可以通过执行以下操作查看记录的错误事件。

查看记录的服务错误事件的步骤

  1. 启动事件查看器。
  2. 找到“日志”>“应用程序”。
  3. 选择“查看”>“刷新”,以查看错误事件。

上一个      目录      索引      下一个     
版权所有 2002 Sun Microsystems, Inc.。保留所有权利。


部件号 817-5020-10