Gatewayconnectors zijn kleine toepassingen die in de gateway GuestShell worden uitgevoerd om een verbinding met de Control Hub te onderhouden, gebeurtenissen te coördineren en statusinformatie te verzamelen. Zie GuestShellvoor meer informatie over GuestShell.

De gatewayconnectoren worden geïnstalleerd op de Cisco IOS XE GuestShell-container.

Er zijn twee soorten connectoren:

• Beheerconnector

• Telemetrieconnector

Met behulp van een interactief menugestuurd TCL-script kunt u GuestShell instellen en de beheerconnector installeren en onderhouden.

De beheerconnector zorgt voor gateway-inschrijving en levenscyclusbeheer van de telemetrieconnector.

Zodra de inschrijving succesvol is voltooid, downloadt en installeert de beheerconnector de nieuwste telemetrieconnector.

De onderstaande afbeelding laat zien hoe de verschillende componenten in een Webex Calling-oplossing met elkaar in verbinding staan:

Tijdens de uitvoering van het TCL-script worden de volgende gegevens van de gebruiker verzameld:

• Externe interface

• DNS-serveradressen

• Proxygegevens

• Connector IP-adres

• Gateway-inloggegevens (gebruikersnaam en wachtwoord)

Het TCL-script voert de volgende configuraties uit:

• Virtuele poortgroep: vereist voor guestshell-configuratie.

• Gastenshell

• NETCONF Yang

• SNMP Trap-configuratie: vereist voor meldingen van Cisco IOS XE.

• IP-route: om connectorgerelateerd verkeer via een virtuele poortgroep te routeren.

Het TCL-script voert de volgende configuraties uit:

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

Houd er vóór de installatie rekening mee dat de connectortoepassing niet kan worden gebruikt met het volgende:

• Cisco 1100 Integrated Services Router-platforms
• Platforms geconfigureerd in de modus Hoge beschikbaarheid (HA)
• Platforms geconfigureerd in Controller-modus voor SD-WAN-netwerken

Houd rekening met het volgende wanneer u uw router configureert voor gebruik met een connectortoepassing:

• IOS XE gebruikt proxy ARP om verkeer naar de gastshell te routeren. Configureer niet de opdracht no ip proxy-arp om deze functie uit te schakelen.

• Gebruik Network Address Translation (NAT) niet op platforms die zijn geconfigureerd voor een Cisco Unified Border Element (CUBE). Configureer daarom de connectortoepassing met een routeerbaar IP-adres. Dat wil zeggen dat het het routerinterfaceadres niet kan delen.

Bereid uw apparaat voor op een gateway-inschrijving:

• Toegang tot de Control Hub als organisatiebeheerder

• IP-adres, gebruikersnaam en wachtwoord voor de apparaten die u wilt configureren.

• Cisco IOS XE-versie:

  • Lokale gateways: Cisco IOS XE Bengaluru 17.6.1a of hoger

  • Overlevingsgateways: Cisco iOS XE Dublin 17.12.3 of later

  Voor de aanbevolen versies, zie Cisco Software Research. Zoek naar het platform en selecteer een van de voorgestelde releases.

• Systeemvereisten

  • Minimaal vrij geheugen: 256 MB

  • Minimale schijfruimte: de harde schijf (SSD) die is aangesloten op de gateway en die wordt gebruikt voor de installatie van de connector, moet 2000 MB vrije ruimte hebben. Daarnaast moet bootflash 50 MB vrije ruimte hebben. Het wordt gebruikt om logs en RPM-bestanden op te slaan.

    Als er geen harde schijf op de gateway is aangesloten, wordt bootflash gebruikt voor de connectorinstallatie. Dan moet bootflash 2000MB vrije ruimte hebben.

Als de bootflash van uw router 4 GB is en er minder dan 2 GB beschikbare capaciteit is (de minimale capaciteit), verwijder dan alle binaire IOS-images (.bin), behalve degene die op dat moment actief is. Maak extra ruimte vrij nadat u de bestanden hebt verwijderd.

Gebruik de volgende stappen om de binaire image uit te pakken en op te starten vanaf de componenten:

1. Maak een nieuwe directory aan met behulp van.mkdir bootflash:/image

2. Breid het binaire IOS-image uit met behulp van.request platform software package expand file bootflash:/.bin to bootflash:/image

3. Verwijder in de configuratiemodus de huidige opstartopties met behulp van.no boot system

4. Configureer een nieuwe boot-instructie: boot system bootflash:/image/packages.conf.

5. Sluit de configuratiemodus af, sla de configuratie op en start het systeem opnieuw op.

6. Nadat de router opnieuw is opgestart, gebruikt ushow version om te verifiëren of de router is opgestart vanaf bootflash:/image/packages.conf. Zo ja:

   1. Controleer of de map bootflash:/sysboot leeg is.

   2. Verwijder het resterende binaire IOS-image.

   3. Verwijder alle kernafbeeldingen die u gebruikt.delete /f /r bootflash:/core/*

   4. Verwijder trace logbestanden met behulp van.delete /f /r bootflash:/tracelogs/*

   5. Als er nog steeds onvoldoende schijfruimte is, controleer dan de resterende bestanden in bootflash: en verwijder alle andere niet-essentiële bestanden, zoals logbestanden en CDR's.

• Een ondersteunde Cisco-router die is verbonden met een netwerk met een pad naar het internet. De basisconfiguratie moet het volgende bevatten:

  • De DNS-server is geconfigureerd om openbare domeinnamen om te zetten.

  • Gebruik de volgende opdracht om de DNS-server te configureren:

    • ip-naamserver <IP address>

  • HTTP-proxyserver als u via een proxy verbinding met internet wilt maken.

  • Gateway-inloggegevens: Er is een lokale referentie (gebruikersnaam en wachtwoord) met toegangsrechtenniveau 15 vereist voor de connector om toegang te krijgen tot de gateway via de NETCONF-interface.

    Om NETCONF-toegang te verifiëren en autoriseren, moet u ervoor zorgen dat de standaard aaa-lijsten zijn geconfigureerd zoals in het volgende voorbeeld. Alleen de opdrachten die in dit document worden vermeld, zijn gevalideerd en worden ondersteund voor beheerde gateways. Configuraties die andere methoden omvatten (bijvoorbeeld TACACS of ISE) zijn niet gevalideerd en worden momenteel niet ondersteund.

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

  Netwerkvereisten

  • Het IP-adres van de connector moet zich in hetzelfde netwerk bevinden als het netwerk dat is gekozen voor externe connectiviteit. Dit kan een privé-netwerkadres zijn, maar dan moet er wel HTTPS-toegang tot internet zijn.

    Als u Virtual CUBE op Amazon Web Services (AWS) als uw lokale gateway gebruikt, raadpleeg dan Een secundair IP-adres koppelen voor Virtual CUBE op AWS voor stappen over het koppelen van een secundair IP-adres voor connectorgebruik.

  • Zorg dat u verbinding hebt met de Control Hub en on-premises apparaten om het inschrijvingsproces te voltooien.

  • URL's voor Webex-services:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportprotocollen: Transport Layer Security (TLS) versie 1.2

  • Importeer het openbare IOS-certificeringsinstantiepakket. De certificaten die aan de gateway-vertrouwenspool zijn toegevoegd, worden gebruikt om toegang tot Webex-servers te verifiëren. Gebruik de volgende configuratieopdracht om de bundel te importeren.

    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: 

De algemene status van de connector die in de Control Hub wordt weergegeven, is afhankelijk van de status van de telemetrie- en beheerconnectoren op de Managed Gateway.

Connectorstatussen in de Control Hub	Beschrijving
Online	Geeft aan dat de connector is verbonden met de Cisco Webex-cloud.
Offline	Geeft aan dat de connector Niet verbonden is met de Cisco Webex-cloud.
Onderbroken	Geeft aan dat de connector is aangesloten, maar tijdelijk is gepauzeerd.

Lokaal beheer van de beheerconnector

Nadat u de connector succesvol hebt geïnstalleerd, kunt u Webex Calling gebruiken met uw gateway. Indien nodig kunt u een aantal connectorinstellingen bijwerken met behulp van de opties die beschikbaar zijn in het scriptmenu:

U kunt het script op elk gewenst moment opnieuw starten met de volgende opdracht: 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:

Weergavestatus

Gebruik de menuoptie s: Display Status Page. Het systeem geeft de status van verschillende connectormodules weer.

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

Guestshell inschakelen

Schakel de cloudconnector in via de menuoptie e: Enable Guestshell. Hiermee verandert de status van de connector van INACTIVE naar ACTIVE.

Gastshell uitschakelen

Schakel de cloudconnector uit via de menuoptie d: Disable Guestshell. Hiermee verandert de status van de connector van ACTIVE naar INACTIVE.

Connector verwijderen

Verwijder de cloudconnector via de menuoptie u: Uninstall Connector. Hiermee worden alle gegevens in de Guestshell-container verwijderd en worden alle configuraties die betrekking hebben op de cloudconnector verwijderd.

Logboeken verzamelen

Verzamel de logs met behulp van de menuoptie l: Collect Logs. Nadat de logs zijn verzameld, geeft het systeem de locatie weer waar deze logs zijn opgeslagen.

Als u een actieve ondersteuningscase bij Cisco TAC hebt, kunt u de logboeken rechtstreeks aan uw serviceaanvraag toevoegen met de opdracht copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Hieronder volgt een voorbeeldopdracht:

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

Logboeken wissen

Wis alle logbestanden op het apparaat met de menuoptie r: Clear Logs. Hiermee worden alle bestaande logboeken verwijderd, behalve de nieuwste logboeken van het TCL-script en de connectoren.

Cloud Connector-instellingen bekijken en wijzigen

Breng de volgende wijzigingen aan in de bestaande instellingen van een cloudconnector met behulp van de menuoptie 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

Gateway-referenties bijwerken

Werk de gebruikersnaam en het wachtwoord van de gateway bij met de menuoptie c: Update Gateway Credentials.

Externe interface bijwerken

Wijzig de interface waaraan de connector is gekoppeld en het IP-adres van de connector met behulp van de menuoptie v: View and Modify Cloud Connector Settings.

Proxygegevens bijwerken

Met de menuoptie p: Update Proxy Details kunt u de volgende taken uitvoeren:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Verificatiesleutel voor het updaten van het connectorpakket

Als er zich een technisch probleem voordoet en de ondersteuningstechnicus vraagt om uw pakketverificatiesleutel te vervangen, uploadt u het nieuwe gateway-webex-connectors.gpg -bestand naar bootflash:/gateway_connector/ en gebruikt u de menuoptie k: Update Connector Package Verification Key om te verifiëren.

Het logniveau voor de beheerconnector wijzigen

Wijzig het logniveau voor de connector met behulp van de menuoptie l: Modify log level for Cloud Connector en selecteer vervolgens een van de volgende opties:

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

Uw gateway-instantie beheren:

1. Meld u aan Control Hub.

2. Ga naar SERVICES, klik op Callingen klik vervolgens op Managed Gateways.

3. Klik voor het betreffende gateway-exemplaar op … in de kolom Acties en selecteer de betreffende actie.