Gateway-Konnektoren sind kleine Anwendungen, die in der Gateway-GuestShell ausgeführt werden, um eine Verbindung zum Control Hub aufrechtzuerhalten, Ereignisse zu koordinieren und Statusinformationen zu sammeln. 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:

• Verwaltungsconnector

• Telemetrieanschluss

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

Der Verwaltungsconnector kümmert sich um die Gateway-Registrierung und das Lebenszyklusmanagement des Telemetrieconnectors.

Nach erfolgreichem Abschluss der Registrierung lädt der Verwaltungsconnector den neuesten Telemetrieconnector herunter und installiert ihn.

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

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

• Externe Schnittstelle

• DNS-Serveradressen

• Proxy-Details

• Connector-IP-Adresse

• Gateway-Anmeldeinformationen (Benutzername und Passwort)

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

• Virtuelle Portgruppe – Erforderlich für die Gästeshell-Konfiguration.

• Gästehaus

• NETCONF Yang

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

• IP-Route: Zum Weiterleiten von Connector-bezogenem Datenverkehr über die virtuelle Portgruppe.

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

!
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 Folgendem verwendet werden kann:

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

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 den Befehl no ip proxy-arp, 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, die Router-Schnittstellenadresse kann nicht gemeinsam genutzt werden.

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

• Zugriff auf den Control Hub als Organisationsadministrator

• IP-Adresse, Benutzername und Passwort 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

  • Mindestens 256 MB freier Speicher

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

    Wenn keine Festplatte an das Gateway angeschlossen ist, wird Bootflash für die Connector-Installation verwendet. Dann muss der Bootflash über 2000 MB freien Speicherplatz verfügen.

Wenn der Bootflash Ihres Routers 4 GB groß ist und weniger als 2 GB Kapazität (die Mindestkapazität) verfügbar sind, löschen Sie alle IOS-Binärbilder (.bin) mit Ausnahme des aktuell ausgeführten. Geben Sie nach dem Löschen der Dateien zusätzlichen Speicherplatz frei.

Führen Sie die folgenden Schritte aus, um das Binärimage zu erweitern und von Komponenten zu booten:

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

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

3. Entfernen Sie im Konfigurationsmodus die aktuellen Startoptionen mithilfe von.no boot system

4. Konfigurieren Sie eine neue Boot-Anweisung: boot system bootflash:/image/packages.conf.

5. Beenden Sie den Konfigurationsmodus, speichern Sie die Konfiguration und starten Sie neu.

6. Nachdem der Router neu gestartet wurde, überprüfen Sie mitshow version, ob der Router von bootflash:/image/packages.confgebootet wurde. Wenn ja:

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

   2. Löschen Sie das verbleibende IOS-Binärbild.

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

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

   5. Wenn immer noch nicht genügend Speicherplatz vorhanden ist, überprüfen Sie die verbleibenden Dateien im Bootflash: und löschen Sie alle anderen nicht benötigten Dateien wie Protokolle und CDRs.

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

  • Der DNS-Server ist für die Auflösung öffentlicher Domänennamen konfiguriert.

  • Um den DNS-Server zu konfigurieren, verwenden Sie den folgenden Befehl:

    • IP-Nameserver <IP address>

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

  • Gateway-Anmeldeinformationen: Für den Connector sind lokale Anmeldeinformationen (Benutzername und Kennwort) mit Zugriffsberechtigungsstufe 15 erforderlich, um über die NETCONF-Schnittstelle auf das Gateway zugreifen zu können.

    Um den NETCONF-Zugriff zu authentifizieren und zu autorisieren, stellen Sie sicher, dass die Standard-AAA-Listen wie im folgenden Beispiel dargestellt konfiguriert sind. Nur die in diesem Dokument aufgeführten Befehle wurden validiert und werden für Managed Gateways unterstützt. Konfigurationen mit anderen Methoden (z. B. TACACS oder ISE) wurden nicht validiert und werden derzeit nicht unterstützt.

    
    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 Connectors muss sich im selben Netzwerk befinden wie das für die externe Konnektivität gewählte Netzwerk. Es kann sich um eine private Netzwerkadresse handeln, sie muss jedoch über einen HTTPS-Zugriff auf das Internet verfügen.

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

  • Stellen Sie eine Verbindung zum Control Hub und den lokalen Geräten her, um den Registrierungsprozess 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-Zertifizierungsstellenpaket. Die dem Gateway-Vertrauenspool hinzugefügten Zertifikate werden verwendet, um den Zugriff auf Webex-Server zu überprüfen. 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 im Control Hub angezeigten Connectors hängt vom Status der Telemetrie- und Verwaltungs-Connectors auf dem Managed Gateway ab.

Connector-Zustände im Control Hub	Beschreibung
Online	Zeigt an, dass der Connector mit der Cisco Webex-Cloud verbunden ist.
Offline	Zeigt an, dass der Connector Nicht verbunden mit der Cisco Webex-Cloud ist.
Angehalten	Zeigt 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 Connector erfolgreich installiert haben. Bei Bedarf können Sie mithilfe der im Skriptmenü verfügbaren Optionen eine Reihe von Connector-Einstellungen 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 Menüoption s: Display Status Page. Das System zeigt den Status verschiedener Anschlussmodule 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 

Aktivieren Sie Guestshell

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

Gästeshell deaktivieren

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

Connector deinstallieren

Deinstallieren Sie den Cloud Connector über die Menüoption u: Uninstall Connector. Dadurch werden alle Daten im Guestshell-Container gelöscht und alle Konfigurationen entfernt, die mit dem Cloud Connector in Zusammenhang stehen.

Sammeln von Protokollen

Sammeln Sie die Protokolle mit der Menüoption l: Collect Logs. Das System zeigt den Speicherort dieser Protokolle nach dem Sammeln der Protokolle an.

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

Nachfolgend sehen Sie ein Beispiel für einen Befehl:

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 im Gerät mit der Menüoption r: Clear Logs. Dadurch werden alle vorhandenen Protokolle mit Ausnahme der neuesten Protokolle des TCL-Skripts und der Konnektoren gelöscht.

Anzeigen und Ändern der Cloud Connector-Einstellungen

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 Benutzernamen und das Passwort des Gateways mit der Menüoption c: Update Gateway Credentials.

Externe Schnittstelle aktualisieren

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

Proxy-Details aktualisieren

Mit der Menüoption p: Update Proxy Details können Sie die folgenden Aufgaben 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 der Support-Techniker im Falle eines technischen Problems die Ersetzung Ihres Paketüberprüfungsschlüssels anfordert, laden Sie die neue gateway-webex-connectors.gpg -Datei nach bootflash:/gateway_connector/ hoch und verwenden Sie zur Überprüfung die Menüoption k: Update Connector Package Verification Key.

Ändern der Protokollebene für den Management Connector

Ändern Sie die Protokollierungsebene für den Connector mithilfe der Menüoption l: Modify log level for Cloud Connector und wählen Sie dann 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. Gehen Sie zu SERVICES, klicken Sie auf Callingund dann auf Managed Gateways.

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