在启用了负载均衡的CMS集群部署中将参与者添加到现有会议或空间

简介

本文档介绍如何在启用负载均衡的群集CMS部署中将参与者添加到现有CMS会议。

先决条件

要求

Cisco 建议您了解以下主题：

• CMS负载均衡（思科会议服务器）
• CUCM临时会议(Cisco Unified Communications Manager)

本文档假设已为您的群集Callbridge(CB)配置负载均衡，并正在处理直接呼叫这些CMS服务器（直接呼叫现有CMS空间）。这意味着已配置以下要求：

• 所有用于临时会议的CMS服务器都将添加到CUCM > Media Resources > Conference Bridge并注册
• 将创建包含媒体资源组(MRG)的媒体资源组列表(MRGL)，它仅具有CMS服务器，是MRGL中的第一个组
• 创建包含路由组的路由列表，其中包含CMS服务器，并且所选的分发算法为循环

使用的组件

本文档中的信息基于以下软件和硬件版本：

• CMS 2.9.1
• CUCM 12.5.1

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

向现有CMS会议添加参与者的方法

注意：向现有CMS会议添加参与者有三种主要方法：通过API添加参与者，通过Active Control添加参与者，以及添加不带Active Control的参与者。

1.通过API添加参与者

若要使用此方法，必须启用Callbridge组上的LoadbalanceOutgoingCalls。

要使用此方法添加参与者，必须向/calls/<active-call-id>/participants/发出API POST请求。POST请求需要包括参与者的participantID，该参与者作为remoteParty参数（此POST请求的一部分）的值添加到会议中。

此POST请求指示CMS向正在添加的参与者发出呼出呼叫。如果Callbridge Group上启用了LoadbalanceOutgoingCalls，并且如果CMS已达到其负载限制，则它会在集群中查找一个免费的CMS服务器，以向正在添加的参与者发出呼叫，并且会在两台服务器之间创建一个分布式呼叫。这是CMM用于向CMS会议添加参与者的相同方法。

2.通过主动控制添加参与者

要使用活动控制参与者添加，必须首先在CMS服务器和添加参与者的用户之间协商活动控制。

您需要对连接CUCM和CMS的SIP中继上配置的SIP中继配置文件启用活动控制，为此，请启用参数Allow IX application media，并注意Standard SIP Profile For TelePresence Conferencing已默认启用该配置文件。此外，Callbridge组上的LoadbalanceOutgoingCalls必须启用。

当参与者通过Active Control添加到现有CMS会议时，用户会指示CMS1（通过活动控制消息）向新参与者发出呼出呼叫。如果达到CMS1上配置的负载限制值，并且用户尝试添加具有主动控制的新参与者，则CMS1会显示以下错误消息（最高为CMS版本2.9.1）：

add participant "<participant-uri>" request failed: call bridge unavailable

这适用于两种使用案例 — 参与者被添加到临时会议中，以及参与者通过主动控制被添加到现有CMS空间中。 

这是一个缺陷行为，正在缺陷下跟踪：CSCvu72374

3.添加没有活动控制的参与者

当添加参与者而不使用主动控制(因此在SIP配置文件上未启用Allow IX application media)时，CUCM在发起操作的用户和新参与者之间发出呼叫。然后，当用户准备加入新参与者加入会议时，CUCM会向CMS1上运行的临时会议发出呼出呼叫。如果CMS1达到负载限制，则无法添加参与者，并且CMS1会显示以下错误消息（55是示例呼叫号码）：

call 55: ending; local teardown, system participant limit reached - not connected after 0:00

此错误消息是CMS服务器在收到传入呼叫时以及达到最大负载限制后要打印的一般错误消息。然后由呼叫控制服务器（CUCM或VCS）继续将呼叫路由到集群中的其他成员。但是，对于临时会议，这不起作用，并且这是不可能的，因为CUCM没有用于临时会议的路由列表。

配置

本文档提供了使用第3种方式将参与者添加到现有会议中所需的配置步骤(添加参与者而不使用主动控制)。

本文档中的配置步骤涉及的行为是：

1.用户创建临时会议，由CMS1服务器托管

2.建立临时会议后，CMS1逐渐达到其配置的负载限制(通过API at/system/configuration/cluster配置)

3.用户尝试向正在进行的临时会议添加新的参与者，但新用户未连接到会议

注：此配置过程允许用户向现有CMS临时会议添加参与者，即使托管该临时会议的CMS服务器已达到其负载限制，并且它可以在修复活动控制缺陷之前使用。活动控制在该临时会议中变为禁用状态。 

步骤1.为Trunk1创建新的SIP中继安全配置文件

• 导航到System > Security > SIP 干线安全性配置文件
  
• 选择新增
• 将5040上的Name设置为Trunk1非安全接收
• 将设备安全模式设置为非安全
• 将Incoming Port设置为5040
• 选择保存

Trunk1 SIP安全配置文件

步骤2.为Trunk2创建新的SIP中继安全配置文件

• 导航到系统>安全> SIP 干线安全性配置文件
  
• 选择新增
• 将5041上的Name设置为Trunk2非安全接收
• 将设备安全模式设置为非安全
• 将Incoming Port设置为5041
• 选择保存

Trunk2 SIP安全配置文件

步骤3.创建新的SIP规范化脚本 

• 导航至设备> 设备设置> SIP规范化脚本
  
• 选择新增
• 将Name设置为remove_conference_from_call_info_header
• 在内容中，使用此脚本

M = {}
function M.outbound_INVITE(msg)
    msg:removeHeaderValue("Call-Info", "<urn:x-cisco-remotecc:conference>")
end
return M

• 选择保存

步骤4.创建新的SIP配置文件

• 导航到Device > Device settings > SIP 配置文件
  
• 选择用于网真会议的标准SIP配置文件,复制
  
• 将名称设置为无活动控制网真会议
• 取消选中页面底部的允许iX应用媒体复选框
• 选择保存

步骤5.创建新分区

• 导航到呼叫路由>控制类别> 分区
  
• 选择新增
• 将Name设置为cms_adhoc_numbers
• 选择保存

步骤6.创建新的呼叫搜索空间(CSS):

• 导航至 呼叫路由>控制类别>呼叫搜索空间
  
• 选择新增
• 将Name设置为CMS_adhoc_numbers
• 添加第5步中创建的分区cms_adhoc_numbers
• 选择保存

呼叫搜索空间配置

步骤7.创建新的SIP中继,Trunk1:

• 导航至设备 >中继
• 选择新增
• 在中继类型中，选择 SIP 中继
• 选择下一步
• 输入这些值并保存

设备名	输入SIP中继的名称Trunk1
在所有活动的Unified CM节点上运行	已选中
目标地址	输入CUCM服务器自身的IP，例如10.48.36.50
目标端口	输入Trunk2侦听的端口5041
SIP 干线安全性配置文件	选择在步骤1中创建的配置文件，5040上的Trunk1非安全接收
SIP 配置文件	选择在步骤4无活动控制网真会议中创建的配置文件
DTMF信令方法	选择RFC 2833
SIP规范化脚本	选择在步骤3中创建的脚本remove_conference_from_call_info_header

Trunk1 SIP设置

步骤8.创建新的SIP中继,Trunk2:

• 导航至设备 >中继
• 选择新增
• 在中继类型中，选择 SIP 中继
• 选择下一步
• 输入这些值并保存

设备名	输入SIP中继的名称Trunk2
在所有活动的Unified CM节点上运行	已选中
呼叫搜索空间	选择在步骤6中创建的CSSCMS_adhoc_numbers
目标地址	输入CUCM服务器本身的IP地址或FQDN，例如10.48.36.50
目标端口	输入Trunk1侦听的端口5040
SIP 干线安全性配置文件	选择在步骤2中创建的配置文件，5041上的Trunk2非安全接收
SIP 配置文件	选择在步骤4无活动控制网真会议中创建的配置文件
DTMF信令方法	选择RFC 2833
SIP规范化脚本	选择现有规范化脚本cisco-meeting-server-interop

Trunk2 SIP设置

步骤9.创建新的路由模式

• 导航到呼叫路由 > 路由/寻线> 路由模式
  
• 选择新增
• 设置 路由模式 到!
  
• 将Route Partition设置为在第5步中创建的分区cms_adhoc_numbers
• 启用复选框 紧急优先级
• 将呼叫分类更改为OnNet
• 将Gateway/Route List设置为已配置的CMS路由列表（如前面的Requirements部分所述）
• 选择保存

路由模式

CMS负载均衡路由列表

CMS负载均衡路由组

步骤10.修改CMS临时会议网桥配置

• 导航到介质资源> 会议桥
  
• 选择第一个CMS服务器
• 更改 SIP 干线 到Trunk1，在第7步中创建的SIP中继
• 启用复选框 将SIP中继目标覆盖为HTTPS地址
  
• 在Hostname/IP Address字段中，为该特定CMS服务器设置CMS Webadmin FQDN，该服务器的Webadmin证书中必须也存在该服务器
• 选择保存
• 对所有其他CMS服务器执行相同的操作，将Trunk1设置为在所有服务器上使用，但将Hostname/IP Address字段更改为特定CMS FQDN

CMS1

CMS2

CMS3

步骤11.重置SIP中继Trunk1和Trunk2

• 导航至设备 >中继
• 选择Trunk1和Trunk2
• 选择Reset selected
• 等到两者都显示完整服务

步骤12.重置CMS对等服务器

• 导航至介质资源 > 会议网桥
• 选择所有CMS服务器
• 选择Reset selected
• 等到所有服务器都显示Registered

验证

使用本部分可确认配置能否正常运行。

• 创建临时会议并检查主持会议的CMS服务器

托管临时会议的CMS1

• 检查该CMS服务器上的当前媒体处理负载，使用API GET to/system/load

当前介质负载

• 通过向POST向/system/configuration/cluster发送参数loadlimit来将服务器的负载限制设置为低于媒体处理负载的值，例如1000

更改负载限制

• 将新参与者添加到会议。由于CMS1已达到其限制，因此会添加该参与者，并在CMS1和另一个CMS服务器之间创建一个分发服务器

分布式呼叫

故障排除

目前没有针对此配置的故障排除信息。

可以使用Collaboration Solutions Analyzer工具进行日志分析。

相关信息

• 思科会议服务器上的负载平衡逻辑
• CMS配置文档
• CMS API和MMP编程指南
• CUCM配置文档