I connettori gateway sono piccole applicazioni che vengono eseguite nel gateway GuestShell per mantenere una connessione al Control Hub, coordinare gli eventi e raccogliere informazioni sullo stato. Per maggiori informazioni su GuestShell, vedere GuestShell.

I connettori gateway sono installati sul contenitore Cisco IOS XE GuestShell.

Esistono due tipi di connettori:

• Connettore di gestione

• Connettore di telemetria

Uno script TCL interattivo basato su menu aiuta a configurare GuestShell, nonché a installare e gestire il connettore di gestione.

Il connettore di gestione si occupa della registrazione del gateway e della gestione del ciclo di vita del connettore di telemetria.

Una volta completata con successo la registrazione, il connettore di gestione scarica e installa il connettore di telemetria più recente.

Il seguente grafico mostra come si collegano i diversi componenti in una soluzione Webex Calling:

Durante l'esecuzione dello script TCL, vengono raccolte le seguenti informazioni dall'utente:

• Interfaccia esterna

• Indirizzi dei server DNS

• Dettagli del proxy

• Indirizzo IP del connettore

• Credenziali del gateway (nome utente e password)

Lo script TCL esegue le seguenti configurazioni:

• Gruppo di porte virtuali: necessario per la configurazione della guestshell.

• Guestshell

• NETCONF Yang

• Configurazione Trap SNMP: necessaria per le notifiche da Cisco IOS XE.

• Percorso IP: per instradare il traffico correlato al connettore attraverso un gruppo di porte virtuali.

Lo script TCL esegue le seguenti configurazioni:

!
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
!
 

Prima dell'installazione, tieni presente che l'applicazione del connettore non può essere utilizzata con quanto segue:

• Piattaforme Cisco 1100 Integrated Services Router
• Piattaforme configurate in modalità High Availability (HA)
• Piattaforme configurate in modalità Controller per reti SD-WAN

Quando si configura il router per l'uso con un'applicazione di connessione, tenere presente quanto segue:

• IOS XE utilizza il proxy ARP per instradare il traffico verso la shell guest. Non configurare il comando no ip proxy-arp per disabilitare questa funzionalità.

• Non utilizzare Network Address Translation (NAT) su piattaforme configurate per Cisco Unified Border Element (CUBE). Pertanto, configurare l'applicazione del connettore con un indirizzo IP instradabile. Ciò significa che non può condividere l'indirizzo dell'interfaccia del router.

Prepara il tuo dispositivo per la registrazione al gateway:

• Accesso al Control Hub come amministratore dell'organizzazione

• Indirizzo IP, nome utente e password per i dispositivi che desideri configurare.

• Versione Cisco IOS XE:

  • Gateway locali: Cisco IOS XE Bengaluru 17.6.1a o versione successiva

  • Gateway di sopravvivenza: Cisco IOS XE Dublin 17.12.3 o versione successiva

  Per le versioni consigliate, vedere Cisco Software Research. Cerca la piattaforma e seleziona una delle versioni suggerite.

• Prerequisiti di sistema

  • Memoria minima libera: 256 MB

  • Spazio minimo su disco: il disco rigido (SSD) collegato al gateway utilizzato per l'installazione del connettore deve disporre di 2000 MB di spazio libero. Inoltre, bootflash deve avere 50 MB di spazio libero. Viene utilizzato per memorizzare i registri e i file RPM.

    Se al gateway non è collegato alcun disco rigido, per l'installazione del connettore viene utilizzato bootflash. Quindi, bootflash deve avere 2000 MB di spazio libero.

Se il bootflash del router è da 4 GB e la capacità disponibile è inferiore a 2 GB (la capacità minima), eliminare tutte le immagini binarie IOS (.bin) eccetto quella attualmente in esecuzione. Dopo aver eliminato i file, libera spazio extra.

Per espandere l'immagine binaria ed eseguire l'avvio dai componenti, procedere come segue:

1. Crea una nuova directory utilizzando.mkdir bootflash:/image

2. Espandere l'immagine binaria IOS utilizzando.request platform software package expand file bootflash:/.bin to bootflash:/image

3. In modalità di configurazione, rimuovere le opzioni di avvio correnti utilizzando.no boot system

4. Configurare una nuova istruzione di avvio: boot system bootflash:/image/packages.conf.

5. Uscire dalla modalità di configurazione, salvare la configurazione e riavviare.

6. Una volta riavviato il router, utilizzareshow version per verificare che il router sia stato avviato da bootflash:/image/packages.conf. Se è così:

   1. Verificare che la directory bootflash:/sysboot sia vuota.

   2. Eliminare l'immagine binaria IOS rimanente.

   3. Elimina tutte le immagini principali utilizzando.delete /f /r bootflash:/core/*

   4. Elimina i file di registro di traccia utilizzando.delete /f /r bootflash:/tracelogs/*

   5. Se lo spazio su disco è ancora insufficiente, controlla i file rimanenti in bootflash: ed eliminare tutti gli altri file non essenziali, come registri e CDR.

• Un router Cisco supportato, connesso a una rete con un percorso verso Internet. La configurazione di base deve avere quanto segue:

  • Il server DNS è configurato per risolvere i nomi di dominio pubblico.

  • Per configurare il server DNS, utilizzare il seguente comando:

    • server dei nomi IP <IP address>

  • Server proxy HTTP se si desidera accedere a Internet tramite un proxy.

  • Credenziali del gateway: Per accedere al gateway tramite la sua interfaccia NETCONF, il connettore necessita di credenziali locali (nome utente e password) con livello di privilegio 15.

    Per autenticare e autorizzare l'accesso NETCONF, assicurarsi che gli elenchi aaa predefiniti siano configurati come illustrato nell'esempio seguente. Solo i comandi elencati in questo documento sono stati convalidati e sono supportati per i Managed Gateway. Le configurazioni che coinvolgono altri metodi (ad esempio TACACS o ISE) non sono state convalidate e non sono attualmente supportate.

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

  Prerequisiti di rete

  • L'indirizzo IP del connettore deve trovarsi nella stessa rete scelta per la connettività esterna. Può essere un indirizzo di rete privata, ma deve avere accesso HTTPS a Internet.

    Se utilizzi Virtual CUBE su Amazon Web Services (AWS) come gateway locale, fai riferimento a Associare un indirizzo IP secondario per Virtual CUBE su AWS per i passaggi su come associare un indirizzo IP secondario per l'utilizzo del connettore.

  • Per completare il processo di registrazione, è necessario connettersi al Control Hub e ai dispositivi locali.

  • URL per i servizi Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protocolli di trasporto: Transport Layer Security (TLS) versione 1.2

  • Importa il bundle dell'autorità di certificazione pubblica IOS. I certificati aggiunti al pool di attendibilità del gateway vengono utilizzati per verificare l'accesso ai server Webex. Utilizzare il seguente comando di configurazione per importare il bundle.

    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: 

Lo stato complessivo del connettore visualizzato nel Control Hub dipende dallo stato dei connettori di telemetria e gestione sul Managed Gateway.

Stati del connettore nel Control Hub	Descrizione
Online	Indica che il connettore è Connesso al cloud Cisco Webex.
Offline	Indica che il connettore è Non connesso al cloud Cisco Webex.
Sospeso	Indica che il connettore è connesso ma è temporaneamente in pausa.

Amministrazione locale del connettore di gestione

Dopo aver installato correttamente il connettore, puoi utilizzare Webex Calling con il tuo gateway. Se necessario, è possibile aggiornare diverse impostazioni del connettore utilizzando le opzioni disponibili nel menu dello script:

È possibile riavviare lo script in qualsiasi momento utilizzando il seguente 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:

Stato di visualizzazione

Utilizzare l'opzione di menu s: Display Status Page. Il sistema visualizza lo stato dei diversi moduli connettore.

===============================================================
                 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 

Abilita Guestshell

Abilitare il connettore cloud utilizzando l'opzione di menu e: Enable Guestshell. Ciò modifica lo stato del connettore da INACTIVE a ACTIVE.

Disabilita Guestshell

Disattivare il connettore cloud utilizzando l'opzione di menu d: Disable Guestshell. Ciò modifica lo stato del connettore da ACTIVE a INACTIVE.

Disinstalla il connettore

Disinstallare il connettore cloud utilizzando l'opzione di menu u: Uninstall Connector. Questa operazione elimina tutti i dati nel contenitore Guestshell e rimuove tutte le configurazioni correlate al connettore cloud.

Raccogli registri

Raccogli i registri utilizzando l'opzione di menu l: Collect Logs. Dopo averli raccolti, il sistema visualizza la posizione in cui sono archiviati i registri.

Se hai un caso di supporto attivo con Cisco TAC, puoi allegare i registri direttamente alla tua richiesta di servizio utilizzando il comando copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Di seguito è riportato un comando di esempio:

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

Cancella registri

Cancellare tutti i file di registro nel dispositivo utilizzando l'opzione di menu r: Clear Logs. Questa operazione elimina tutti i log esistenti, ad eccezione dei log più recenti dello script TCL e dei connettori.

Visualizza e modifica le impostazioni del connettore cloud

Apportare le seguenti modifiche alle impostazioni esistenti di un connettore cloud utilizzando l'opzione di menu 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

Aggiorna le credenziali del gateway

Aggiornare il nome utente e la password del gateway utilizzando l'opzione di menu c: Update Gateway Credentials.

Aggiorna interfaccia esterna

Modificare l'interfaccia a cui è associato il connettore e l'indirizzo IP del connettore utilizzando l'opzione di menu v: View and Modify Cloud Connector Settings.

Aggiorna i dettagli del proxy

È possibile eseguire le seguenti attività utilizzando l'opzione di menu 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

Aggiorna la chiave di verifica del pacchetto del connettore

In caso di problemi tecnici, se il tecnico del supporto richiede di sostituire la chiave di verifica del pacchetto, carica il nuovo file gateway-webex-connectors.gpg su bootflash:/gateway_connector/ e utilizza l'opzione di menu k: Update Connector Package Verification Key per verificare.

Modificare il livello di registro per il connettore di gestione

Modificare il livello di registrazione per il connettore utilizzando l'opzione di menu l: Modify log level for Cloud Connector e quindi selezionare una delle seguenti opzioni:

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

Per gestire l'istanza del gateway:

1. Accedere a Control Hub.

2. Vai a SERVIZI, clicca su Chiamata, quindi clicca su Gateway gestiti.

3. Per l'istanza del gateway applicabile, fare clic su … nella colonna Azioni e selezionare l'azione applicabile.