La registrazione dei gateway Cisco IOS al Control Hub semplifica la gestione dei dispositivi e consente di usufruire dei nuovi servizi di chiamata Webex. Poiché i gateway mantengono una connessione con l'Hub di controllo, è possibile gestirli e monitorarli da qualsiasi luogo, insieme a tutti gli altri dispositivi Webex Calling. Per registrare un gateway, è necessario installare un'applicazione di connettore di gestione e assicurarsi che vi sia una connessione sicura con il cloud Cisco Webex. Dopo aver stabilito questa connessione, è possibile registrare il gateway accedendo all'Hub di controllo.

Questa procedura non si applica ai gateway vocali Cisco IOS, come il VG400, che viene gestito interamente come dispositivo nell'Hub di controllo.

Una piccola applicazione di connessione, nota come GuestShell, è responsabile della creazione e del mantenimento di una connessione tra il gateway e l'hub di controllo. Le applicazioni GuestShell e connettore vengono configurate e impostate tramite uno script, che viene eseguito sul gateway dal cloud Webex durante il processo di registrazione.

Per semplificare il processo di installazione, lo script aggiunge una serie di configurazioni gateway necessarie.

I connettori del gateway sono piccole applicazioni che vengono eseguite nella GuestShell del gateway per mantenere una connessione con l'Hub di controllo, coordinare gli eventi e raccogliere informazioni sullo stato. Per ulteriori informazioni su GuestShell, vedere GuestShell.

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

Esistono due tipi di connettori:

• Connettore di gestione

• Connettore di telemetria

Uno script TCL interattivo con menu facilita la configurazione di GuestShell, nonché l'installazione e la manutenzione del connettore di gestione.

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

Dopo il completamento con successo della registrazione, il connettore di gestione scarica e installa il connettore di telemetria più recente.

Il seguente schema illustra come i diversi componenti si connettono in una soluzione di chiamate Webex:

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

• interfaccia

• Indirizzi del server DNS

• Dettagli del proxy

• Indirizzo IP del connettore

• Credenziali di accesso (nome utente e password)

Lo script TCL esegue le seguenti configurazioni:

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

• Conchiglia

• NETCONF Yang

• Configurazione delle trap SNMP: necessaria per ricevere notifiche da Cisco IOS XE.

• Instradamento IP: per instradare il traffico relativo 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, si tenga presente che l'applicazione del connettore non è compatibile con i seguenti dispositivi:

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

Quando si configura il router per l'utilizzo con un'applicazione connettore, si prega di tenere in considerazione i seguenti aspetti:

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

• Non utilizzare la traduzione degli indirizzi di rete (NAT) su piattaforme configurate per un Cisco Unified Border Element (CUBE). Pertanto, configura l'applicazione del connettore con un indirizzo IP instradabile. In altre parole, non può condividere l'indirizzo dell'interfaccia del router.

Prepara il tuo dispositivo per la registrazione al gateway:

• Accesso al Centro di controllo come amministratore dell'organizzazione

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

• Versione Cisco IOS XE:

  • Gateway locali: Cisco IOS XE Bengaluru 17.12.3 o versione successiva

  • Gateway di resilienza: Cisco IOS XE Dublin 17.12.3 o versioni successive

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

• Assicurarsi che il dispositivo sia configurato con i dettagli del server NTP per sincronizzare l'orologio di sistema con il server NTP designato.

• Prerequisiti di sistema

  • Memoria libera minima: 256 MB

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

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

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

Segui questi passaggi per espandere l'immagine binaria e avviare il sistema dai componenti:

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. Configura 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 si sia avviato da bootflash:/image/packages.conf. In tal caso:

   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 log di traccia utilizzando.delete /f /r bootflash:/tracelogs/*

   5. Se lo spazio su disco è ancora insufficiente, controlla i file rimanenti nella cartella bootflash: e cancellare tutti gli altri file non essenziali, come i file di registro e i CDR.

• Un router Cisco supportato, connesso a una rete con accesso a Internet. La configurazione di base deve includere quanto segue:

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

  • 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 di accesso: Per accedere al gateway tramite l'interfaccia NETCONF, il connettore richiede credenziali locali (nome utente e password) con livello di privilegio 15.

    Per autenticare e autorizzare l'accesso a 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 prevedono l'utilizzo di altri metodi (ad esempio TACACS o ISE) non sono state validate e al momento non sono 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 di quella scelta per la connettività esterna. Può trattarsi di un indirizzo di rete privata, ma deve avere accesso a Internet tramite HTTPS.

    Se si utilizza Virtual CUBE su Amazon Web Services (AWS) come gateway locale, fare riferimento a Associare un indirizzo IP secondario per Virtual CUBE su AWS per istruzioni su come associare un indirizzo IP secondario per l'utilizzo del connettore.

  • È necessario essere connessi all'hub di controllo e ai dispositivi locali per completare la procedura di registrazione.

  • URL per i servizi Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

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

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

    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 generale del connettore visualizzato nell'Hub di controllo dipende dallo stato dei connettori di telemetria e gestione sul Gateway gestito.

Stati del connettore nell'hub di controllo	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 è collegato ma è In pausa temporaneamente.

Amministrazione locale del connettore di gestione

Dopo aver installato correttamente il connettore, potrai 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 del display

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 

Abilitare la conchiglia protettiva

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

Disabilita Guestshell

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

Disinstallare il connettore

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

Raccogli registri

Raccogli i registri utilizzando l'opzione di menu l: Collect Logs. Il sistema visualizza la posizione in cui vengono archiviati questi registri dopo averli raccolti.

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

Di seguito è riportato un esempio di comando:

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

Cancella i registri

Cancella 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

Apporta 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

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

Aggiorna l'interfaccia esterna

Modifica 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 operazioni 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

Chiave di verifica del pacchetto del connettore di aggiornamento

In caso di problema tecnico, se il tecnico dell'assistenza richiede la sostituzione della chiave di verifica del pacchetto, caricare il nuovo file gateway-webex-connectors.gpg in bootflash:/gateway_connector/ e utilizzare l'opzione di menu k: Update Connector Package Verification Key per la verifica.

Modificare il livello di registrazione per il connettore di gestione

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

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

Per gestire la tua istanza del gateway:

1. Accedere a Control Hub.

2. Vai a Servizi > PSTN & Instradamento > Configurazioni del gateway > Gestisci i gateway

3. Per l'istanza del gateway applicabile, fare clic su e selezionare l'azione appropriata.