Gateway-Konnektoren sind kleine Anwendungen, die im Gateway-GuestShell ausgeführt werden, um eine Verbindung zum Control Hub aufrechtzuerhalten, Ereignisse zu koordinieren und Statusinformationen zu erfassen. Weitere Informationen zu GuestShell finden Sie unter GuestShell.

Die Gateway-Konnektoren werden auf dem Cisco IOS XE GuestShell-Container installiert.

Es gibt zwei Arten von Anschlüssen:

• Management-Konnektor

• Telemetrie-Konnektor

Ein interaktives menügesteuertes TCL-Skript hilft beim Einrichten der GuestShell sowie bei der Installation und Wartung des Management Connectors.

Der Management Connector übernimmt die Gateway-Anmeldung und die Lebenszyklusverwaltung des Telemetrie-Connectors.

Nach dem erfolgreichen Abschluss der Registrierung lädt der Management Connector den aktuellen Telemetrie-Connector herunter und installiert ihn.

Die folgende Abbildung zeigt, wie die verschiedenen Komponenten in einer Webex Calling-Lösung verbunden sind:

Im Rahmen der Ausführung des TCL-Skripts werden folgende Informationen vom Benutzer erfasst:

• Externe Schnittstelle

• DNS-Serveradressen

• Proxy-Details

• IP-Adresse des Konnektors

• Gateway-Anmeldeinformationen (Benutzername und Kennwort)

Das TCL-Skript führt die folgenden Konfigurationen aus:

• Virtual Port Group (virtuelle Portgruppe): Erforderlich für die Konfiguration der guestshell.

• Gastmuschel

• NETCONF Yang

• SNMP-Trap-Konfiguration: Erforderlich für Benachrichtigungen von Cisco IOS XE.

• IP-Route: Um den Connector-bezogenen Datenverkehr durch die virtuelle Portgruppe weiterzuleiten.

Das TCL-Skript führt die folgenden Konfigurationen aus:

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

Beachten Sie vor der Installation, dass die Connector-Anwendung nicht mit den folgenden Komponenten verwendet werden kann:

• Cisco 1100 Integrated Services Router-Plattformen
• Im Hochverfügbarkeitsmodus (HA) konfigurierte Plattformen
• Im Controller-Modus konfigurierte Plattformen für SD-WAN-Netzwerke

Beachten Sie Folgendes, wenn Sie Ihren Router für die Verwendung mit einer Connector-Anwendung konfigurieren:

• IOS XE verwendet Proxy-ARP, um den Datenverkehr an die Gast-Shell weiterzuleiten. Konfigurieren Sie nicht no ip proxy-arp comand, um diese Funktion zu deaktivieren.

• Verwenden Sie Network Address Translation (NAT) nicht auf Plattformen, die für ein Cisco Unified Border Element (CUBE) konfiguriert sind. Konfigurieren Sie daher die Connector-Anwendung mit einer routingfähigen IP-Adresse. Das heißt, es kann die Adresse der Routerschnittstelle nicht teilen.

Bereiten Sie Ihr Gerät für eine Gateway-Anmeldung vor:

• Auf den Control Hub als Organisationsadministrator zugreifen

• IP-Adresse, Benutzername und Kennwort für die Geräte, die Sie konfigurieren möchten.

• Cisco IOS XE-Version:

  • Lokale Gateways – Cisco IOS XE Bengaluru 17.6.1a oder höher

  • Survivability Gateways – Cisco IOS XE Dublin 17.12.3 oder höher

  Die empfohlenen Versionen finden Sie unter Cisco Software Research. Suchen Sie nach der Plattform und wählen Sie eine der vorgeschlagenen Versionen aus.

• Systemvoraussetzungen

  • Minimaler freier Speicher: 256 MB

  • Minimaler Festplattenspeicher: Die Festplatte (SSD), die am Gateway angeschlossen ist und für die Connector-Installation verwendet wird, muss 2000 MB freien Speicherplatz haben. Außerdem muss Bootflash über 50 MB freien Speicherplatz verfügen. Es wird zum Speichern der Protokolle und RPM-Dateien verwendet.

    Wenn eine Festplatte nicht an das Gateway angeschlossen ist, wird Bootflash für die Connector-Installation verwendet. Dann muss Bootflash 2000 MB freien Speicherplatz haben.

Wenn der Bootflash Ihres Routers 4 GB beträgt und es weniger als 2 GB an verfügbarer Kapazität gibt (die minimale Kapazität), löschen Sie alle IOS-Binärbilder (.bin) mit Ausnahme des aktuell ausgeführten Bildes. Geben Sie nach dem Löschen der Dateien mehr Platz frei.

Führen Sie die folgenden Schritte aus, um das Binärbild und den Start aus Komponenten zu erweitern:

1. Erstellen Sie ein neues Verzeichnis mit mkdir bootflash:/image.

2. Erweitern Sie das IOS-Binärbild mit request platform software package expand file bootflash:/.bin to bootflash:/image.

3. Entfernen Sie im Konfigurationsmodus die aktuellen Boot-Optionen mithilfe von no boot system.

4. Neue Boot-Anweisung konfigurieren: boot system bootflash:/image/packages.conf.

5. Verlassen Sie den Konfigurationsmodus, speichern Sie die Konfiguration und starten Sie einen Neustart.

6. Nachdem der Router neu gestartet wurde, verwenden Sie show version , um zu überprüfen, ob der Router von bootflash:/image/packages.conf gestartet wurde. Wenn ja:

   1. Stellen Sie sicher, dass das bootflash:/sysboot Verzeichnis leer ist.

   2. Lösche das verbleibende IOS-Binärimage.

   3. Löschen Sie alle Kernbilder mit delete /f /r bootflash:/core/*.

   4. Löschen Sie Trace-Protokolldateien mithilfe von delete /f /r bootflash:/tracelogs/*.

   5. Wenn noch nicht genügend Speicherplatz vorhanden ist, überprüfen Sie die restlichen Dateien in Bootflash: und löschen Sie alle anderen nicht unbedingt notwendigen Dateien wie Protokolle und CDRs.

• Ein unterstützter Cisco-Router, der mit einem Netzwerk mit einem Pfad zum Internet verbunden ist. Die Basiskonfiguration muss Folgendes aufweisen:

  • Der DNS-Server ist so konfiguriert, dass er öffentliche Domänennamen auflöst.

  • Verwenden Sie zum Konfigurieren des DNS-Servers den folgenden Befehl:

    • IP-Name-Server <IP address>

  • HTTP-Proxyserver, wenn Sie über einen Proxy auf das Internet zugreifen möchten.

  • Gateway-Anmeldeinformationen: Der Connector benötigt lokale Anmeldeinformationen (Benutzername und Kennwort) mit Zugriff auf die Berechtigungsebene 15, um über die NETCONF-Schnittstelle auf das Gateway zuzugreifen.

    Um den NETCONF-Zugriff zu authentifizieren und zu autorisieren, stellen Sie sicher, dass die Standard-aaa-Listen wie im Beispiel dargestellt konfiguriert sind. Sie können keine benannte aaa-Liste verwenden, um den NETCONF-Zugriff zu steuern. Wenn die Standardlisten nicht korrekt konfiguriert sind, wird Ihnen möglicherweise die Fehlermeldung „Ungültige Methodenliste“ im Systemprotokoll angezeigt. Möglicherweise möchten Sie andere Methoden zusammen mit lokalen für AAA verwenden, dies kann erreicht werden, jedoch ist eine spezifische Konfigurationsaktualisierung erforderlich.

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

  Netzwerkvoraussetzungen

  • Die IP-Adresse des Konnektors muss sich im selben Netzwerk befinden, das für die externe Konnektivität ausgewählt wurde. Es kann sich um eine private Netzwerkadresse handeln, muss jedoch über einen HTTPS-Zugriff auf das Internet verfügen.

    Wenn Sie Virtual CUBE auf Amazon Web Services (AWS) als lokales Gateway verwenden, finden Sie die Schritte zum Zuordnen einer sekundären IP-Adresse für Connector unter Zuordnen einer sekundären IP-Adresse für Virtual CUBE auf AWS .

  • Mit dem Control Hub und lokalen Geräten verbunden sein, um die Registrierung abzuschließen.

  • URLs für Webex-Dienste:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportprotokolle: Transport Layer Security (TLS) Version 1.2

  • Importieren Sie das öffentliche IOS-Zertifikatsbehördenpaket. Die zum Gateway-Vertrauenspool hinzugefügten Zertifikate werden verwendet, um den Zugriff auf Webex-Server zu verifizieren. Verwenden Sie den folgenden Konfigurationsbefehl, um das Paket zu importieren.

    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: 

Der Gesamtstatus des Konnektors, der in Control Hub angezeigt wird, hängt vom Status der Telemetrie- und Verwaltungskonnektoren auf dem verwalteten Gateway ab.

Connector-Status im Control Hub	Beschreibung
Online	Gibt an, dass der Connector mit der Cisco Webex Cloud verbunden ist.
Offline	Gibt an, dass der Connector nicht mit der Cisco Webex Cloud verbunden ist.
Angehalten	Gibt an, dass der Connector verbunden ist, aber vorübergehend angehalten ist.

Lokale Administration des Management Connectors

Sie können Webex Calling mit Ihrem Gateway verwenden, nachdem Sie den Konnektor erfolgreich installiert haben. Bei Bedarf können Sie eine Reihe von Connector-Einstellungen mithilfe der im Skriptmenü verfügbaren Optionen aktualisieren:

Sie können das Skript jederzeit mit dem folgenden Befehl neu starten: 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:

Anzeigestatus

Verwenden Sie die s: Display Status Page Menüoption. Das System zeigt den Status der verschiedenen Connector-Module an.

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

Aktivieren Sie den Cloud-Connector über die e: Enable Guestshell -Menüoption. Dadurch wird der Status des Connectors von INACTIVE in ACTIVE geändert.

Gästeshell deaktivieren

Deaktivieren Sie den Cloud-Connector über die d: Disable Guestshell -Menüoption. Dadurch wird der Status des Connectors von ACTIVE in INACTIVE geändert.

Konnektor deinstallieren

Deinstallieren Sie den Cloud-Connector über die u: Uninstall Connector -Menüoption. Damit werden alle Daten im Guestshell-Container gelöscht und alle Konfigurationen für den Cloud-Connector entfernt.

Sammeln von Protokollen

Erfassen Sie die Protokolle mithilfe der l: Collect Logs Menüoption. Das System zeigt den Speicherort an, an dem diese Protokolle nach dem Sammeln der Protokolle gespeichert werden.

Wenn Sie einen aktiven Supportfall bei Cisco TAC haben, können Sie die Protokolle mit dem Befehl copy bootflash:/guest-share/ scp://:@cxd.cisco.com direkt an Ihre Serviceanfrage anhängen.

Es folgt ein Beispielbefehl:

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

Protokolle löschen

Löschen Sie alle Protokolldateien auf dem Gerät mit der r: Clear Logs Menüoption. Damit werden alle vorhandenen Protokolle mit Ausnahme der letzten Protokolle des TCL-Skripts und der Konnektoren gelöscht.

Cloud Connector-Einstellungen anzeigen und ändern

Nehmen Sie über die Menüoption v: View and Modify Cloud Connector Settings die folgenden Änderungen an den vorhandenen Einstellungen eines Cloud-Connectors vor.

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

Aktualisieren Sie den Gateway-Benutzernamen und das Passwort über die c: Update Gateway Credentials Menüoption.

Externe Schnittstelle aktualisieren

Ändern Sie mithilfe der Menüoption v: View and Modify Cloud Connector Settings die Schnittstelle, an die der Connector gebunden ist, und die IP-Adresse des Connectors.

Proxydetails aktualisieren

Sie können die folgenden Aufgaben mit der p: Update Proxy Details Menüoption ausführen:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Verifizierungsschlüssel für Connector-Paket aktualisieren

Wenn ein technisches Problem auftritt, wenn der Support-Techniker Ihren Paketverifizierungsschlüssel ersetzen möchte, laden Sie die neue gateway-webex-connectors.gpg Datei in bootflash:/gateway_connector/ hoch und verwenden Sie zum Überprüfen die k: Update Connector Package Verification Key Menüoption.

Ändern der Protokollebene für den Management Connector

Ändern Sie die Protokollierungsstufe für den Connector mithilfe der Menüoption l: Modify log level for Cloud Connector , und wählen Sie eine der folgenden Optionen aus:

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

So verwalten Sie Ihre Gateway-Instanz:

1. Melden Sie sich bei Control Hub an.

2. Wechseln Sie zu DIENSTE, klicken Sie auf Anrufe und anschließend auf Verwaltete Gateways.

3. Klicken Sie für die entsprechende Gateway-Instanz auf … in der Spalte Aktionen , und wählen Sie die entsprechende Aktion aus.