Sun Java System Message Queue 3.7 UR1 管理指南

代理实用程序

代理实用程序 (imqbrokerd) 用于启动代理。命令行选项将覆盖代理配置文件中的值，但仅对当前代理会话有效。

表 13–1 显示了 imqbrokerd 命令的选项以及被每个选项覆盖的配置属性（如果有）。

表 13–1 代理实用程序选项


选项	被覆盖的属性	描述
`-name` `instanceName`	`imq.instancename`	代理的实例名称在同一主机上运行的多个代理实例必须具有不同的实例名称。默认值：`imqbroker`
`-port` `portNumber`	`imq.portmapper.port`	代理端口映射器的端口号 Message Queue 客户端使用此端口号连接到代理。在同一主机上运行的多个代理实例必须具有不同的端口映射器端口号。默认值：`7676`
`-cluster` `broker1` [ [ `,` `broker2` ] … ]	`imq.cluster.brokerlist`	将代理连接到群集 [仅适用于代理群集] 将指定的代理与 `imq.cluster.brokerlist` 属性中的列表合并。每个代理参数具有以下形式之一： `hostName:` `portNumber` `hostName` `:portNumber` 如果省略 `hostName`，则默认值为 `localhost`；如果省略 `portNumber`，则默认值为 `7676`。
`-Dproperty=` `value`	实例配置文件中对应的属性	设置配置属性有关代理配置属性的信息，请参见第 14 章，代理属性参考。注意：请仔细检查使用此选项设置的属性的拼写和格式。不正确的值将被忽略，且系统不会给出任何通知或警告。
`-reset props`	无	重置配置属性用空文件替换代理的现有实例配置文件 `config.properties`；所有属性都采用默认值。
`-reset store`	无	重置持久性数据存储库从数据存储库中清除所有持久性数据（包括持久性消息、长期订阅和事务信息），以便您可以启动一个无任何数据记录的代理实例。为了防止在以后重新启动时重置持久性存储库，请不要使用 `-reset` 选项重新启动代理实例。如果仅清除持久性消息或长期订阅，请改用 `-reset` `messages` 或 `-reset` `durables` 。
`-reset messages`	无	从数据存储库中清除持久性消息
`-reset durables`	无	从数据存储库中清除长期订阅
`-backup` `fileName`	无	将配置更改记录备份到文件中有关详细信息，请参见管理配置更改记录。
`-restore` `fileName`	无	从备份文件中恢复配置更改记录该备份文件必须是以前使用 `-backup` 选项创建的。有关详细信息，请参见管理配置更改记录。
`-remove instance`	无	删除代理实例 [除非还指定了 `-force`，否则要求用户进行确认。] 删除与实例关联的实例配置文件、日志文件、持久性存储库以及其他文件和目录。
`-password` `keyPassword`	`imq.keystore.password`	SSL 证书密钥库的密码 [不建议使用此选项，它最终将被删除。请省略该密码（这样，系统将以交互的方式提示用户输入密码）或使用 `-passfile` 选项来指定包含密码的文件。]
`-dbuser` `userName`	`imq.persist.jdbc.user`	基于 JDBC 的持久性数据存储库的用户名
`-dbpassword` `dbPassword`	`imq.persist.jdbc.password`	基于 JDBC 的持久性数据存储库的密码
`-ldappassword` `ldapPassword`	`imq.user_repository.ldap.password`	LDAP 用户系统信息库的密码
`-passfile` `filePath`	`imq.passfile.enabledimq.passfile. dirpathimq.passfile.name`	密码文件的位置将代理的 `imq.passfile.enabled` 属性设置为 `true`，将 `imq.passfile.dirpath` 属性设置为包含密码文件的路径，将 `imq.passfile.name` 属性设置为文件名自身。有关详细信息，请参见密码文件。
`-shared`	`imq.jms.threadpool_model`	使用共享线程池模型实现 `jms` 连接服务将在连接之间共享执行线程，以增加支持的连接数。将代理的 `imq.jms.threadpool_model` 属性设置为 `shared`。
`-javahome` `path`	无	可选 Java 运行时环境的位置默认行为：使用系统上安装的运行时环境或 Message Queue 附带的运行时环境。
`-vmargs` `arg1` [ [ `arg2` ] … ]	无	将参数传递给 Java 虚拟机参数是以空格分隔的。要传递多个参数或包含空格的参数，请将参数列表置于引号中。只能从命令行中传递 VM 参数；在实例配置文件中没有关联的配置属性。
`-license` [ `licenseName` ]	无	要装入的许可证（如果与所安装的 Message Queue 产品版本的默认许可证不同）： `pe`：具有基本功能的 Platform Edition `try`：具有企业功能的 Platform Edition（90 天试用版） `unl`：Enterprise Edition 如果未指定许可证名称，此选项将列出系统上安装的所有许可证。
`-upgrade-store-nobackup`	无	从不兼容版本升级到 Message Queue 3.5 或 3.5 SP`x` 时自动删除旧的数据存储库有关详细信息，请参见 Message Queue 安装指南。
`-force`	无	执行操作时无需用户确认此选项仅适用于 `-remove` `instance` 和 `- upgrade-store-nobackup` 选项，这两个选项通常要求确认。
`-loglevel` `level`	`imq.broker.log.level`	日志记录级别： `NONE` `ERROR` `WARNING` `INFO` 默认值：`INFO`
`-metrics` `interval`	`imq.metrics.interval`	代理度量的日志记录时间间隔（以秒为单位）
`-tty`	`imq.log.console.output`	将所有消息记录到控制台将代理的 `imq.log.console.output` 属性设置为 `ALL`。如果未指定，将只记录错误和警告消息。
`-s` \| `-silent`	`imq.log.console.output`	无提示模式（不向控制台记录消息）将代理的 `imq.log.console.output` 属性设置为 `NONE`。
`-version`	无	显示版本信息 [忽略命令行中指定的任何其他选项。]
`-h` \| `-help`	无	显示使用帮助