Agregar participantes a una conferencia o espacio existente en la implementación del clúster de CMS con el equilibrio de carga habilitado

Introducción

Este documento describe cómo agregar participantes a una conferencia CMS existente en la implementación de CMS agrupado con el Balanceo de Carga habilitado.

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Equilibrio de carga de CMS (Cisco Meeting Server)
• Conferencias ad-hoc de CUCM (Cisco Unified Communications Manager)

Este documento asume que el Balanceo de Carga ya está configurado para sus Callbridges (CB) agrupados y funciona para llamadas directas a estos servidores CMS (llamando directamente a un espacio CMS existente). Esto significa que estos requisitos ya están configurados:

• Todos los servidores CMS que se van a utilizar para conferencias ad hoc se agregan a CUCM > Recursos multimedia > Puente de conferencia y se registran
• Se crea una Media Resource Group List (MRGL) que contiene un Media Resource Group (MRG), que solo tiene los servidores CMS y es el primer grupo de la MRGL
• Se crea una Lista de rutas que contiene un grupo de rutas, y tiene los servidores CMS, y el algoritmo de distribución seleccionado es Circular

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• CMS 2.9.1
• CUCM 12.5.1

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Métodos para agregar participantes a una conferencia CMS existente

Nota: Existen tres métodos principales para agregar un participante a una conferencia CMS existente: agregar un participante mediante API, agregar un participante mediante Control activo y agregar un participante sin Control activo.

1. Añadir un participante mediante API

Para utilizar este método, se debe habilitar LoadbalanceOutgoingCalls en el grupo Callbridge.

Para agregar al participante mediante este método, se debe realizar una solicitud API POST a /calls/<active-call-id>/participate/. La solicitud POST debe incluir la ID de participante del participante que se va a agregar a la conferencia como valor del parámetro remoteParty, que forma parte de esta solicitud POST.

Esta solicitud POST indica al CMS que realice una llamada saliente al participante que se va a agregar. Si se habilita LoadbalanceOutgoingCalls en el grupo Callbridge, y si CMS ha alcanzado su límite de carga, encuentra un servidor CMS libre en el clúster para realizar una llamada saliente al participante que se está agregando, y se crea una llamada distribuida entre los dos servidores. Este es el mismo método que utiliza CMM para agregar participantes a una conferencia CMS.

2. Agregar un participante mediante Control activo

Para utilizar la opción de agregar participante de control activo, primero debe negociarse el control activo entre el servidor CMS y el usuario que está agregando el participante.

Debe habilitar el control activo en el perfil de troncal SIP configurado en el troncal SIP que conecta CUCM con CMS, para hacerlo, habilite el parámetro Allow IX application media, y observe que el perfil SIP estándar para conferencias de TelePresence lo habilita de forma predeterminada. Además, se debe habilitar LoadbalanceOutgoingCalls en el grupo Callbridge.

Cuando se agrega un participante mediante Control activo a una conferencia CMS existente, el usuario (mediante un mensaje de control activo) le indica a CMS1 que realice una llamada saliente al nuevo participante. Si se alcanza el valor de límite de carga configurado en CMS1 y el usuario intenta agregar un nuevo participante con control activo, CMS1 muestra este mensaje de error (hasta la versión 2.9.1 de CMS):

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

Esto se aplica a ambos casos prácticos: cuando el participante se agrega a una conferencia ad hoc y cuando se agrega a un espacio CMS existente a través del control activo. 

Este es un comportamiento defectuoso y se está rastreando bajo el defecto: CSCvu72374

3. Añadir un participante sin control activo

Cuando se agrega un participante sin utilizar el control activo (por lo tanto, Allow IX application media not enabled on the SIP Profile), CUCM realiza una llamada entre el usuario que inicia la acción y el nuevo participante. A continuación, cuando el usuario está listo para unirse al nuevo participante en la conferencia, CUCM realiza una llamada saliente a la conferencia ad hoc que se ejecuta en CMS1. Si se alcanza el límite de carga en CMS1, el participante no se puede agregar y CMS1 muestra este mensaje de error (55 es un número de llamada de ejemplo):

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

Este mensaje de error es un mensaje de error normal que debe imprimir un servidor CMS cuando recibe una llamada entrante y después de alcanzar su límite de carga máximo. A continuación, corresponde al servidor de control de llamadas (CUCM o VCS) continuar enrutando la llamada a otros miembros del clúster. Sin embargo, en el caso de una conferencia ad hoc, esto no funciona y no es posible ya que CUCM no tiene una Lista de rutas para las conferencias ad hoc.

Configurar

Este documento proporciona los pasos de configuración necesarios para utilizar la tercera forma de agregar un participante a una conferencia existente (Agregar un participante sin control activo).

El comportamiento tratado con los pasos de configuración en este documento es:

1. El usuario crea una conferencia ad hoc, el servidor CMS1 la aloja

2. Una vez establecida la conferencia ad hoc, CMS1 alcanza gradualmente su límite de carga configurado (configurado sobre API en /system/configuration/cluster)

3. El usuario intenta agregar un nuevo participante a la conferencia ad hoc en curso, pero el nuevo usuario no se conecta a la conferencia

Nota: Este procedimiento de configuración permite que un usuario agregue participantes a una conferencia ad hoc de CMS existente incluso si el servidor CMS que aloja la conferencia ad hoc ha alcanzado su límite de carga, y se puede utilizar hasta que se corrija el defecto de control activo. El control activo se desactiva en esa conferencia ad-hoc. 

Paso 1. Crear un nuevo perfil de seguridad de enlace troncal SIP para el enlace troncal 1

• Vaya a Sistema > Seguridad > Perfil de seguridad del enlace troncal SIP
  
• Seleccione Add New (Agregar nuevo).
• Establezca el Nombre como Recepción no segura Trunk1 en 5040
• Establezca el Modo de seguridad del dispositivo en No seguro
• Establezca el puerto entrante en 5040
• Seleccione Save (Guardar).

Perfil de seguridad SIP Trunk1

Paso 2. Crear un nuevo perfil de seguridad de línea troncal SIP para línea troncal 2

• Vaya a Sistema > Seguridad > Perfil de seguridad del enlace troncal SIP
  
• Seleccione Add New (Agregar nuevo).
• Establezca el Nombre como Recepción no segura Trunk2 en 5041
• Establezca el Modo de seguridad del dispositivo en No seguro
• Establezca el puerto entrante en 5041
• Seleccione Save (Guardar).

Perfil de seguridad SIP Trunk2

Paso 3. Crear un nuevo script de normalización SIP 

• Vaya a Device > Device settings > Scripts de normalización SIP
  
• Seleccione Add New (Agregar nuevo).
• Establezca el Nombre como remove_conference_from_call_info_header.
• En el campo Contenido, utilice este guión

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

• Seleccione Save (Guardar).

Paso 4. Crear un nuevo perfil SIP

• Vaya a Device > Device settings > Perfil SIP
  
• Seleccione el perfil SIP estándar para conferencias de TelePresence y cópielo
  
• Establezca el Nombre como Sin control activo para conferencias de telepresencia
• Desmarque la casilla de verificación Allow iX Application Media en la parte inferior de la página
• Seleccione Save (Guardar).

Paso 5. Crear una nueva partición

• Vaya a Call routing > Class of Control > Partición
  
• Seleccione Add New (Agregar nuevo).
• Establezca el Nombre en cms_adhoc_numbers
• Seleccione Save (Guardar).

Paso 6. Crear un nuevo espacio de búsqueda de llamadas (CSS):

• Desplácese hasta Enrutamiento de llamadas > Clase de control > Espacio de búsqueda de llamadas
  
• Seleccione Add New (Agregar nuevo).
• Establezca el Nombre en CMS_adhoc_numbers
• Agregue la partición creada en el paso 5 cms_adhoc_numbers
• Seleccione Save (Guardar).

Configuración del espacio de búsqueda de llamadas

Paso 7. Cree un nuevo troncal SIP, Trunk1:

• Vaya a Device >Trunk (Dispositivo > Enlace troncal)
• Seleccione Add New (Agregar nuevo).
• Seleccione SIP Trunk (Enlace troncal SIP) en Trunk Type (Tipo de enlace troncal).
• Seleccione Next (Siguiente).
• Introduzca estos valores y haga clic en Guardar

Nombre del dispositivo	Introduzca un nombre para el enlace troncal SIP, Trunk1
Ejecutar en todos los nodos activos de Unified CM	Activado
Dirección de destino	Introduzca la dirección IP del propio servidor de CUCM; por ejemplo, 10.48.36.50
Puerto de Destino	Ingrese el puerto en el que escucha Trunk2, 5041
Perfil de seguridad del enlace troncal SIP	Seleccione el perfil creado en el paso 1, recepción no segura troncal 1 en 5040
Perfil SIP	Seleccione el perfil creado en el paso 4, Sin control activo de conferencias de telepresencia
Método de señalización DTMF	Seleccione RFC 2833
Guión de normalización SIP	Seleccione el script creado en el paso 3, remove_conference_from_call_info_header.

Configuración SIP del troncal 1

Paso 8. Crear un nuevo troncal SIP, Trunk2:

• Vaya a Device >Trunk (Dispositivo > Enlace troncal)
• Seleccione Add New (Agregar nuevo).
• Seleccione SIP Trunk (Enlace troncal SIP) en Trunk Type (Tipo de enlace troncal).
• Seleccione Next (Siguiente).
• Introduzca estos valores y haga clic en Guardar

Nombre del dispositivo	Introduzca un nombre para el enlace troncal SIP, Trunk2
Ejecutar en todos los nodos activos de Unified CM	Activado
Calling Search Space	Seleccione el CSS creado en el paso 6, CMS_adhoc_numbers
Dirección de destino	Introduzca la dirección IP o FQDN del propio servidor de CUCM; por ejemplo, 10.48.36.50
Puerto de Destino	Ingrese el puerto en el que escucha el Trunk1, 5040
Perfil de seguridad del enlace troncal SIP	Seleccione el perfil creado en el paso 2, recepción no segura troncal 2 en 5041
Perfil SIP	Seleccione el perfil creado en el paso 4, Sin control activo de conferencias de telepresencia
Método de señalización DTMF	Seleccione RFC 2833
Guión de normalización SIP	Seleccione el script de normalización existente cisco-meeting-server-interop

Configuración SIP de troncal 2

Paso 9. Crear un nuevo patrón de ruta

• Vaya a Call routing > Route/Hunt > Patrón de ruta
  
• Seleccione Add New (Agregar nuevo).
• Establezca el Patrón de ruta a!
  
• Establezca la Partición de ruta en la partición creada en el Paso 5, cms_adhoc_numbers
• Active la casilla de verificación Prioridad urgente
• Cambiar clasificación de llamada a OnNet
• Configure la Gateway/Route List para que sea la CMS Route List que ya está configurada (como se mencionó en la sección Requisitos anteriormente)
• Seleccione Save (Guardar).

Patrón de ruta

lista de rutas de balanceo de carga CMS

grupo de ruta de balanceo de carga CMS

Paso 10. Modifique la configuración del puente de conferencia ad hoc de CMS

• Vaya a Recursos multimedia > Puente de conferencia
  
• Seleccione el primer servidor CMS
• Cambie el Enlace troncal SIP en Trunk1, el troncal SIP creado en el paso 7
• Active la casilla de verificación Invalidar el destino del troncal SIP como dirección HTTPS
  
• En el campo Nombre de host/Dirección IP, establezca el FQDN de CMS Webadmin para ese servidor CMS específico que también debe existir en el certificado Webadmin de ese servidor
• Seleccione Save (Guardar).
• Haga lo mismo para todos los demás servidores CMS, configure Trunk1 para que se use en todos ellos, sin embargo cambie el campo Hostname/IP Address por el FQDN de CMS específico

CMS1

CMS2

CMS3

Paso 11. Restablecer troncales SIP Trunk1 y Trunk2

• Vaya a Device >Trunk (Dispositivo > Enlace troncal)
• Seleccione Trunk1 y Trunk2
• Seleccione Restablecer seleccionado
• Espere hasta que ambos muestren el servicio completo

Paso 12. Restablecer servidores CMS ad hoc

• Vaya a Media Resources > Conference Bridge (Recursos de medios > Dispositivo de conferencia).
• Seleccionar todos los servidores CMS
• Seleccione Restablecer seleccionado
• Espere a que todos los servidores muestren Registered

Verificación

Utilize esta sección para confirmar que su configuración funcione correctamente.

• Cree una conferencia ad-hoc y compruebe qué servidor CMS aloja la conferencia

CMS1 que aloja la conferencia ad hoc

• Verifique la carga de procesamiento de medios actual en ese servidor CMS, utilice un API GET para /system/load

Carga de medios actual

• Establezca el límite de carga en el servidor en un valor inferior a la carga de procesamiento de medios enviando un POST a /system/configuration/cluster con el parámetro loadlimit, por ejemplo, 1000

Cambio del límite de carga

• Agregue un nuevo participante a la reunión. El participante se agrega y se crea un CMS1 distribuido entre CMS1 y otro servidor CMS, ya que CMS1 ha alcanzado su límite

Llamada distribuida

Troubleshoot

Actualmente, no hay información específica de troubleshooting disponible para esta configuración.

Puede utilizar la herramienta Analizador de soluciones de colaboración para el análisis de registros.

Información Relacionada

• Lógica de equilibrio de carga en Cisco Meeting Server
• documentación de configuración de CMS
• Guías de programación CMS API y MMP
• documentación de configuración de CUCM