15.6. 在多站点、容错消息传递系统中配置客户端
内部客户端应用程序是一个在位于与代理服务器相同数据中心的计算机上运行的机器上。下图显示了此拓扑。
外部客户端应用程序是在位于代理数据中心之外的计算机上运行的。下图显示了此拓扑。
以下子章节描述了在数据中心停机时将您的内部和外部客户端应用程序连接到另一个数据中心的备份代理的示例。
15.6.1. 配置内部客户端
如果您遇到数据中心停机，内部客户端应用程序将与您的代理一起关闭。为了缓解这种情况，您必须在单独的数据中心中获得另一个客户端应用程序实例。如果数据中心中断，您可以手动启动备份客户端，以连接到您也手动启动的备份代理。
要启用备份客户端连接到备份代理，您需要像主数据中心中客户端一样配置客户端连接。
示例
AMQ Core Protocol JMS 客户端到 master-slave 代理组的基本连接配置如下所示。在本例中，host1 和 host2 是主代理和从属代理的主机服务器。
<ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(“(tcp://host1:port,tcp://host2:port)?ha=true&retryInterval=100&retryIntervalMultiplier=1.0&reconnectAttempts=-1”);
要将备份客户端配置为在数据中心停机时连接到备份代理，请使用类似的连接配置，但仅指定备份代理服务器的主机名。在本例中，备份代理服务器是 host3。
<ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(“(tcp://host3:port)?ha=true&retryInterval=100&retryIntervalMultiplier=1.0&reconnectAttempts=-1”);
其他资源
- 有关配置代理网络连接的详情请参考 第 2 章 在网络连接中配置接收器和连接器。
15.6.2. 配置外部客户端
要让外部代理客户端在数据中心停机时继续生成或消耗消息传递数据，您必须将客户端配置为故障转移到另一个数据中心的代理。如果是多站点容错系统，您可以将客户端配置为故障转移到您在停机时手动启动的备份代理。
例子
下面是将 AMQ Core Protocol JMS 和 AMQ JMS 客户端配置为在主 master-slave 组不可用时切换到备份代理的示例。在这些示例中，host1 和 host2 是主主代理的主机服务器，host3 则是您在数据中心停机时手动启动备份代理的主机服务器。
要配置 AMQ Core Protocol JMS 客户端，请在客户端试图连接的代理列表中包括备份代理。
<ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(“(tcp://host1:port,tcp://host2:port,tcp://host3:port)?ha=true&retryInterval=100&retryIntervalMultiplier=1.0&reconnectAttempts=-1”);
要配置 AMQ JMS 客户端，请在您在客户端上配置的故障切换 URI 中包含备份代理。
failover:(amqp://host1:port,amqp://host2:port,amqp://host3:port)?jms.clientID=foo&failover.maxReconnectAttempts=20
其他资源
有关配置故障切换的更多信息：
- AMQ Core Protocol JMS 客户端，请参阅重新连接和故障转移。
- AMQ JMS 客户端请参见 故障切换选项。
- 其他支持的客户端，参考 AMQ Clients 部分中的特定于客户端的文档： Red Hat AMQ Clients 2.11 产品文档。
