Inscribir puertas de enlace administradas por Cisco IOS en la nube de Webex

Los conectores de la puerta de enlace son pequeñas aplicaciones que se ejecutan en la puerta de enlace GuestShell para mantener una conexión con Control Hub, coordinar eventos y recopilar información de estado. Para obtener más información sobre GuestShell, consulte GuestShell.

Los conectores de la puerta de enlace se instalan en el contenedor Cisco IOS XE GuestShell.

Existen dos tipos de conectores:

• Conector de administración

• Conector de telemetría

Una secuencia de comandos de TCL interactiva basada en menús ayuda a configurar GuestShell, así como la instalación y el mantenimiento del conector de administración.

El conector de administración se encarga de la inscripción de la puerta de enlace y de la administración del ciclo de vida del conector de telemetría.

Una vez finalizada la inscripción con éxito, el conector de administración descarga e instala el conector de telemetría más reciente.

El siguiente gráfico muestra cómo los diferentes componentes se conectan en una solución de Webex Calling:

Como parte de la ejecución del script TCL, se recopila la siguiente información del usuario:

• Interfaz externa

• Direcciones del servidor DNS

• Detalles del proxy

• Dirección IP del conector

• Credenciales de la puerta de enlace (nombre de usuario y contraseña)

La secuencia de comandos de TCL realiza las siguientes configuraciones:

• Grupo de puertos virtuales: necesario para la configuración de la shell de guestshell.

• Shell de Guestshell

• Categoría: NETCONF Yang

• Configuración de la trampa de SNMP: necesaria para las notificaciones de Cisco IOS XE.

• Ruta IP: para enrutar tráfico relacionado con conectores a través del grupo de puertos virtuales.

La secuencia de comandos de TCL realiza las siguientes configuraciones:

!
interface VirtualPortGroup 0
 ip unnumbered GigabitEthernet1
 no mop enabled
 no mop sysid
!

!
app-hosting appid guestshell
 app-vnic gateway0 virtualportgroup 0 guest-interface 0
  guest-ipaddress 10.65.125.227 netmask 255.255.255.128
 app-default-gateway 10.65.125.142 guest-interface 0
 app-resource profile custom
  cpu 800
  memory 256
  persist-disk 500
 name-server0 72.163.128.140
 name-server1 8.8.8.8
!

!
netconf-yang
netconf-yang cisco-ia snmp-trap-control trap-list 1.3.6.1.4.1.9.9.41.2.0.1
netconf-yang cisco-ia snmp-community-string Gateway-Webex-Cloud
!

!
logging snmp-trap emergencies
logging snmp-trap alerts
logging snmp-trap critical
logging snmp-trap errors
logging snmp-trap warnings
logging snmp-trap notifications
!

!
snmp-server community Gateway-Webex-Cloud RO
snmp-server enable traps syslog
snmp-server manager
!

!
ip route 10.65.125.227 255.255.255.255 VirtualPortGroup0
!
 

Antes de la instalación, tenga en cuenta que la aplicación del conector no se puede utilizar con lo siguiente:

• Plataformas de enrutador de servicios integrados Cisco 1100
• Plataformas configuradas en modo de alta disponibilidad (HA)
• Plataformas configuradas en modo controlador para redes SD-WAN

Tenga en cuenta lo siguiente al configurar su enrutador para usarlo con una aplicación de conector:

• IOS XE utiliza el proxy ARP para enrutar el tráfico al shell invitado. No configure ningún proxy IP-arp comand para deshabilitar esta característica.

• No utilice la traducción de direcciones de red (NAT) en las plataformas configuradas para un Cisco Unified Border Element (CUBE). Por lo tanto, configure la aplicación del conector con una dirección IP enrutable. Es decir, no puede compartir la dirección de la interfaz del enrutador.

Prepare el dispositivo para la inscripción de una puerta de enlace:

• Acceso a Control Hub como administrador de la organización

• Dirección IP, nombre de usuario y contraseña de los dispositivos que desea configurar.

• Versión de Cisco IOS XE:

  • Puertas de enlace locales: Cisco IOS XE Bengaluru 17.6.1a o posterior

  • Puertas de enlace de supervivencia: Cisco IOS XE Dublín 17.12.3 o posterior

  Para conocer las versiones recomendadas, consulte Investigación de software de Cisco. Busque la plataforma y seleccione una de las versiones Sugeridas .

• Requisitos previos del sistema

  • Memoria libre mínima: 256 MB

  • Espacio mínimo en disco: el disco duro (SSD) conectado a la puerta de enlace que se utiliza para la instalación del conector debe tener 2000 MB de espacio libre. Además, bootflash debe tener 50 MB de espacio libre. Se utiliza para almacenar los registros y los archivos RPM.

    Si no hay un disco duro conectado a la puerta de enlace, se utiliza bootflash para la instalación del conector. Luego, bootflash debe tener 2000 MB de espacio libre.

Si el bootflash de su router es de 4 GB y hay menos de 2 GB de capacidad disponible (la capacidad mínima), elimine todas las imágenes binarias de iOS (.bin) excepto la que se esté ejecutando actualmente. Después de eliminar los archivos, libere espacio adicional.

Siga los siguientes pasos para expandir la imagen binaria y arrancar desde los componentes:

1. Cree un nuevo directorio con mkdir bootflash:/image.

2. Expanda la imagen binaria de iOS con request platform software package expand file bootflash:/.bin to bootflash:/image.

3. En el modo de configuración, elimine las opciones de inicio actuales mediante no boot system.

4. Configure una nueva instrucción de arranque: boot system bootflash:/image/packages.conf.

5. Salga del modo de configuración, guarde la configuración y reinicie.

6. Una vez que se haya reiniciado el enrutador, utilice show version para verificar que el enrutador se haya iniciado desde bootflash:/image/packages.conf. En caso afirmativo:

   1. Verifique que el bootflash:/sysboot directorio esté vacío.

   2. Elimina la imagen binaria de iOS restante.

   3. Elimine las imágenes principales con delete /f /r bootflash:/core/*.

   4. Elimine los archivos de registro de seguimiento con delete /f /r bootflash:/tracelogs/*.

   5. Si todavía no hay espacio en disco suficiente, revise los archivos restantes en bootflash: y elimine cualquier otro archivo no esencial, como registros y CDR.

• Un router de Cisco compatible, que está conectado a una red con una ruta a Internet. La configuración básica debe tener lo siguiente:

  • El servidor DNS está configurado para resolver nombres de dominio públicos.

  • Para configurar el servidor DNS, utilice el siguiente comando:

    • servidor de nombre de ip <IP address>

  • Servidor proxy HTTP si desea acceder a Internet a través de un proxy.

  • Credenciales de puerta de enlace: El conector requiere una credencial local (nombre de usuario y contraseña) con nivel de privilegio 15 para acceder a la puerta de enlace a través de su interfaz de NETCONF.

    Para autenticar y autorizar el acceso a NETCONF, asegúrese de que las listas aaa predeterminadas estén configuradas como se ilustra en el ejemplo. No puede utilizar una lista aaa con nombre para controlar el acceso a NETCONF. Si las listas predeterminadas no están configuradas correctamente, es posible que vea un mensaje de error "lista de métodos no válida" en el registro del sistema. Es posible que desee utilizar otros métodos junto con el local para AAA; se puede lograr; sin embargo, se necesitará una actualización específica de la configuración.

    
    aaa new-model
    aaa authentication login default local
    aaa authorization exec default local if-authenticated
    username test privilege 15 secret 
    

  Requisitos previos de la red

  • La dirección IP del conector debe estar en la misma red que la elegida para la conectividad externa. Puede ser una dirección de red privada, pero debe tener acceso HTTPS a Internet.

    Si utiliza Virtual CUBE en Amazon Web Services (AWS) como su puerta de enlace local, consulte Asociar una dirección IP secundaria para Virtual CUBE en AWS para conocer los pasos a seguir para asociar una dirección IP secundaria para el uso del conector.

  • Esté conectado a Control Hub y a los dispositivos locales para completar el proceso de inscripción.

  • URL para los servicios de Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protocolos de transporte: Seguridad de la capa de transporte (TLS), versión 1.2

  • Importe el paquete de autoridades de emisión de certificados públicos de IOS. Los certificados agregados al grupo de confianza de la puerta de enlace se utilizan para verificar el acceso a los servidores de Webex. Utilice el siguiente comando de configuración para importar el paquete.

    crypto pki trustpool import url https://www.cisco.com/security/pki/trs/ios.p7b

 ===============================================================
             Webex Gateway Connector Installation
 ===============================================================


 Choose the external-interface from the below list of available interfaces:
 ===============================================================
   Number          Interface          IP-Address        Status
 ===============================================================
     1          GigabitEthernet1      10.65.125.142       up    
 ===============================================================

 Enter a number to choose the external interface: 1

These DNS settings were detected in the gateway configuration:
 72.163.128.140 
Do you want to use these settings for the connector? [Y/n]: 

These DNS settings were detected in the gateway configuration:
72.163.128.140
Do you want to use these settings for the connector? [Y/n]: n

These proxy settings were detected in the gateway configuration:
 Proxy Server : proxy-wsa.esl.cisco.com
 Proxy Port   : 80
Do you want to use these settings for the connector? [Y/n]: 

SNMP Traps for syslog messages are
configured at  level and they would be changed to 
level in order to push notifications to the Webex Cloud.
Please confirm if it is ok to proceed?:  [Y/n]: 

 Enter Connector IP address: 10.65.125.227

Enter Gateway username: lab
Enter Gateway password: ***
Confirm Gateway password: ***

===============================================================
                 Webex Managed Gateway Connector
===============================================================

  *** Cloud connector is installed successfully. ***
-------------------------------------------------------
         *** Interface Status ***
-------------------------------------------------------
   Interface               IP-Address          Status
-------------------------------------------------------
   GigabitEthernet1        10.65.125.142       up    
   VirtualPortGroup0       10.65.125.142       up    
   Connector               10.65.125.188       up
   
-------------------------------------------------------

          *** App Status ***
-------------------------------------------------------
 Service                 Status
-------------------------------------------------------
 Guestshell              RUNNING
 Management Connector    RUNNING
-------------------------------------------------------

===============================================================
 Select option h for home menu or q to quit: 

El estado general del conector que se muestra en Control Hub depende del estado de los conectores de administración y telemetría en la puerta de enlace administrada.

Estados del conector en Control Hub	Descripción
En línea	Indica que el conector está Conectado a la nube de Cisco Webex.
Sin conexión	Indica que el conector no está conectado a la nube de Cisco Webex.
En pausa	Indica que el conector está conectado, pero está En pausa temporalmente.

Administración local del Conector de administración

Puede utilizar Webex Calling con su puerta de enlace después de instalar correctamente el conector. Si es necesario, puede actualizar una serie de ajustes de conectores con las opciones disponibles en el menú de secuencias de comandos:

Puede volver a iniciar la secuencia de comandos en cualquier momento usando el siguiente comando: tclsh bootflash:/gateway_connector/gateway_onboarding.tcl.

===============================================================
Webex Managed Gateway Connector
===============================================================
Options
s : Display Status Page
v : View and Modify Cloud Connector Settings
e : Enable Guestshell
d : Disable Guestshell
l : Collect Logs
r : Clear Logs
u : Uninstall Connector
q : Quit
===============================================================
Select an option from the menu:

Estado de visualización

Utilice la s: Display Status Page opción de menú. El sistema muestra el estado de los diferentes módulos de conectores.

===============================================================
                 Webex Managed Gateway Connector
===============================================================
     -------------------------------------------------------
                     *** Interface Status ***
     -------------------------------------------------------
       Interface               IP-Address          Status
     -------------------------------------------------------
       GigabitEthernet1        10.123.221.224        up    
       Connector               10.123.221.223        up
     -------------------------------------------------------
                       *** App Status ***
     -------------------------------------------------------
		Service                   Status
     -------------------------------------------------------
            Guestshell                  RUNNING
            Management Connector        RUNNING
     -------------------------------------------------------
===============================================================
          Select option h for home menu or q to quit: q 

Habilitar Guestshell

Habilite el conector en la nube mediante la e: Enable Guestshell opción de menú. Esto cambia el estado del conector de INACTIVE a ACTIVE.

Deshabilitar shell de Guestshell

Deshabilite el conector a la nube con la d: Disable Guestshell opción de menú. Esto cambia el estado del conector de ACTIVE a INACTIVE.

Desinstalar el conector

Desinstale el conector en la nube mediante la u: Uninstall Connector opción de menú. Esto elimina todos los datos del contenedor Guestshell y elimina todas las configuraciones relacionadas con el conector en la nube.

Recopilar registros

Recopile los registros mediante la opción de menú l: Collect Logs . El sistema muestra la ubicación donde se almacenan estos registros después de recopilar los registros.

Si tiene un caso de soporte activo con el TAC de Cisco, puede adjuntar los registros directamente a su solicitud de servicio mediante el comando copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

El siguiente es un comando de muestra:

vcubeprod#copy bootflash:/guest-share/gateway_webex_cloud_logs_2022114090628.tar.gz scp://123456789:a1b2c3d4e5@cxd.cisco.com

Borrar registros

Borre todos los archivos de registro en el dispositivo mediante la opción de menú r: Clear Logs . Esto elimina todos los registros existentes, excepto los últimos registros de la secuencia de comandos y los conectores de TCL.

Ver y modificar la configuración de Cloud Connector

Realice los siguientes cambios en la configuración existente de un conector en la nube mediante la opción de menú v: View and Modify Cloud Connector Settings .

===============================================================
                Webex Managed Gateway Connector
===============================================================
		Script Version         : 2.0.2
		Hostname/IP Addr       : 10.65.125.188
		DNS Server(s)          : 10.64.86.70
		Gateway Username       : lab
		External Interface     : GigabitEthernet1
		Proxy Hostname/IP Addr : proxy-wsa.esl.cisco.com:80
===============================================================
             Options
               c :  Update Gateway Credentials
               e :  Update External Interface
               p :  Update Proxy Details
               n :  Update DNS Server
               k :  Update Connector Package Verification Key
               l :  Modify log level for Cloud Connector
               h :  Go to home menu
               q :  Quit

===============================================================
                        Select an option from the menu: c

Actualizar credenciales de la puerta de enlace

Actualice el nombre de usuario y la contraseña de la puerta de enlace mediante la opción de menú c: Update Gateway Credentials .

Actualizar interfaz externa

Cambie la interfaz a la que está vinculado el conector y la dirección IP del conector mediante la v: View and Modify Cloud Connector Settings opción de menú.

Actualizar los detalles del proxy

Puede realizar las siguientes tareas con la p: Update Proxy Details opción de menú:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Actualizar clave de verificación del paquete del conector

En caso de un problema técnico, si el ingeniero de soporte solicita reemplazar su clave de verificación del paquete, cargue el nuevo gateway-webex-connectors.gpg archivo en bootflash:/gateway_connector/ y utilice la opción de menú k: Update Connector Package Verification Key para verificar.

Modificar el nivel de registro para el Conector de administración

Cambie el nivel de registro para el conector mediante la l: Modify log level for Cloud Connector opción de menú y luego seleccione una de las siguientes opciones:

=====================================
  Number      Log Level 
=====================================
   1           DEBUG 
   2           INFO 
   3           WARNING 
   4           ERROR 
   5           CRITICAL 
======================================

Para administrar su instancia de puerta de enlace:

1. Inicie sesión en el Control Hub.

2. Diríjase a SERVICIOS, haga clic en Llamadas y, luego, en Puertas de enlace administradas.

3. Para la instancia de puerta de enlace aplicable, haga clic en … en la columna Acciones y seleccione la acción aplicable.