Conectorii gateway sunt aplicații mici care rulează în GuestShell-ul gateway-ului pentru a menține o conexiune la Control Hub, a coordona evenimente și a colecta informații de stare. Pentru mai multe informații despre GuestShell, consultați GuestShell.

Conectorii gateway sunt instalați pe containerul Cisco IOS XE GuestShell.

Există două tipuri de conectori:

• Conector de gestionare

• Conector de telemetrie

Un script TCL interactiv, bazat pe meniuri, ajută la configurarea GuestShell, precum și la instalarea și întreținerea conectorului de administrare.

Conectorul de administrare se ocupă de înscrierea gateway-ului și de gestionarea ciclului de viață al conectorului de telemetrie.

După finalizarea cu succes a înscrierii, conectorul de administrare descarcă și instalează cea mai recentă versiune a conectorului de telemetrie.

Următoarea grafică arată cum se conectează diferitele componente într-o soluție Webex Calling:

Ca parte a execuției scriptului TCL, următoarele informații sunt colectate de la utilizator:

• Interfață externă

• Adresele serverelor DNS

• Detalii proxy

• Adresă IP a conectorului

• Acreditări Gateway (nume de utilizator și parolă)

Scriptul TCL efectuează următoarele configurații:

• Grup de porturi virtuale — Necesar pentru configurarea guestshell-ului.

• Guestshell

• NETCONF Yang

• Configurarea trap-urilor SNMP — Necesară pentru notificările de la Cisco IOS XE.

• Rută IP — Pentru a direcționa traficul legat de conector prin grupul de porturi virtuale.

Scriptul TCL efectuează următoarele configurații:

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

Înainte de instalare, rețineți că aplicația conector nu poate fi utilizată cu următoarele:

• Platforme de routere cu servicii integrate Cisco 1100
• Platforme configurate în modul de disponibilitate ridicată (HA)
• Platforme configurate în modul Controller pentru rețele SD-WAN

Luați în considerare următoarele aspecte atunci când configurați routerul pentru utilizarea cu o aplicație conector:

• IOS XE folosește proxy ARP pentru a ruta traficul către shell-ul guest. Nu configurați comanda no ip proxy-arp pentru a dezactiva această funcție.

• Nu utilizați Network Address Translation (NAT) pe platforme configurate pentru Cisco Unified Border Element (CUBE). Prin urmare, configurați aplicația conector cu o adresă IP rutabilă. Adică, nu poate partaja adresa interfeței routerului.

Pregătiți dispozitivul pentru o înscriere la gateway:

• Acces la Control Hub ca administrator al organizației

• Adresa IP, numele de utilizator și parola pentru dispozitivele pe care doriți să le configurați.

• Versiunea Cisco IOS XE:

  • Gateway-uri locale — Cisco IOS XE Bengaluru 17.6.1a sau o versiune ulterioară

  • Gateway-uri de supraviețuire — Cisco IOS XE Dublin 17.12.3 sau o versiune ulterioară

  Pentru versiunile recomandate, consultați Cisco Software Research. Căutați platforma și selectați una dintre versiunile sugerate.

• Cerințe preliminare ale sistemului

  • Memorie liberă minimă — 256 MB

  • Spațiu minim pe disc — Hard disk-ul (SSD) conectat la gateway-ul utilizat pentru instalarea conectorului trebuie să aibă 2000 MB de spațiu liber. De asemenea, bootflash-ul trebuie să aibă 50 MB spațiu liber. Este folosit pentru stocarea jurnalelor și a fișierelor RPM.

    Dacă nu este conectat un hard disk la gateway, atunci se folosește memoria bootflash pentru instalarea conectorului. Apoi, bootflash-ul trebuie să aibă 2000 MB spațiu liber.

Dacă memoria flash a routerului este de 4 GB și există mai puțin de 2 GB de capacitate disponibilă (capacitatea minimă), ștergeți toate imaginile binare IOS (.bin), cu excepția celei care rulează în prezent. După ce ștergeți fișierele, eliberați spațiu suplimentar.

Urmați pașii următori pentru a extinde imaginea binară și a porni din componente:

1. Creați un director nou folosind.mkdir bootflash:/image

2. Extindeți imaginea binară IOS folosind.request platform software package expand file bootflash:/.bin to bootflash:/image

3. În modul de configurare, eliminați opțiunile de boot curente folosind comanda.no boot system

4. Configurați o nouă instrucțiune de boot: boot system bootflash:/image/packages.conf.

5. Ieșiți din modul de configurare, salvați configurația și reporniți sistemul.

6. După ce routerul a repornit, utilizați pentru a verifica dacă routerul a pornit de pe bootflash:/image/packages.confshow version . Dacă da:

   1. Verificați dacă directorul bootflash:/sysboot este gol.

   2. Ștergeți imaginea binară IOS rămasă.

   3. Ștergeți orice imagini de bază folosind.delete /f /r bootflash:/core/*

   4. Ștergeți fișierele jurnal de urmărire folosind.delete /f /r bootflash:/tracelogs/*

   5. Dacă tot nu există suficient spațiu pe disc, verificați fișierele rămase în bootflash: și ștergeți orice alte fișiere neesențiale, cum ar fi jurnalele și CDR-urile.

• Un router Cisco acceptat, conectat la o rețea cu o cale către internet. Configurația de bază trebuie să aibă următoarele:

  • Serverul DNS este configurat să rezolve nume de domeniu public.

  • Pentru a configura serverul DNS, utilizați următoarea comandă:

    • server de nume IP <IP address>

  • Server proxy HTTP dacă doriți să vă conectați la internet printr-un proxy.

  • Acreditări gateway: Conectorul necesită o acreditare locală (nume de utilizator și parolă) cu nivel de privilegiu de acces 15 pentru a accesa gateway-ul prin interfața sa NETCONF.

    Pentru a autentifica și autoriza accesul NETCONF, asigurați-vă că listele aaa implicite sunt configurate așa cum este ilustrat în exemplul următor. Doar comenzile enumerate în acest document au fost validate și sunt acceptate pentru gateway-urile gestionate. Configurațiile care implică alte metode (de exemplu, TACACS sau ISE) nu au fost validate și nu sunt acceptate în prezent.

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

  Cerințe preliminare pentru rețea

  • Adresa IP a conectorului trebuie să fie în aceeași rețea ca cea aleasă pentru conectivitatea externă. Poate fi o adresă de rețea privată, dar trebuie să aibă acces HTTPS la internet.

    Dacă utilizați Virtual CUBE pe Amazon Web Services (AWS) ca gateway local, consultați Asociați o adresă IP secundară pentru Virtual CUBE pe AWS pentru pașii despre cum să asociați o adresă IP secundară pentru utilizarea conectorului.

  • Fiți conectat la Control Hub și la dispozitivele locale pentru a finaliza procesul de înscriere.

  • Adresele URL pentru serviciile Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protocoale de transport: Securitatea nivelului de transport (TLS) versiunea 1.2

  • Importați pachetul autorității de certificare publice IOS. Certificatele adăugate la grupul de încredere al gateway-ului sunt utilizate pentru a verifica accesul la serverele Webex. Folosește următoarea comandă de configurare pentru a importa pachetul.

    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: 

Starea generală a conectorului afișat în Control Hub depinde de starea conectorilor de telemetrie și gestionare de pe Managed Gateway.

Stările conectorilor în Control Hub	Descriere
Online	Indică faptul că conectorul este Conectat la cloud-ul Cisco Webex.
Offline	Indică faptul că conectorul nu este conectatla cloud-ul Cisco Webex.
Întrerupt	Indică faptul că conectorul este conectat, dar este pus în pauză temporar.

Administrarea locală a conectorului de management

Puteți utiliza Webex Calling cu gateway-ul după instalarea cu succes a conectorului. Dacă este necesar, puteți actualiza o serie de setări ale conectorului utilizând opțiunile disponibile în meniul scriptului:

Puteți relansa scriptul în orice moment folosind următoarea comandă: 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:

Afișează starea

Folosește opțiunea de meniu s: Display Status Page. Sistemul afișează starea diferitelor module conector.

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

Activează Guestshell

Activați conectorul cloud folosind opțiunea de meniu e: Enable Guestshell. Aceasta modifică starea conectorului din INACTIVE în ACTIVE.

Dezactivați Guestshell

Dezactivați conectorul cloud folosind opțiunea de meniu d: Disable Guestshell. Aceasta modifică starea conectorului din ACTIVE în INACTIVE.

Dezinstalați conectorul

Dezinstalați conectorul cloud folosind opțiunea de meniu u: Uninstall Connector. Aceasta șterge toate datele din containerul Guestshell și elimină toate configurațiile legate de conectorul cloud.

Colectați jurnale

Colectați jurnalele folosind opțiunea de meniu l: Collect Logs. Sistemul afișează locația în care sunt stocate aceste jurnale după colectarea lor.

Dacă aveți o solicitare de asistență activă cu Cisco TAC, puteți atașa jurnalele direct la solicitarea de service folosind comanda copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Următorul este un exemplu de comandă:

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

Șterge jurnalele

Ștergeți toate fișierele jurnal din dispozitiv utilizând opțiunea de meniu r: Clear Logs. Aceasta șterge toate jurnalele existente, cu excepția celor mai recente jurnale ale scriptului TCL și ale conectorilor.

Vizualizați și modificați setările conectorului Cloud

Efectuați următoarele modificări la setările existente ale unui conector cloud utilizând opțiunea de meniu 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

Actualizați acreditările gateway-ului

Actualizați numele de utilizator și parola gateway-ului utilizând opțiunea de meniu c: Update Gateway Credentials.

Actualizați interfața externă

Schimbați interfața la care este conectat conectorul și adresa IP a conectorului utilizând opțiunea de meniu v: View and Modify Cloud Connector Settings.

Actualizați detaliile proxy-ului

Puteți efectua următoarele sarcini folosind opțiunea de meniu 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

Actualizați cheia de verificare a pachetului conectorului

În cazul unei probleme tehnice, dacă inginerul de asistență solicită înlocuirea cheii de verificare a pachetului, încărcați noul fișier gateway-webex-connectors.gpg în bootflash:/gateway_connector/ și utilizați opțiunea de meniu k: Update Connector Package Verification Key pentru verificare.

Modificarea nivelului de jurnalizare pentru conectorul de gestionare

Schimbați nivelul de înregistrare în jurnal pentru conector utilizând opțiunea de meniu l: Modify log level for Cloud Connector, apoi selectați una dintre următoarele opțiuni:

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

Pentru a gestiona instanța gateway-ului:

1. Conectați-vă la Control Hub.

2. Accesați SERVICII, faceți clic pe Apeluri, apoi faceți clic pe Gateway-uri gestionate.

3. Pentru instanța gateway aplicabilă, faceți clic pe … în coloana Acțiuni și selectați acțiunea aplicabilă.