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`	無	顯示用法說明