代理程式公用程式 (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 |
無 |
預設運作方式:使用安裝在系統上或是隨附於 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 SPx 時,自動移除舊的資料存放區 如需更多資訊,請參閱「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 |
無 |
顯示用法說明 |