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

Los conectores de puerta de enlace están instalados en el contenedor Cisco IOS XE GuestShell.

Hay dos tipos de conectores:

• Conector de gestión

• Conector de telemetría

Un script TCL interactivo controlado por menú ayuda a configurar GuestShell, así como a instalar y mantener el conector de administración.

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

Después de completar exitosamente la inscripción, el conector de administración descarga e instala el conector de telemetría más reciente.

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

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

• Interfaz externa

• Direcciones de servidores DNS

• Detalles del proxy

• Dirección IP del conector

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

El script TCL realiza las siguientes configuraciones:

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

• Guestshell

• NETCONF Yang

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

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

El script 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 proxy ARP para enrutar el tráfico al shell invitado. No configure el comando no ip proxy-arp para deshabilitar esta función.

• No utilice la traducción de direcciones de red (NAT) en plataformas que estén 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 su dispositivo para una inscripción en la puerta de enlace:

• Acceso al Centro de Control 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 Dublin 17.12.3 o posterior

  Para conocer las versiones recomendadas, consulte Cisco Software Research. Busca la plataforma y selecciona uno de los lanzamientos sugeridos

• 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, el bootflash debe tener 50 MB de espacio libre. Se utiliza para almacenar los registros y archivos RPM.

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

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

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

1. Crea un nuevo directorio usando.mkdir bootflash:/image

2. Expandir la imagen binaria de IOS usando.request platform software package expand file bootflash:/.bin to bootflash:/image

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

4. Configurar una nueva declaració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 el enrutador se haya reiniciado, use parashow version verificar que el enrutador se inició desde bootflash:/image/packages.conf. En ese caso:

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

   2. Eliminar la imagen binaria restante de IOS.

   3. Eliminar cualquier imagen principal utilizando.delete /f /r bootflash:/core/*

   4. Eliminar archivos de registro de seguimiento utilizando.delete /f /r bootflash:/tracelogs/*

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

• Un enrutador 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úblico.

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

    • servidor de nombres 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 de acceso 15 para acceder a la puerta de enlace a través de su interfaz 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 siguiente ejemplo. Solo los comandos enumerados en este documento han sido validados y son compatibles con Managed Gateways. Las configuraciones que involucran otros métodos (por ejemplo, TACACS o ISE) no han sido validadas y actualmente no son compatibles.

    
    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 usa 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 sobre cómo asociar una dirección IP secundaria para el uso del conector.

  • Conéctese al Control Hub y a los dispositivos locales para completar el proceso de inscripción.

  • URL para servicios de Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

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

  • Importar el paquete de autoridad de certificación pública de IOS. Los certificados agregados al grupo de confianza de la puerta de enlace se utilizan para verificar el acceso a los servidores 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 el Centro de control depende del estado de los conectores de telemetría y administración en el Gateway administrado.

Estados del conector en el centro de control	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 gestión

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

Puede reiniciar el script en cualquier momento utilizando 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 la pantalla

Utilice la opción de menú s: Display Status Page. El sistema muestra el estado de los diferentes módulos 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 de nube mediante la opción de menú e: Enable Guestshell. Esto cambia el estado del conector de INACTIVE a ACTIVE.

Deshabilitar Guestshell

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

Desinstalar el conector

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

Recopilar registros

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

Si tiene un caso de soporte activo con Cisco TAC, puede adjuntar los registros directamente a su solicitud de servicio utilizando 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 del dispositivo utilizando la opción de menú r: Clear Logs. Esto elimina todos los registros existentes excepto los registros más recientes del script y los conectores TCL.

Ver y modificar la configuración del conector de nube

Realice los siguientes cambios en la configuración existente de un conector de nube utilizando 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 puerta de enlace

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

Actualizar la interfaz externa

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

Actualizar detalles del proxy

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

• 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 la clave de verificación del paquete del conector

En el caso de un problema técnico, si el ingeniero de soporte solicita reemplazar su clave de verificación de paquete, cargue el nuevo archivo gateway-webex-connectors.gpg en bootflash:/gateway_connector/ y use 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 del conector utilizando la opción de menú l: Modify log level for Cloud Connector 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. Vaya a SERVICIOS, haga clic en Llamadasy, a continuación, haga clic en Pasarelas administradas.

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