启动代理

可以使用 Message Queue 命令行实用程序或 Windows 的“开始”菜单以交互方式启动代理，也可以安排在系统启动时自动启动代理。 以下各节介绍了操作方法。

以交互方式启动代理

也可以使用代理实用程序 (imqbrokerd) 从命令行中以交互方式启动代理。 （或者，也可以从 Windows 的“开始”菜单中启动代理。）但不能使用管理控制台 (imqadmin) 或命令实用程序 (imqcmd) 启动代理；只有在代理已经运行后才能使用这些工具。

在 Solaris 和 Linux 平台上，代理实例必须始终由最初启动该实例的用户启动。 每个代理实例都有其自身的一组配置属性和基于文件的消息存储库。首次启动代理实例时，Message Queue 将使用用户的文件创建模式掩码 (umask ) 来设置该代理实例的配置信息和持久性数据所在目录的权限。

默认情况下，代理实例具有实例名称 imqbroker。要从命令行中使用此名称和默认配置启动代理，只需使用以下命令：

imqbrokerd

此命令使用端口映射器的默认端口 7676 启动本地计算机上名为 imqbroker 的代理实例（请参见端口映射器）。

要指定非默认的实例名称，请使用 imqbrokerd 命令的 - name 选项。以下命令启动实例名称为 myBroker 的代理：

imqbrokerd -name myBroker

在 imqbrokerd 命令行中，还可以使用其他选项来控制代理操作的各个方面。 下面的示例使用 - tty 选项向命令窗口发送错误消息和警告（标准输出）：

imqbrokerd -name myBroker -tty

也可以在命令行中使用 -D 选项来覆盖在代理实例配置文件 (config.properties) 中指定的属性值。 下面的示例设置 imq.jms.max_threads 属性，将 jms 连接服务可用的最大线程数提高到 2000：

imqbrokerd -name myBroker -Dimq.jms.max_threads=2000

有关 imqbrokerd 命令的语法、子命令和选项的完整信息，请参见代理实用程序。要了解此信息的简要概述，请输入以下命令：

imqbrokerd -help

如果您具有 Sun Java System Message Queue Platform Edition 许可证，则可以使用 imqbrokerd 命令的 - license 选项来激活试用版 Enterprise Edition 许可证，它允许您试用 Enterprise Edition 功能 90 天。 指定 try 作为许可证名称：

imqbrokerd -license try

每次启动代理时都必须使用此选项，否则，代理将默认使用标准 Platform Edition 许可证。

自动启动代理

可以将代理设置为在系统启动时自动启动，而不是在命令行中明确启动它。 具体操作方法取决于运行代理的平台（Solaris、Linux 或 Windows）。

在 Solaris 和 Linux 上自动启动

在 Solaris 和 Linux 系统上，使代理可以自动启动的脚本在 Message Queue 安装期间放在 /etc/rc* 目录树中。 要允许使用这些脚本，您必须按如下所示编辑配置文件 /etc/imq/imqbrokerd.conf (Solaris) 或 /etc/opt/sun/mq/imqbrokerd.conf (Linux)：

• 要在系统启动时自动启动代理，请将 AUTOSTART 属性设置为 YES。

• 要使代理在异常退出后自动重新启动，请将 RESTART 属性设置为 YES。

• 要为代理设置启动命令行参数，请为 ARGS 属性指定一个或多个值。

在 Windows 上自动启动

要在 Windows 系统启动时自动启动代理，必须将代理定义为 Windows 服务。 代理将在系统启动时启动并在后台运行，直到系统关闭。因此，不要使用 imqbrokerd 命令启动代理，除非您希望启动其他实例。

系统最多只能有一个作为 Windows 服务运行的代理。任务管理器将此类代理作为两个可执行进程列出：

• 本地 Windows 服务包装 imqbrokersvc.exe

• 正在运行代理的 Java 运行时环境

在 Windows 系统上，可以在安装 Message Queue 时将代理作为服务安装。 安装后，可以使用服务管理器实用程序 (imqsvcadmin) 执行以下操作：

• 将代理作为 Windows 服务添加

• 确定代理服务的启动选项

• 删除作为 Windows 服务运行的代理

要将启动选项传递给代理，请使用 imqsvcadmin 命令的 -args 参数。其工作方式与 imqbrokerd 命令的 -D 选项相同，如启动代理中所述。可以照常使用命令实用程序 (imqcmd) 来控制代理操作。

有关 imqsvcadmin 命令的语法、子命令和选项的完整信息，请参见服务管理器实用程序。

重新配置代理服务

重新配置作为 Windows 服务安装的代理的过程如下：

重新配置作为 Windows 服务的代理

1. 停止服务。

   1. 在 Windows“开始”菜单的“设置”子菜单中选择“控制面板”。

   2. 打开“管理工具”控制面板。

   3. 使用以下方法运行“服务”工具：选择该工具的图标，然后从“文件”菜单或弹出的上下文菜单中选择“打开”，或者仅双击该图标即可。

   4. 在“服务（本地）”下，选择 "Message Queue Broker" 服务，然后从“动作”菜单中选择“属性”。

      或者，也可以在 "Message Queue Broker" 上单击鼠标右键，然后从弹出的上下文菜单中选择“属性”，或者仅双击 "Message Queue Broker" 即可。无论在哪种情况下，都会显示“Message Queue Broker 属性”对话框。

   5. 在“属性”对话框中的“常规”选项卡下，单击“停止”以停止代理服务。

2. 删除服务。

   在命令行中输入以下命令：

   imqsvcadmin remove

3. 重新安装服务，并使用 -args 选项指定不同的代理启动选项，或使用 -vmargs 选项指定不同的 Java 版本参数。

   例如，要将服务的主机名和端口号分别更改为 broker1 和 7878，可以使用以下命令：

   imqsvcadmin install -args "-name broker1 -port 7878"

使用可选 Java 运行时环境

可以使用 imqsvcadmin 命令的 -javahome 或 -jrehome 选项指定可选 Java 运行时环境的位置。 （还可以在服务“属性”对话框“常规”选项卡下的“启动参数”字段中指定这些选项。）

“启动参数”字段将反斜杠字符 (\) 视为转义符，因此在将反斜杠用作路径分隔符时必须键入两次， 例如，

-javahome c:\\j2sdk1.4.0

显示代理服务启动选项

要确定代理服务的启动选项，请使用 imqsvcadmin 命令的 query 选项，如示例 3–1 中所示。

示例 3–1 显示代理服务启动选项

imqsvcadmin query

Service Message Queue Broker is installed.
Display Name: Message Queue Broker
Start Type: Automatic
Binary location: C:\\Sun\\MessageQueue\\bin\\imqbrokersvc.exe
JavaHome: c:\\j2sdk1.4.0
Broker Args: -name broker1 -port 7878

服务启动问题疑难解答

如果试图启动作为 Windows 服务的代理时出现错误，您可以查看记录的错误事件：

查看记录的服务错误事件

1. 打开 Windows 的“管理工具”控制面板。

2. 启动“事件查看器”工具。

3. 选择“应用程序事件日志”。

4. 从“动作”菜单中选择“刷新”以显示所有错误事件。