上一章 目录 索引 下一章 |
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 选项。

> 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. 选择查看刷新，以查看所有的错误事件。

> 上一章 目录 索引 下一章

> 版权所有 2004 Sun Microsystems, Inc. 保留所有权利。