設定代理程式特性

您可以使用下列兩種方法之一來指定代理程式的配置特性：

• 編輯代理程式的配置檔案

• 直接從指令行提供特性值

以下兩節將說明這兩種配置代理程式的方法。

配置檔案

代理程式配置檔案含有配置代理程式時所需的特性設定。這些設定會根據您所使用的作業系統平台存放在適當的目錄中；請參閱附錄 AMessage Queue^TM 資料的特定平台位置，以瞭解詳細資訊。此目錄儲存以下檔案：

• 預設配置檔案 default.properties，在啟動時載入。此檔案不可編輯，但您可以閱讀此檔案以確定預設值，並找到要變更之特性的確切名稱。

• 安裝配置檔案 install.properties，包含安裝 Message Queue 時指定的所有屬性。此檔案在安裝後無法編輯。

此外，各個代理程式實例也有其本身的實例配置檔案，如下所述。如果您連線叢集中的代理程式實例，可能還需要使用叢集配置檔案以指定叢集配置資訊；如需更多資訊，請參閱叢集配置特性。

啟動時，代理程式會合併不同配置檔案中的特性值。如圖 4–4 所示，這些檔案會形成一個階層，在此階層中，實例配置檔案的指定值會置換安裝配置檔案中的指定值，而安裝配置檔案中的指定值則會置換預設配置檔案中的指定值。在階層頂端，您可以手動置換任何在配置檔案中指定的特性值，只要使用 imqbrokerd 指令的指令行選項即可。

圖 4–4 代理程式配置檔案

編輯實例配置檔案

首次執行代理程式時，會為該代理程式實例建立一個包含配置特性的實例配置檔案。此實例配置檔案名為 config.properties，儲存在以其所屬之代理程式實例名稱所識別的目錄中：

…/instances/ instanceName/props/config.properties

(請參閱附錄 AMessage Queue^TM 資料的特定平台位置，以瞭解 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 指令；請參閱更新代理程式特性與代理程式管理。