Door uw Cisco IOS-gateways te registreren bij de Control Hub kunt u het apparaatbeheer vereenvoudigen en nieuwe Webex-beldiensten gebruiken. Doordat de gateways verbonden blijven met de Control Hub, kunt u ze, samen met de rest van uw Webex Calling-apparaten, overal beheren en bewaken. Om een gateway te registreren, moet u een beheerconnectorapplicatie installeren en ervoor zorgen dat er een beveiligde verbinding met de Cisco Webex-cloud tot stand is gebracht. Nadat u deze verbinding tot stand hebt gebracht, kunt u de gateway registreren door in te loggen op de Control Hub.

Dit proces is niet van toepassing op Cisco IOS Voice Gateways, zoals de VG400, die volledig als apparaten in de Control Hub worden beheerd.

Een kleine verbindingsapplicatie, de GuestShell genaamd, is verantwoordelijk voor het tot stand brengen en onderhouden van een verbinding tussen de gateway en de Control Hub. De GuestShell- en connectorapplicaties worden geconfigureerd en ingesteld met behulp van een script dat tijdens het registratieproces vanuit de Webex-cloud op de gateway wordt uitgevoerd.

Om het installatieproces te vereenvoudigen, voegt het script een aantal noodzakelijke gateway-configuraties toe.

Gateway-connectoren zijn kleine applicaties die in de gateway GuestShell draaien om een verbinding met de Control Hub te onderhouden, gebeurtenissen te coördineren en statusinformatie te verzamelen. Voor meer informatie over GuestShell, zie GuestShell.

De gateway-connectoren zijn geïnstalleerd op de Cisco IOS XE GuestShell-container.

Er zijn twee soorten connectoren:

• Beheerconnector

• Telemetrieconnector

Een interactief, menugestuurd TCL-script helpt bij het instellen van de GuestShell, evenals bij de installatie en het onderhoud van de beheerconnector.

De beheerconnector verzorgt de gateway-registratie en het levenscyclusbeheer van de telemetrieconnector.

Na een succesvolle registratie downloadt en installeert de beheerconnector de nieuwste telemetrieconnector.

De volgende afbeelding laat zien hoe de verschillende componenten in een Webex Calling-oplossing met elkaar verbonden zijn:

Tijdens de uitvoering van een TCL-script wordt de volgende informatie van de gebruiker verzameld:

• Externe interface

• DNS-serveradressen

• Proxygegevens

• IP-adres van de connector

• Gateway-gegevens (gebruikersnaam en wachtwoord)

Het TCL-script voert de volgende configuraties uit:

• Virtuele poortgroep – vereist voor de configuratie van de gastshell.

• Guestshell

• NETCONF Yang

• SNMP Trap-configuratie—Vereist voor meldingen van Cisco IOS XE.

• IP-routering: 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 connector niet compatibel is met de volgende toepassingen:

• Cisco 1100 Integrated Services Router-platforms
• Platformen geconfigureerd in de modus voor hoge beschikbaarheid (HA).
• Platformen geconfigureerd in controllermodus voor SD-WAN-netwerken

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

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

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

Bereid uw apparaat voor op een gateway-registratie:

• Toegang tot de Control Hub als organisatiebeheerder

• Het IP-adres, de gebruikersnaam en het wachtwoord van de apparaten die u wilt configureren.

• Cisco IOS XE-versie:

  • Lokale gateways: Cisco IOS XE Bengaluru 17.12.3 of hoger

  • Survivability Gateways—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.

• Zorg ervoor dat het apparaat is geconfigureerd met NTP-servergegevens om de systeemklok te synchroniseren met de aangewezen NTP-server.

• 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 minimaal 2000 MB vrije ruimte hebben. Bootflash moet bovendien minimaal 50 MB vrije ruimte hebben. Het wordt gebruikt om de logbestanden en RPM-bestanden op te slaan.

    Als er geen harde schijf op de gateway is aangesloten, wordt bootflash gebruikt voor de installatie van de connector. Bootflash moet vervolgens 2000 MB vrije ruimte hebben.

Als het bootflashgeheugen van uw router 4 GB is en er minder dan 2 GB aan beschikbare capaciteit is (de minimale capaciteit), verwijder dan alle IOS-binaire (.bin) afbeeldingen behalve de afbeelding die momenteel actief is. Nadat je de bestanden hebt verwijderd, maak je extra ruimte vrij.

Volg de onderstaande stappen om de binaire image uit te pakken en op te starten vanaf de componenten:

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

2. Pak de 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 de volgende opdracht.no boot system

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

5. Verlaat de configuratiemodus, sla de configuratie op en herstart het apparaat.

6. Nadat de router opnieuw is opgestart, gebruik jeshow version om te controleren of de router is opgestart vanaf bootflash:/image/packages.conf. Zo ja:

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

   2. Verwijder de resterende IOS-binaire image.

   3. Verwijder alle kernimages met behulp van...delete /f /r bootflash:/core/*

   4. Verwijder traceerlogbestanden 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 cd-roms.

• Een ondersteunde Cisco-router, die is aangesloten op een netwerk met een internetverbinding. De basisconfiguratie moet aan de volgende eisen voldoen:

  • De DNS-server is geconfigureerd om publieke domeinnamen op te lossen.

  • Om de DNS-server te configureren, gebruikt u de volgende opdracht:

    • IP-naamserver <IP address>

  • Een HTTP-proxyserver is handig als u via een proxy toegang tot het internet wilt krijgen.

  • Gateway-gegevens: De connector heeft lokale inloggegevens (gebruikersnaam en wachtwoord) met toegangsrechten op niveau 15 nodig om via de NETCONF-interface toegang te krijgen tot de gateway.

    Om NETCONF-toegang te authenticeren en te autoriseren, moet u ervoor zorgen dat de standaard AAA-lijsten zijn geconfigureerd zoals in het volgende voorbeeld wordt weergegeven. Alleen de in dit document vermelde commando's zijn gevalideerd en worden ondersteund voor beheerde gateways. Configuraties met andere methoden (zoals 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 de externe verbinding. Het mag een privénetwerkadres zijn, maar het moet wel HTTPS-toegang tot het internet hebben.

    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 om een secundair IP-adres te koppelen voor gebruik met de connector.

  • Maak verbinding met de Control Hub en de apparaten op locatie om het registratieproces te voltooien.

  • URL's voor Webex-services:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportprotocollen: Transport Layer Security (TLS) versie 1.2

  • Importeer het pakket met openbare certificeringsinstanties voor iOS. De certificaten die aan de vertrouwenspool van de gateway worden toegevoegd, worden gebruikt om de 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 algehele 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 gepauzeerd is.

Lokale administratie van de beheerconnector

Na een succesvolle installatie van de connector kunt u Webex Calling gebruiken met uw gateway. Indien nodig kunt u een aantal connectorinstellingen bijwerken via de opties in het scriptmenu:

Je 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. Hierdoor verandert de status van de connector van INACTIVE naar ACTIVE.

Schakel Guestshell uit

Schakel de cloudconnector uit via de menuoptie d: Disable Guestshell. Hierdoor 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, evenals alle configuraties die betrekking hebben op de cloudconnector.

Logboeken verzamelen

Verzamel de logbestanden via de menuoptie l: Collect Logs. Het systeem toont de locatie waar deze logbestanden worden opgeslagen nadat ze zijn verzameld.

Als u een actieve supportcase bij Cisco TAC hebt, kunt u de logbestanden rechtstreeks aan uw serviceverzoek toevoegen met behulp van de opdracht copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Hieronder volgt een voorbeeld van een opdracht:

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 via de menuoptie r: Clear Logs. Hiermee worden alle bestaande logbestanden verwijderd, behalve de meest recente logbestanden van het TCL-script en de connectors.

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

U kunt de volgende taken uitvoeren via de menuoptie 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

Update Connector Package Verification Key

In geval van een technisch probleem, als de supportmedewerker vraagt om uw pakketverificatiesleutel te vervangen, uploadt u het nieuwe gateway-webex-connectors.gpg bestand naar bootflash:/gateway_connector/ en gebruikt u de k: Update Connector Package Verification Key menuoptie om te verifiëren.

Wijzig het logniveau voor de beheerconnector.

Wijzig het logniveau voor de connector via 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 
======================================

Om uw gateway-instantie te beheren:

1. Meld u aan Control Hub.

2. Ga naar Diensten > PSTN & Routering > Gateway-configuraties > Gateways beheren

3. Voor de betreffende gateway-instantie klikt u op en selecteert u de gewenste actie.