准备您的环境

Broadworks XSP 可以直接在互联网上进行部署，也可以驻留在位于负载平衡元素（如 F5 BIG-IP）之后的 DMZ 中。 为了提供地理冗余，可以在两个（或两个以上）数据中心中部署 XSP，每个 XSP 都可以位于负载平衡器之后并且都有一个公共 IP 地址。 如果 XSP 位于负载平衡器之后，Webex 微服务和应用程序只能看到负载平衡器的 IP 地址，而 Broadworks 显示为只有一个 XSP，即使其后存在多个 XSP 也是如此。

在下面的示例中，XSP 部署在两个站点（即，站点 A 和站点 B）上。每个站点的负载平衡器之后有两个 XSP。 站点 A 的 LB1 之后是 XSP1 和 XSP2，而站点 B 的 LB2 之后是 XSP3 和 XSP4。 公共网络上仅显示负载平衡器，而 XSP 位于 DMZ 专用网络中。

DNS 配置

Webex 云微服务必须能够找到用于连接到 Xsi 接口、身份验证服务以及 CTI 的 BroadWorks XSP 服务器。

Webex 云微服务将对已配置的 XSP 主机名执行 DNS A/AAAA 查找，并连接到返回的 IP 地址。 此云可以是一个负载平衡边缘元素，也可以是 XSP 服务器本身。 如果返回多个 IP 地址，将选中列表中的第一个 IP。 当前不支持 SRV 查找。

例如： 合作伙伴的DNS A记录，用于发现面向互联网的轮询平衡的XSP服务器/负载平衡器。

故障转移

如果 Webex 微服务向 XSP/负载平衡器发送请求，但该请求失败，可能会发生以下情况：

• 如果故障是由于网络错误（例如： TCP 和 SSL）造成的，Webex 微服务会将 IP 标记为“已阻止”，并立即路由至下一个 IP。

• 如果返回错误代码(HTTP 5xx)，Webex微服务会将IP标记为已阻止，并立即路由到下一个IP。

• 如果在 2 秒钟内未收到 HTTP 响应，请求将超时，Webex 微服务会将 IP 标记为“已阻止”，并路由至下一个 IP。

每个请求会先尝试 3 次，之后再向微服务报告故障。

如果某个 IP 位于已阻止列表中，那么该 IP 不会加入到向 XSP 发送请求时尝试使用的地址列表中。 经过预定的时间段后，被阻止的 IP 将失效，并重新加入到发出其他请求时尝试使用的列表中。

如果所有 IP 地址均被阻止，微服务仍会在已阻止列表中随机选择某个 IP 地址，从而尝试发送请求。 如果操作成功，相应的 IP 地址将从已阻止列表中删除。

状态

可以在 Control Hub 中查看 Webex 云服务与 XSP 或负载平衡器的连接状态。 在 BroadWorks 呼叫集群下，显示了以下各个接口的连接状态：

• XSI 操作

• XSI 活动

• 验证服务

加载页面时或者在输入更新期间，连接状态会更新。 连接状态如下：

• 绿色： 可以使用 A 记录查找中的某个 IP 访问接口时。

• 红色： A 记录查找中的所有 IP 都无法供访问，并且接口不可用时。

以下服务使用微服务连接到 XSP，并受 XSP 接口可用性影响：

• 登录 Webex 应用程序

• 刷新 Webex 应用程序令牌

• 不受信任的电子邮件/自助激活

• Broadworks 服务运行状况检查

DNS 配置

Webex 应用程序在 XSP 上访问扩展服务接口（XSI-Actions 和 XSI-Events）以及设备管理服务 (DMS)。

要查找XSI服务，Webex应用程序为以下对象执行DNS SRV查找 _xsi-client._tcp.<webex app xsi domain> 。 SRV指向为XSI服务的XSP主机或负载平衡器配置的URL。 如果SRV查找不可用，Webex应用程序将恢复为A/AAAA查找。

SRV可以解析到多个A/AAAA目标。 但是，每个A/AAAA记录只能映射到一个IP地址。 如果 DMZ 中有多个 XSP 位于负载平衡器/边缘设备之后，那么需要将负载均衡器配置为保持会话持续性，以便将同一会话的所有请求路由到同一 XSP。 我们强制使用此配置，因为客户端的 XSI 事件检测信号必须转到用于建立事件通道的相应 XSP。

在示例1中，webex-app-xsp.example.com的A/AAAA记录不存在，也不需要。 如果您的DNS要求必须定义一个A/AAAA记录，则只应返回一个IP地址。 无论如何，仍必须为Webex应用程序定义SRV。 如果Webex应用程序使用解析为多个IP地址的A/AAAA名称，或者负载平衡器/边缘元素不保持会话持续性，客户端最终会向未建立事件通道的XSP发送信号。 这样会导致通道被破坏，还会有多得多的内部流量影响您的 XSP 集群性能。 由于Webex云和Webex应用程序在A/AAAA记录查找中有不同的要求，您必须为Webex云和Webex应用程序使用单独的FQDN来访问您的XSP。 如示例中所示，Webex云使用记录 webex-cloud-xsp.example.com ，Webex应用程序使用SRV _xsi-client._tcp.webex-app-xsp.example.com 。

示例1—多个XSP，每个位于独立的负载平衡器

在本例中，SRV指向多倍于A记录，每个A记录指向不同站点的不同负载平衡器。 Webex应用程序将始终使用列表中的第一个IP地址，仅在第一条记录关闭时移至下一条记录。

示例2—一个负载平衡器后面有多个XSP（具有TLS桥）

对于初始请求，负载平衡器选择一个随机XSP。 该XSP返回Webex应用程序在未来的请求中包含的cookie。 对于未来的请求，负载平衡器使用cookie将连接路由到正确的XSP，确保事件通道不会断开。

DMS URL

在登录过程中，Webex 应用程序还将检索 DMS URL，以便下载其配置文件。 系统将对 URL 中的主机进行解析，Webex 应用程序将对主机执行 DNS A/AAAA 查找，以便连接到托管 DMS 服务的 XSP。

例如： DNS A 记录，用于供 Webex 应用程序发现面向互联网的轮询均衡式 XSP 服务器/负载平衡器，从而通过 DMS 下载配置文件：

Webex 应用程序如何查找 XSP 地址

客户端尝试使用以下 DNS 流程找到 XSP 节点：

1. 客户端最初从 Webex 云中检索 Xsi 操作/Xsi 事件 URL（您在创建关联的 BroadWorks Calling 集群时输入了这些 URL）。 从 URL 解析 XSI 主机名/域，客户端执行 SRV 查找，如下所示：

   1. 客户端执行 SRV 查找，以找到 _xsi-client._tcp。<xsi domain="">

   2. 如果SRV查找返回一个或多个A/AAAA目标：

      1. 客户针对这些目标执行 A/AAAA 查找，并缓存返回的 IP 地址。

      2. 客户根据 SRV 优先级，然后是权重（或者它们等同，则随机选择），连接到其中一个目标（因此使用一个 IP 地址连接到它的 A/AAAA 记录）。

   3. 如果 SRV 查找未返回任何目标：

      客户端首先对 XSI 根参数执行 A/AAAA 查找，然后尝试连接到返回的 IP 地址。 此云可以是一个负载平衡边缘元素，也可以是 XSP 服务器本身。

      如上所述，出于同样的原因，A/AAAA 记录必须解析为一个 IP 地址。

2. （可选）随后，您可以使用以下标记，在 Webex 应用程序的设备配置中提供自定义的 XSI 操作/XSI 事件详细信息：

   <protocols>
   	<xsi>
   		<paths>
   			<root>%XSI_ROOT_WXT%</root>
   			<actions>%XSI_ACTIONS_PATH_WXT%</actions>
   			<events>%XSI_EVENTS_PATH_WXT%</events>
   		</paths>
   	</xsi>
   </protocols>

   1. 这些配置参数优先于 Control Hub 中的 BroadWorks 集群中的任何配置。

   2. 如果它们存在，客户端会将它们与通过“BroadWorks 集群”配置收到的原始 XSI 地址进行比较。

   3. 如果检测到任何差异，客户端将重新初始化它的 XSI 操作/XSI 事件连接。 此操作的第一步是执行步骤1中列出的相同DNS查找过程-这一次请求从其配置文件中查找%XSI_ROOT_WXT% 参数中的值。

      如果您使用此标记更改 XSI 接口，请确保创建相应的 SRV 记录。

故障转移

登录期间，Webex App 会对 _xsi-client._tcp.<xsi domain=""> 执行 DNS SRV 查找，构建主机列表，然后依次根据 SRV 优先级和权重连接到其中某个主机。 连接的主机将成为所有后续请求的选定主机。 随后，事件通道向选定主机开放，并且定期发送检测信号对通道进行验证。 在第一个请求之后发送的所有请求均包含 HTTP 响应中返回的 cookie，因此，负载平衡器应该保持会话持续性（亲缘关系）并始终向同一后端 XSP 服务器发送请求，这一点非常重要。

如果向主机发送请求或检测信号请求失败，可能会发生以下情况：

• 如果故障是由于网络错误（例如： TCP、SSL），Webex App 会立即路由到列表中的下一个主机。

• 如果返回错误代码(HTTP5xx)，Webex应用程序会将该IP地址标记为已阻止并路由到列表中的下一个主机。

• 如果在一段时间内未收到响应，那么系统会将该请求视为因超时而失败，并将后续请求发送给下一个主机。 但是，超时请求会被视为失败。 某些请求会在失败后进行重试（增加重试时间）。 不会重试被假定为“不重要”的请求。

尝试新主机成功之后，如果该主机显示在列表中，则将其视为新选中的主机。 在尝试列表中的最后一个主机之后，Webex 应用程序将滚动至第一个主机。

在有检测信号的情况下，如果两个请求连续失败，Webex 应用程序将重新初始化事件通道。

请注意，Webex 应用程序不会执行故障转移，并且只有在登录时才会执行一次 DNS 服务发现。

在登录期间，Webex 应用程序尝试通过 XSP/Dms 接口下载配置文件。 该应用程序会在已检索的 DMS URL 中对主机执行 A/AAAA 记录查找，然后连接到第一个 IP。 应用程序首先尝试发送一个使用 SSO 令牌下载配置文件的请求。 如果该请求因任何原因失败，它将进行重试，但这次请求使用设备用户名和密码下载。