Administración de CUBE y de gateways analógicos

Para qué sirve

En Gateways, EasyUC gestiona dispositivos Cisco IOS mediante SSH. Analog GWs muestra los gateways VG del CUCM con su estado de registro y el número de llamadas activas. CUBEs muestra los Cisco Unified Border Elements que usted mismo introduce en EasyUC. EasyUC inicia sesión en el dispositivo mediante SSH, lee su estado con comandos show y ejecuta comandos de configuración a petición.

En los gateways analógicos ve los puertos de voz con su señalización y estado, lee la configuración de un puerto, incluidos los dial peers asociados, y aplica config sets guardados. En ambos tipos de dispositivo lee las interfaces de red, la versión del sistema, los certificados y las llamadas activas, y puede finalizar una llamada.

Para los CUBE existe además la Debug capture. EasyUC activa «debug ccsip messages» y «debug voip dialpeer inout» en el CUBE, recibe la salida mediante syslog y la guarda para el diagnóstico de llamadas. Un watchdog supervisa el CUBE y se desactiva por sí solo en caso de sobrecarga.

El Cisco CUBE es un dispositivo independiente de la red. No es el SBC de Teams integrado en EasyUC.

Requisitos previos

• Módulo de licencia cucm. El menú Gateways aparece con ROLE_APP_GATEWAYS y al menos un permiso de sección.
• Ver gateways analógicos: ROLE_APP_GATEWAYS_ANALOG. Modificar, probar, conmutar puertos, aplicar configuración: además ROLE_APP_GATEWAYS_ANALOG_EDIT.
• Ver CUBE: ROLE_APP_GATEWAYS_CUBE. Modificar, probar, finalizar una llamada, conmutar la captura de depuración: además ROLE_APP_GATEWAYS_CUBE_EDIT.
• Los administradores (ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN, ROLE_SUPER_ADMIN) tienen todos los permisos de gateway. ROLE_APP_TEMPLATE por sí solo no basta.
• Cambiar las credenciales por defecto, crear un CUBE y establecer el host o el puerto SSH de un gateway: permisos de edición para ambas áreas (ROLE_APP_GATEWAYS_ANALOG_EDIT y ROLE_APP_GATEWAYS_CUBE_EDIT).
• El gateway es accesible desde el appliance de EasyUC mediante SSH. El puerto SSH es el 22 por defecto.
• Un usuario SSH en el gateway con los permisos para la acción deseada. Si el dispositivo requiere una enable password, debe estar guardada.
• Los gateways analógicos se crean en el CUCM. EasyUC lee la lista de la conexión CUCM activa.
• Para la captura de depuración: el CUBE llega al appliance de EasyUC mediante syslog (UDP). El destino de syslog se introduce en Storage & syslog o en el CUBE.
• Las credenciales SSH para Details (SSH) de los nodos CUCM en la página de inicio son un ajuste independiente, con los roles ROLE_APP_CUCM_NODE_DETAILS y ROLE_APP_CUCM_NODE_DETAILS_EDIT. No se aplican a los gateways.

Paso a paso: guardar credenciales por defecto para los gateways

1. Abra EasyUC Cisco → Gateways → Analog GWs.
2. Haga clic en Default Credentials, arriba a la derecha. Se abre el área Default SSH Credentials. Los conjuntos se aplican a todos los gateways sin credenciales propias, tanto analógicos como CUBE.
3. En el primer conjunto, introduzca Set (un nombre), Username, Password, si es necesario Enable Password, y el Port.
4. Para más inicios de sesión, haga clic en Add credential set. El icono de la papelera elimina un conjunto.
5. Ordene los conjuntos de modo que el más habitual quede arriba. Al conectar, EasyUC prueba los conjuntos de arriba abajo.
6. Haga clic en Save.
7. Haga clic en Test en un gateway. EasyUC prueba los conjuntos uno tras otro y recuerda el que funciona. Su nombre aparece en la columna Credentials.

Paso a paso: asignar a un gateway analógico su propio host y su propio inicio de sesión

1. Abra Gateways → Analog GWs. La lista muestra Model, Name, IP Address, Description, Status, Active Calls y Credentials.
2. En la fila del gateway, haga clic en Credentials. Se abre el formulario Credentials for <Name>.
3. En IP Address / Host, introduzca la dirección con la que EasyUC llega al gateway mediante SSH. Es necesario si el CUCM no notifica ninguna dirección IP.
4. Introduzca los valores distintos en Username, SSH Port, Password y Enable Password. Un campo vacío utiliza el valor por defecto.
5. Haga clic en Save. La columna Credentials muestra ahora Custom.
6. Haga clic en Test para comprobar el inicio de sesión.
7. Para eliminar de nuevo las credenciales propias del gateway, haga clic en el icono de restablecer de la fila y confirme Are you sure?.

Paso a paso: añadir un Cisco CUBE

1. Abra EasyUC Cisco → Gateways → CUBEs. La página se llama CUBEs (SBC).
2. Haga clic en Create. Se abre el formulario Add Cisco CUBE (SBC).
3. Introduzca Name e IP Address. Ambos son campos obligatorios.
4. Revise el SSH Port. Por defecto es el 22.
5. Introduzca Username (obligatorio), Password y, si es necesario, la Enable Password.
6. Haga clic en Save. El CUBE aparece en la lista con Name, IP Address, Username, SSH Port y la columna Debug.
7. Haga clic en Open Ports o en la fila. Se abre la página de detalle con la pestaña Network.
8. Haga clic en Test Connection. El resultado aparece debajo del encabezado.

Paso a paso: comprobar y conmutar puertos de voz

1. Abra Gateways → Analog GWs y haga clic en Ports en el gateway. El botón aparece en cuanto se conoce una dirección IP o el gateway tiene una entrada propia.
2. La página de detalle abre la pestaña Voice Ports. La tabla muestra Port, Signaling, Admin, Operational, Status y Active Call.
3. Haga clic en Show Config en un puerto. EasyUC lee la configuración en ejecución del puerto de voz y muestra debajo Associated dial-peer(s).
4. Haga clic en Shutdown para desactivar un puerto administrativamente, o en Bring Up para volver a activarlo.
5. Haga clic en Refresh para volver a leer la lista de puertos.

Paso a paso: crear un config set y aplicarlo a un puerto

1. Abra la página de detalle de un gateway analógico y la pestaña Voice Ports.
2. Haga clic en Config Sets y después en Add config set.
3. Asigne un Name.
4. En Voice-Port commands, introduzca los comandos IOS para el puerto de voz. Utilice {PORT} como marcador de posición del puerto.
5. En Dial-Peer commands, introduzca los comandos para el dial peer. Se permiten marcadores de posición propios, como {DIALPEER} o {DN}.
6. Decida sobre el Replace mode. En un conjunto nuevo está activado.
7. Haga clic en Save en el conjunto.
8. En el puerto de destino, haga clic en Apply Config y seleccione el conjunto.
9. Rellene las variables solicitadas. Siempre que es posible, EasyUC las rellena previamente con la configuración actual del puerto. {PORT} se establece automáticamente.
10. Haga clic en Apply. EasyUC ejecuta los comandos en el gateway y muestra la salida en Applied.
11. Haga clic de nuevo en Show Config y compare el resultado.

Paso a paso: comprobar la red, los certificados y las llamadas activas

1. Abra la página de detalle de un gateway analógico o de un CUBE.
2. Seleccione la pestaña Network. En Interfaces encontrará Interface, IP Address, Status y Protocol. Debajo, System / Version muestra la salida de version del dispositivo.
3. Seleccione la pestaña Certificates. De cada certificado ve Subject, Issuer, Serial, Valid from y Valid until. Raw CLI output muestra la salida sin modificar.
4. Seleccione la pestaña Active Calls. La tabla muestra Call-ID, Direction, Number, Codec, Duration y Remote IP.
5. Para cortar una llamada, haga clic en End Call y confirme la consulta. La llamada se corta de inmediato.
6. En la lista Analog GWs, un clic en la celda Active Calls actualiza el número de este gateway.

Paso a paso: definir el almacenamiento y syslog para la captura de depuración del CUBE

1. Abra Gateways → CUBEs y haga clic en Storage & syslog. El ajuste se aplica a la captura de depuración de todos los CUBE.
2. En Syslog targets (IP addresses of EasyUC), introduzca una dirección IPv4 por línea con la que los CUBE llegan al appliance. La primera se aplica a los CUBE sin destino propio.
3. Revise el Syslog port (UDP). Es el puerto de recepción de EasyUC y el puerto de destino en el CUBE, y debe coincidir con el puerto abierto en el clúster.
4. Defina el Storage cap (MB). Cuando se alcanza, el receptor se detiene. No se elimina nada automáticamente.
5. Revise Maximum lines per second per CUBE y decida sobre Do not store SIP OPTIONS (keepalives).
6. Haga clic en Save. Si cambia destinos o puerto mientras hay CUBE activados, EasyUC nombra los CUBE afectados con los comandos. El guardado se realiza solo tras su confirmación.

Paso a paso: activar y evaluar la captura de depuración en un CUBE

1. Abra Gateways → CUBEs y haga clic en Debug capture en el CUBE. Como alternativa, abra la pestaña Debug en la página de detalle y haga clic en Settings.
2. Haga clic en Preflight check. EasyUC lee el CUBE solo con comandos show y evalúa credenciales, accesibilidad, nivel de privilegio, logging, CPU, memoria, reloj y destino de syslog. Un elemento marcado como Blocked impide la activación.
3. Active Debug capture.
4. Revise la selección en Debugs. Por defecto están ambos debugs. Debe seleccionarse al menos uno.
5. Seleccione la Retention: 1 day, 7 days, 30 days o Unlimited.
6. Deje activo Apply logging baseline si EasyUC debe establecer por sí mismo las marcas de tiempo, los números de secuencia, «no logging console», el destino de syslog y «logging trap debugging».
7. Si es necesario, introduzca un Syslog target (IP address of EasyUC) aparte. Si está vacío, se aplica el destino global.
8. Lea el recuadro Please read before switching on y la vista previa de comandos EasyUC runs these commands:. Marque la casilla en I have read the effects. EasyUC may run the commands shown on the CUBE.
9. Haga clic en Save. En Steps run ve qué comandos se ejecutaron correctamente. EasyUC no ejecuta «write memory».
10. En la página de detalle, abra la pestaña Debug. Check live consulta el estado en el CUBE. Los grupos Debugs, Logging, CUBE, Receiver y Storage muestran el estado.
11. Abra la pestaña Capture. Seleccione el período, busque un número de teléfono o un Call-ID y abra una llamada. La página Captured call muestra SIP ladder y Records. Raw text exporta los registros con los datos sensibles ocultados.
12. Tras la resolución del problema, desactive de nuevo la captura en Settings. En caso de emergencia, haga clic en Emergency stop en la pestaña Debug y confirme con Pull emergency stop.

Campos y opciones

Comprobar el resultado y resolver problemas

• Éxito del acceso SSH: Test o Test Connection devuelve un resultado sin errores y las pestañas de la página de detalle se rellenan.
• «No VG gateways found in this CUCM.»: la conexión CUCM activa no contiene gateways VG. Revise la conexión seleccionada.
• «No gateways configured yet.»: todavía no se ha introducido ningún CUBE en CUBEs.
• El botón Ports falta o está en gris: no se conoce ninguna dirección IP del gateway o todavía no tiene una entrada propia. Un usuario con ambos permisos de edición de gateway debe crear la entrada mediante Credentials.
• La columna Active Calls muestra un signo de advertencia: la consulta ha fallado. La información sobre herramientas indica el motivo o «Query failed». Esto no dice nada sobre el estado del dispositivo.
• «No ports found.» o «No dial-peer references this port.»: el gateway no notifica puertos de voz, o el puerto no figura en ningún dial peer.
• «No saved config sets yet – create one under “Config Sets” above.»: guarde primero un conjunto.
• Las credenciales por defecto afectan a todos los gateways sin credenciales propias. Un cambio nunca afecta a un único dispositivo.
• «The preflight check blocks switching on – nothing was changed on the CUBE.»: corrija los elementos bloqueantes de la comprobación previa, por ejemplo «logging console» establecido en debugging o un destino de syslog que falta.
• «No syslog target – please enter one.»: introduzca una dirección en Storage & syslog o en el CUBE.
• «The CUBE cannot be reached via SSH.» o «No credentials for the CUBE.»: revise la dirección, el puerto SSH y las credenciales.
• «The storage cap is reached: the receiver is paused, new lines are discarded.»: reduzca la retención o aumente el límite en Storage & syslog.
• «Switched off automatically at …» con un motivo, por ejemplo «CPU load too high»: el watchdog ha desactivado la captura. Aclare la causa y vuelva a activarla tras una nueva comprobación previa.
• Tras eliminar un CUBE con una captura en curso, puede aparecer una indicación de que los debugs en el dispositivo no se pudieron detener por completo. En ese caso, revise manualmente «show debugging» y la configuración de logging en el CUBE.
• Se guarda toda la salida de depuración, incluidos los números de teléfono. Las cabeceras de autorización y las claves SRTP se ocultan antes de guardar.