14.3. 实施高可用性

流程

1. 将集群中的代理分组到主备份组中。

   在大多数情况下，primary-backup 组应该由两个代理组成：一个主代理和一个备份代理。如果您在集群中有六个代理，则需要三个主备份组。

2. 创建由一个主代理和一个备份代理组成的第一个 primary-backup 组。

   1. 打开主代理的 < broker_instance_dir> /etc/broker.xml 配置文件。

   2. 如果使用：

      1. 用于提供共享存储的网络文件系统，验证主代理的分页、绑定、日志和大型消息目录是否指向备份代理也可以访问的共享位置。

         <configuration>
             <core>
                 ...
                 <paging-directory>../sharedstore/data/paging</paging-directory>
                 <bindings-directory>../sharedstore/data/bindings</bindings-directory>
                 <journal-directory>../sharedstore/data/journal</journal-directory>
                 <large-messages-directory>../sharedstore/data/large-messages</large-messages-directory>
                 ...
             </core>
         </configuration>

         Copy to Clipboard Toggle word wrap

      2. 提供共享存储的数据库，请确保主代理和备份代理可以连接到同一数据库，并在 broker.xml 配置文件的 database-store 元素中指定相同的配置。示例配置如下所示：

         <configuration>
           <core>
             <store>
                <database-store>
                   <jdbc-connection-url>jdbc:oracle:data/oracle/database-store;create=true</jdbc-connection-url>
                   <jdbc-user>ENC(5493dd76567ee5ec269d11823973462f)</jdbc-user>
                   <jdbc-password>ENC(56a0db3b71043054269d11823973462f)</jdbc-password>
                   <bindings-table-name>BIND_TABLE</bindings-table-name>
                   <message-table-name>MSG_TABLE</message-table-name>
                   <large-message-table-name>LGE_TABLE</large-message-table-name>
                   <page-store-table-name>PAGE_TABLE</page-store-table-name>
                   <node-manager-store-table-name>NODE_TABLE<node-manager-store-table-name>
                   <jdbc-driver-class-name>oracle.jdbc.driver.OracleDriver</jdbc-driver-class-name>
                   <jdbc-network-timeout>10000</jdbc-network-timeout>
                   <jdbc-lock-renew-period>2000</jdbc-lock-renew-period>
                   <jdbc-lock-expiration>15000</jdbc-lock-expiration>
                   <jdbc-journal-sync-period>5</jdbc-journal-sync-period>
                </database-store>
             </store>
           </core>
         </configuration>

         Copy to Clipboard Toggle word wrap

   3. 将主代理配置为使用共享存储作为其 HA 策略。

      <configuration>
          <core>
              ...
              <ha-policy>
                  <shared-store>
                      <primary>
                          <failover-on-shutdown>true</failover-on-shutdown>
                      </primary>
                  </shared-store>
              </ha-policy>
              ...
          </core>
      </configuration>

      Copy to Clipboard Toggle word wrap

      failover-on-shutdown

      如果这个代理通常停止，此属性控制备份代理是否应该活跃并接管。

   4. 打开备份代理的 < broker_instance_dir> /etc/broker.xml 配置文件。

   5. 如果使用：

      1. 用于提供共享存储的网络文件系统，验证备份代理的分页、绑定、日志和大型消息目录指向与主代理相同的共享位置。

         <configuration>
             <core>
                 ...
                 <paging-directory>../sharedstore/data/paging</paging-directory>
                 <bindings-directory>../sharedstore/data/bindings</bindings-directory>
                 <journal-directory>../sharedstore/data/journal</journal-directory>
                 <large-messages-directory>../sharedstore/data/large-messages</large-messages-directory>
                 ...
             </core>
         </configuration>

         Copy to Clipboard Toggle word wrap
      2. 提供共享存储的数据库，请确保主代理和备份代理可以连接到同一数据库，并在 broker.xml 配置文件的 database-store 元素中指定相同的配置。

   6. 将备份代理配置为使用共享存储作为其 HA 策略。

      <configuration>
          <core>
              ...
              <ha-policy>
                  <shared-store>
                      <backup>
                          <failover-on-shutdown>true</failover-on-shutdown>
                          <allow-failback>true</allow-failback>
                          <restart-backup>true</restart-backup>
                      </backup>
                  </shared-store>
              </ha-policy>
              ...
          </core>
      </configuration>

      Copy to Clipboard Toggle word wrap

      failover-on-shutdown

      如果此代理处于活动状态，然后停止，此属性控制备份代理（原始主代理）是否应该活跃并接管。

      allow-failback

      如果发生故障转移并且为主代理接管备份代理，此属性控制备份代理是否应该在重启并重新连接到集群时返回到原始主代理。

      注意

      failback 用于主备份对（一个主代理与单个备份代理配对）。如果主代理配置了多个备份，则不会进行故障恢复。相反，如果发生故障转移事件，备份代理将活跃，下一个备份将变为备份。当原始主代理重新上线时，它将无法启动故障恢复，因为现在活跃的代理已有备份。

      restart-backup

      此属性控制备份代理是否在返回到主代理后自动重启。此属性的默认值为 true。

3. 对集群中的每个剩余的 primary-backup 组重复步骤 2。

流程

1. 为对 中的两个代理打开 <broker_instance_dir> /etc/broker.xml 配置文件。

2. 为对中的两个代理配置相同的复制配置。例如：

   <configuration>
       <core>
           ...
           <ha-policy>
              <replication>
                 <primary>
                   <coordination-id>production-001</coordination-id>
                   <manager>
                      <properties>
                        <property key="connect-string" value="192.168.1.10:6666,192.168.2.10:6667,192.168.3.10:6668"/>
                      </properties>
                   </manager>
                 </primary>
              </replication>
           </ha-policy>
           ...
       </core>
   </configuration>

   Copy to Clipboard Toggle word wrap

   primary

   将复制类型配置为 primary，表示代理可以是主代理，具体取决于代理协调的结果。

   coordination-id

   为两个代理指定一个通用字符串值。具有相同 Coordination-id 字符串的代理将激活协调在一起。在协调过程中，两个代理都使用 Coordination-id 字符串作为节点 Id，并尝试在 ZooKeeper 中获取锁定。获取锁定并具有最新数据的第一个代理将作为活跃代理启动，其他代理会成为被动备份。

   属性

   指定 property 元素，您可以指定一组键值对来提供 ZooKeeper 节点的连接详情：

   Expand

   表 14.2. ZooKeeper 连接详情

   键	值
   connect-string	指定以逗号分隔的 IP 地址和 ZooKeeper 节点的端口号列表。例如，value="192.168.1.10:6666,192.168.2.10:6667,192.168.3.10:6668"。
   session-ms	代理在丢失到大多数 ZooKeeper 节点的连接后等待的持续时间。默认值为 18000 ms。有效值是 ZooKeeper 服务器空循环时间的 2 次和 20 次。 注意 垃圾回收值的 ZooKeeper 暂停时间必须小于 session-ms 属性的值 0.33，以便 ZooKeeper heartbeat 能够可靠地正常工作。如果无法确保暂停时间小于这个限制，请增加每个代理的 session-ms 属性的值，并接受较慢的故障转移。 重要 代理复制合作伙伴每 2 秒自动交换"ping"数据包，以确认合作伙伴代理可用。当备份代理没有从活跃代理接收响应时，备份会等待响应，直到代理的连接生存时间(ttl)过期。默认 connection-ttl 为 60000 ms，这意味着备份代理尝试在 60 秒后尝试故障转移。建议您将 connection-ttl 值设置为与 session-ms 属性值类似的值，以便更快地进行故障转移。要设置新的 connection-ttl，请配置 connection-ttl-override 属性。
   namespace （可选）	如果代理与其他应用程序共享 ZooKeeper 节点，您可以创建一个 ZooKeeper 命名空间来存储为代理提供协调服务的文件。您必须为这两个代理指定相同的命名空间。

   Show more

3. 为代理配置任何其他 HA 属性。

   这些额外的 HA 属性具有适合大多数常见用例的默认值。因此，如果您不希望默认行为，您只需要配置这些属性。更多信息请参阅 附录 F, 其他复制高可用性配置元素。

4. 重复步骤 1 到 3，以配置集群中的每个额外代理对。

流程

1. 将集群中的代理分组到主备份组中。

   在大多数情况下，primary-backup 组应该由两个代理组成：一个主代理和一个备份代理。如果您在集群中有六个代理，则需要三个主备份组。

2. 创建由一个主代理和一个备份代理组成的第一个 primary-backup 组。

   1. 打开主代理的 < broker_instance_dir> /etc/broker.xml 配置文件。

   2. 配置主代理，以将复制用于其 HA 策略。

      <configuration>
          <core>
              ...
              <ha-policy>
                  <replication>
                      <primary>
                          <check-for-active-server>true</check-for-active-server>
                          <group-name>my-group-1</group-name>
                          <vote-on-replication-failure>true</vote-on-replication-failure>
                          ...
                      </primary>
                  </replication>
              </ha-policy>
              ...
          </core>
      </configuration>

      Copy to Clipboard Toggle word wrap

      check-for-active-server

      如果主代理失败，此属性控制客户端重启时是否应该返回它。

      如果将此属性设置为 true，则当主代理在之前的故障转移后重启时，它会搜索具有相同节点 ID 的集群中的另一个代理。如果主代理找到具有相同节点 ID 的另一个代理，这表示在主代理失败后成功启动了备份代理。在这种情况下，主代理将其数据与备份代理同步。然后，主代理请求备份代理关闭。如果为故障恢复配置了备份代理，它会被关闭。然后，主代理会恢复其活跃角色，客户端会重新连接。

      警告

      如果您没有在主代理上将 check-for-active-server 设置为 true，则可能会在之前的故障转移后重启主代理时遇到重复的消息传递处理。具体来说，如果您重启一个主代理，其此属性设置为 false，则主代理不会将数据与其备份代理同步。在这种情况下，主代理可能会处理备份代理已处理的相同消息，从而导致重复。

      group-name

      此 primary-backup 组的名称（可选）。要形成 primary-backup 组，必须使用相同的组名称配置主和备份代理。如果没有指定 group-name，备份代理可以使用任何主代理复制。

      vote-on-replication-failure

      此属性控制主代理是否在中断复制连接时启动一个名为 primary vote 的仲裁投票。

      主要投票是主代理用来确定它还是其合作伙伴是中断复制连接的原因的方法。根据 vote 的结果，主代理可以保持运行或关闭。

      重要

      要使仲裁投票成功，集群的大小必须允许达到大多数结果。因此，在使用复制 HA 策略时，您的集群应该 至少有三个 主备份代理对。

      在集群中配置更多代理对，您可以提高集群的整体容错能力。例如，假设您有三个主备份代理对。如果您丢失了与完整的主备份对的连接，则剩余的两个主备份对不再达到仲裁投票。这意味着，任何后续复制中断都可能会导致主代理关闭，并阻止备份代理启动。通过使用五个代理对配置集群，集群至少可能会出现两个故障，同时仍然保证任何仲裁票的大部分结果。

   3. 为主代理配置任何其他 HA 属性。

      这些额外的 HA 属性具有适合大多数常见用例的默认值。因此，如果您不希望默认行为，您只需要配置这些属性。更多信息请参阅 附录 F, 其他复制高可用性配置元素。

   4. 打开备份代理的 < broker_instance_dir> /etc/broker.xml 配置文件。

   5. 配置备份代理，以将复制用于其 HA 策略。

      <configuration>
          <core>
              ...
              <ha-policy>
                  <replication>
                      <backup>
                          <allow-failback>true</allow-failback>
                          <group-name>my-group-1</group-name>
                          <vote-on-replication-failure>true</vote-on-replication-failure>
                          ...
                      </backup>
                  </replication>
              </ha-policy>
              ...
          </core>
      </configuration>

      Copy to Clipboard Toggle word wrap

      allow-failback

      如果发生故障转移并且为主代理接管备份代理，此属性控制备份代理是否应该在重启并重新连接到集群时返回到原始主代理。

      注意

      failback 用于主备份对（一个主代理与单个备份代理配对）。如果主代理配置了多个备份，则不会进行故障恢复。相反，如果发生故障转移事件，备份代理将活跃，下一个备份将变为备份。当主代理恢复在线时，将无法启动故障恢复，因为现在活跃的代理已有备份。

      group-name

      此 primary-backup 组的名称（可选）。要形成 primary-backup 组，必须使用相同的组名称配置主和备份代理。如果没有指定 group-name，备份代理可以使用任何主代理复制。

      vote-on-replication-failure

      此属性控制已激活的备份代理是否可以在中断复制连接时启动称为 主票的仲裁投票。

      主要投票是主代理用来确定它还是其合作伙伴是中断复制连接的原因的方法。根据 vote 的结果，主代理可以保持运行或关闭。

   6. （可选）配置备份代理启动的仲裁票的属性。

      <configuration>
          <core>
              ...
              <ha-policy>
                  <replication>
                      <backup>
                      ...
                          <vote-retries>12</vote-retries>
                          <vote-retry-wait>5000</vote-retry-wait>
                      ...
                      </backup>
                  </replication>
              </ha-policy>
              ...
          </core>
      </configuration>

      Copy to Clipboard Toggle word wrap

      vote-retries

      此属性控制备份代理重试仲裁投票的次数，以便接收允许备份代理启动最多的结果。

      vote-retry-wait

      此属性控制每次重试仲裁票之间等待的备份代理的时间（以毫秒为单位）。

   7. 为备份代理配置任何其他 HA 属性。

      这些额外的 HA 属性具有适合大多数常见用例的默认值。因此，如果您不希望默认行为，您只需要配置这些属性。更多信息请参阅 附录 F, 其他复制高可用性配置元素。

3. 对集群中的每个额外的 primary-backup 组重复步骤 2。

   如果集群中有六个代理，请多次重复这个过程 ; 为每个剩余的 primary-backup 组重复一次。