Door Cisco IOS beheerde gateways inschrijven voor Webex Cloud

Gateway-connectors zijn kleine toepassingen die worden uitgevoerd in de gateway GuestShell om de verbinding met de Control Hub te behouden, gebeurtenissen te coördineren en statusinformatie te verzamelen. Zie GuestShell voor meer informatie over GuestShell.

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

Er zijn twee typen connectors:

• Beheerconnector

• Telemetrieconnector

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

De beheerconnector zorgt voor het gatewayinschrijving en het levenscyclusbeheer van de telemetrieconnector.

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

De volgende afbeelding toont hoe de verschillende onderdelen verbinding maken in een Webex Calling-oplossing:

Als onderdeel van het uitvoeren van het TCL-script wordt de volgende informatie van de gebruiker verzameld:

• Externe interface

• DNS-serveradressen

• Proxygegevens

• IP-adres connector

• Gateway-aanmeldgegevens (gebruikersnaam en wachtwoord)

Het TCL-script voert de volgende configuraties uit:

• Virtuele poortgroep: vereist voor guestshell-configuratie.

• Guestshell

• NETCONF Yang

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

• IP-route: naar het routeren van connectorgerelateerd verkeer via de virtuele poortgroep.

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 geïntegreerde servicerouterplatforms
• Platformen die in de modus met hoge beschikbaarheid (HA) zijn geconfigureerd
• Platforms die in de controllermodus zijn geconfigureerd voor SD-WAN-netwerken

Houd rekening met het volgende bij het configureren van uw router voor gebruik met een connectortoepassing:

• IOS XE gebruikt proxy-ARP om verkeer naar de gastshell te routeren. Configureer geen IP-proxy-arp-comand om deze functie uit te schakelen.

• Gebruik geen NAT (Network Address Translation) 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 adres van de routerinterface niet kan worden gedeeld.

Bereid uw apparaat voor op een gatewayinschrijving:

• 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

  • Survivabilitygateways: Cisco IOS XE Dublin 17.12.3 of hoger

  Zie Cisco Software Research voor de aanbevolen versies. Zoek naar het platform en selecteer een van de Voorgestelde releases.

• Systeemvereisten

  • Minimaal vrij geheugen: 256 MB

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

    Als een harde schijf niet aan de gateway is gekoppeld, wordt bootflash gebruikt voor de installatie van de connector. Bootflash moet dan 2000 MB vrije ruimte hebben.

Als de bootflash van uw router 4 GB is en er minder dan 2 GB beschikbare capaciteit (de minimale capaciteit) is, verwijdert u alle binaire IOS-afbeeldingen (.bin), behalve de afbeelding die momenteel wordt uitgevoerd. Maak extra ruimte vrij nadat u de bestanden hebt verwijderd.

Gebruik de volgende stappen om de binaire afbeelding uit te breiden en de componenten op te starten:

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

2. Vouw de binaire IOS-afbeelding uit met request platform software package expand file bootflash:/.bin to bootflash:/image.

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

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

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

6. Nadat de router opnieuw is opgestart, gebruikt u show version om te controleren of de router is opgestart vanuit bootflash:/image/packages.conf. Zo ja:

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

   2. Verwijder de resterende binaire IOS-afbeelding.

   3. Verwijder alle kernafbeeldingen met delete /f /r bootflash:/core/*.

   4. Verwijder traceerlogbestanden met delete /f /r bootflash:/tracelogs/*.

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

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

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

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

    • ip naam-server <IP address>

  • HTTP-proxyserver als u het internet wilt bereiken via een proxy.

  • Gateway-aanmeldgegevens: Een lokale referentie (gebruikersnaam en wachtwoord) met toegang tot privilege niveau 15 is vereist door de connector voor toegang tot de gateway via de NETCONF-interface.

    Als u NETCONF-toegang wilt verifiëren en autoriseren, moet u ervoor zorgen dat de standaard AAA-lijsten zijn geconfigureerd zoals weergegeven in het voorbeeld. U kunt een benoemde AAA-lijst niet gebruiken om NETCONF-toegang te beheren. Als de standaardlijsten niet juist zijn geconfigureerd, ziet u mogelijk een foutbericht 'lijst met ongeldige methoden' in het systeemlogboek. U wilt mogelijk andere methoden gebruiken samen met de lokale methoden voor AAA. Dit kan echter worden bereikt, maar een specifieke configuratie-update is vereist.

    
    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. Het kan een privénetwerkadres zijn, maar het moet HTTPS-toegang hebben tot internet.

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

  • U moet verbonden zijn met de Control Hub en apparaten op locatie om het inschrijvingsproces te voltooien.

  • URL's voor Webex-services:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportprotocollen: TLS (Transport Layer Security) versie 1.2

  • Importeer de bundel met openbare IOS-certificeringsinstanties. De certificaten die zijn toegevoegd aan de gateway trust pool 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 algemene status van de connector die in de Control Hub wordt weergegeven, is afhankelijk van de status van de telemetrie- en beheerconnectors op de beheerde gateway.

Connectorstatussen in 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 verbonden, maar tijdelijk is onderbroken .

Lokaal beheer van de Management Connector

U kunt Webex Calling gebruiken met uw gateway nadat u de connector hebt geïnstalleerd. 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 met de menuoptie e: Enable Guestshell . Hiermee wijzigt u de status van de connector van INACTIVE naar ACTIVE.

Guestshell uitschakelen

Schakel de cloudconnector uit met de menuoptie d: Disable Guestshell . Hiermee wijzigt u de status van de connector van ACTIVE naar INACTIVE.

Connector verwijderen

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

Logboeken verzamelen

Verzamel de logboeken met de l: Collect Logs menuoptie. Het systeem geeft de locatie weer waar deze logboeken worden opgeslagen nadat de logboeken zijn verzameld.

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

Hier 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, met uitzondering van de nieuwste logboeken van het TCL-script en connectors.

Instellingen voor cloudconnector weergeven en wijzigen

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

Gatewayaanmeldgegevens bijwerken

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

Externe interface bijwerken

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

Proxygegevens bijwerken

U kunt de volgende taken uitvoeren met de p: Update Proxy Details menuoptie:

• 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 van connectorpakket bijwerken

Als de support engineer in het geval van een technisch probleem 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.

Het logboekniveau voor de beheerconnector wijzigen

Wijzig het registratieniveau voor de connector met 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 gatewayexemplaar beheren:

1. Meld u aan Control Hub.

2. Ga naar SERVICES, klik op Bellen en klik vervolgens op Beheerde gateways.

3. Klik voor het toepasselijke gatewayexemplaar op ... in de kolom Acties en selecteer de toepasselijke actie.