主代理程式

您可以選擇是否讓叢集擁有一個主代理程式，它可維護配置變更記錄，以記錄叢集持續性狀態中的任何變更。無論在叢集配置檔案或個別代理程式的實例配置檔案中，主代理程式都是由 imq.cluster.masterbroker 配置特性所識別。

配置變更記錄包含與叢集相關聯之永久性實體中的變更資訊，例如長期訂閱和管理員建立之實體目標。叢集中的所有代理程式會在啟動期間參考主代理程式，以更新這些永久性實體的資訊。主代理程式發生故障時，將無法進行這類同步化作業；如需更多資訊，請參閱當主代理程式無法使用時。

管理配置變更記錄

由於配置變更記錄包含重要資訊，您必須定期進行備份，使其能夠在發生故障的情況下復原。雖然從備份中復原將會失去自當時備份後叢集持續性狀態中的任何變更，但經常定期備份可儘量減低此潛在的資訊遺失。備份與復原作業可以有效地壓縮和最佳化包含在配置變更記錄中的變更歷史，且配置變更記錄能夠隨著時間而迅速增長。

備份配置變更記錄

使用 imqbrokerd 指令的 -backup 選項來指定備份檔案的名稱。例如：

imqbrokerd -backup mybackuplog

復原配置變更記錄

1. 關閉叢集中的所有代理程式。

2. 使用下列指令從備份檔案中復原主代理程式的配置變更記錄

   imqbrokerd -restore mybackuplog

3. 如果您為主代理程式指定一個新的名稱或連接埠號，請相應地在叢集配置檔案中更新 imq.cluster.brokerlist 和 imq.cluster.masterbroker 特性。

4. 重新啟動叢集中的所有代理程式。

當主代理程式無法使用時

由於叢集中的所有代理程式都需要主代理程式才能執行永久性作業，因此沒有可用的主代理程式時，叢集中所有代理程式的下列 imqcmd 子指令都會傳回錯誤：

• create dst

• destroy dst

• update dst

• destroy dur

自動建立的實體目標和暫時目標不受影響。

在未配置主代理程式的環境中，任何嘗試建立或取消長期訂閱的用戶端應用程式都會收到一個錯誤。但是用戶端可以指定並與現有的長期訂閱進行互動。