主代理

可以选择为群集指定一个主代理。主代理维护配置更改记录以跟踪群集的持久性状态所发生的任何变化。主代理是使用 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

自动创建的物理目的地和临时目的地均不受影响。

在没有主代理时，任何尝试创建长期订户或取消长期订阅的客户端应用程序都会收到一条错误消息。 但是，客户端可以成功地指定现有长期订阅，并与其进行交互。