代理程式配置檔案含有配置代理程式時所需的特性設定。這些設定會根據您所使用的作業系統平台存放在適當的目錄中;請參閱附錄 AMessage QueueTM 資料的特定平台位置,以瞭解詳細資訊。此目錄儲存以下檔案:
預設配置檔案 default.properties,在啟動時載入。此檔案不可編輯,但您可以閱讀此檔案以確定預設值,並找到要變更之特性的確切名稱。
安裝配置檔案 install.properties,包含安裝 Message Queue 時指定的所有屬性。此檔案在安裝後無法編輯。
此外,各個代理程式實例也有其本身的實例配置檔案,如下所述。如果您連線叢集中的代理程式實例,可能還需要使用叢集配置檔案以指定叢集配置資訊;如需更多資訊,請參閱叢集配置特性。
啟動時,代理程式會合併不同配置檔案中的特性值。如圖 4–4 所示,這些檔案會形成一個階層,在此階層中,實例配置檔案的指定值會置換安裝配置檔案中的指定值,而安裝配置檔案中的指定值則會置換預設配置檔案中的指定值。在階層頂端,您可以手動置換任何在配置檔案中指定的特性值,只要使用 imqbrokerd 指令的指令行選項即可。
首次執行代理程式時,會為該代理程式實例建立一個包含配置特性的實例配置檔案。此實例配置檔案名為 config.properties,儲存在以其所屬之代理程式實例名稱所識別的目錄中:
…/instances/ instanceName/props/config.properties
(請參閱附錄 AMessage QueueTM 資料的特定平台位置,以瞭解 instances 目錄的所在位置。)若該檔案不存在,您必須在啟動代理程式時使用 -name 選項 (請參閱代理程式公用程式),指定可供 Message Queue 建立檔案的實例名稱。
instances/instanceName 目錄和實例配置檔案,歸其對應的代理程式實例的建立者所有。代理程式實例必須始終由同一個使用者重新啟動。
實例配置檔案由代理程式實例所維護,並會在您使用 Message Queue 管理公用程式變更配置時進行修改。您也可以手動編輯實例配置檔案,以自訂代理程式的運作方式與資源使用。若要執行此動作,您必須是 instances/ instanceName 目錄的擁有者,或以 root 的身份登入並變更目錄的存取權限。
代理程式只能在啟動時讀取其實例配置檔案。若要對代理程式的配置進行永久性的變更,必須先關閉代理程式並編輯檔案,然後再重新啟動代理程式。該檔案 (或任何配置檔案) 中的特性定義會使用下列語法:
propertyName=value [[,value1] …]
例如,以下項目指定代理程式會在記憶體和永久性存放區中最多保留 50,000 個訊息,之後則會拒絕其他訊息:
imq.system.max_count=50000
以下項目指定每天 (86,400 秒) 會建立一個新的記錄檔:
imq.log.file.rolloversecs=86400
請參閱代理程式服務與第 14 章, 代理程式特性參照,以瞭解可用代理程式配置特性及其預設值的相關資訊。
您可以在啟動代理程式時或啟動之後,在指令行上輸入代理程式配置選項。
啟動時,可以使用代理程式公用程式 (imqbrokerd) 來啟動代理程式實例。使用指令的 -D 選項,可用以指定任何代理程式配置特性及其值;如需更多資訊,請參閱啟動代理程式與代理程式公用程式。如果您使用服務管理員公用程式 (imqsvcadmin) 將代理程式啟動為 Windows 服務,則 -args 選項可用來指定啟動配置特性;請參閱服務管理員公用程式。
執行代理程式實例時,您也可以變更某些代理程式特性。若要修改執行中代理程式的配置,可以使用指令公用程式的 imqcmd update bkr 指令;請參閱更新代理程式特性與代理程式管理。