Gateway-forbindelser er små applikationer, der kører i gatewayens GuestShell for at opretholde en forbindelse til Control Hub, koordinere hændelser og indsamle statusoplysninger. For mere information om GuestShell, se GuestShell.

Gateway-forbindelserne er installeret på Cisco IOS XE GuestShell-containeren.

Der er to typer stik:

• Administrationsforbindelse

• Telemetri-stik

Et interaktivt menudrevet TCL-script hjælper med at konfigurere GuestShell samt installation og vedligeholdelse af administrationsforbindelsen.

Administrationsforbindelsen håndterer gateway-tilmelding og livscyklusstyring af telemetri-forbindelsen.

Efter vellykket tilmelding downloader og installerer administrationsforbindelsen den nyeste telemetriforbindelse.

Følgende grafik viser, hvordan de forskellige komponenter forbindes i en Webex Calling-løsning:

Som en del af udførelse af TCL-scriptet indsamles følgende oplysninger fra brugeren:

• Ekstern grænseflade

• DNS-serveradresser

• Proxy-oplysninger

• Stikens IP-adresse

• Gateway-legitimationsoplysninger (brugernavn og adgangskode)

TCL-scriptet udfører følgende konfigurationer:

• Virtuel portgruppe – påkrævet til guestshell-konfiguration.

• Gæsteshell

• NETCONF Yang

• SNMP Trap-konfiguration – påkrævet for meddelelser fra Cisco IOS XE.

• IP-rute – Til at dirigere forbindelsesrelateret trafik via en virtuel portgruppe.

TCL-scriptet udfører følgende konfigurationer:

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

Før installation skal du være opmærksom på, at forbindelsesapplikationen ikke kan bruges med følgende:

• Cisco 1100 Integrated Services Router-platforme
• Platforme konfigureret i tilstanden Høj tilgængelighed (HA)
• Platforme konfigureret i Controller-tilstand til SD-WAN-netværk

Overvej følgende, når du konfigurerer din router til brug med et stikprogram:

• iOS XE bruger proxy ARP til at dirigere trafik til gæsteshellen. Konfigurer ikke no ip proxy-arp kommandoen til at deaktivere denne funktion.

• Brug ikke Network Address Translation (NAT) på platforme, der er konfigureret til et Cisco Unified Border Element (CUBE). Konfigurer derfor forbindelsesapplikationen med en routerbar IP-adresse. Det vil sige, den kan ikke dele routerens grænsefladeadresse.

Forbered din enhed til en gateway-tilmelding:

• Adgang til Control Hub som organisationsadministrator

• IP-adresse, brugernavn og adgangskode for de enheder, du vil konfigurere.

• Cisco IOS XE-version:

  • Lokale gateways—Cisco IOS XE Bengaluru 17.6.1a eller nyere

  • Overlevelsesgateways – Cisco IOS XE Dublin 17.12.3 eller nyere

  For de anbefalede versioner, se Cisco Software Research. Søg efter platformen, og vælg en af de Foreslåede udgivelser.

• Systemforudsætninger

  • Minimum ledig hukommelse – 256 MB

  • Minimum diskplads – Den harddisk (SSD), der er tilsluttet den gateway, der bruges til installation af stikket, skal have 2000 MB ledig plads. Bootflash skal også have 50 MB ledig plads. Den bruges til at gemme logfiler og RPM-filer.

    Hvis der ikke er tilsluttet en harddisk til gatewayen, bruges bootflash til installation af forbindelsen. Derefter skal bootflash have 2000 MB ledig plads.

Hvis din routers bootflash er 4 GB, og der er mindre end 2 GB tilgængelig kapacitet (minimumskapaciteten), skal du slette alle binære IOS-aftryk (.bin) undtagen det, der kører i øjeblikket. Frigør ekstra plads, når du har slettet filerne.

Brug følgende trin til at udvide det binære billede og starte fra komponenter:

1. Opret en ny mappe ved hjælp af .mkdir bootflash:/image

2. Udvid det binære IOS-billede ved hjælp af.request platform software package expand file bootflash:/.bin to bootflash:/image

3. I konfigurationstilstand skal du fjerne de aktuelle opstartsindstillinger ved hjælp af.no boot system

4. Konfigurer en ny boot-sætning: boot system bootflash:/image/packages.conf.

5. Afslut konfigurationstilstand, gem konfigurationen, og genstart.

6. Når routeren er genstartet, skal du brugeshow version til at bekræfte, at routeren startede fra bootflash:/image/packages.conf. Hvis det er tilfældet:

   1. Bekræft at mappen bootflash:/sysboot er tom.

   2. Slet det resterende binære IOS-billede.

   3. Slet alle kernebilleder ved hjælp af.delete /f /r bootflash:/core/*

   4. Slet sporingslogfiler ved hjælp af.delete /f /r bootflash:/tracelogs/*

   5. Hvis der stadig ikke er tilstrækkelig diskplads, skal du gennemgå de resterende filer i bootflash: og slet alle andre unødvendige filer såsom logfiler og CDR'er.

• En understøttet Cisco-router, som er forbundet til et netværk med en sti til internettet. Den grundlæggende konfiguration skal have følgende:

  • DNS-serveren er konfigureret til at fortolke offentlige domænenavne.

  • For at konfigurere DNS-serveren skal du bruge følgende kommando:

    • IP-navneserver <IP address>

  • HTTP Proxyserver, hvis du vil have forbindelse til internettet via en proxy.

  • Gateway-legitimationsoplysninger: Stikken kræver lokale legitimationsoplysninger (brugernavn og adgangskode) med adgangsniveau 15 for at få adgang til gatewayen via dens NETCONF-grænseflade.

    For at godkende og autorisere NETCONF-adgang skal du sørge for, at standard-aaa-listerne er konfigureret som illustreret i følgende eksempel. Kun de kommandoer, der er anført i dette dokument, er blevet valideret og understøttes for administrerede gateways. Konfigurationer, der involverer andre metoder (f.eks. TACACS eller ISE), er ikke blevet valideret og understøttes ikke i øjeblikket.

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

  Netværksforudsætninger

  • Stikens IP-adresse skal være i det samme netværk som det, der er valgt til ekstern forbindelse. Det kan være en privat netværksadresse, men den skal have HTTPS-adgang til internettet.

    Hvis du bruger Virtual CUBE på Amazon Web Services (AWS) som din lokale gateway, skal du se Tilknyt en sekundær IP-adresse til Virtual CUBE på AWS for trin til, hvordan du tilknytter en sekundær IP-adresse til brug af connector.

  • Vær forbundet til Control Hub og lokale enheder for at fuldføre tilmeldingsprocessen.

  • URL'er til Webex-tjenester:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportprotokoller: Transport Layer Security (TLS) version 1.2

  • Importer den offentlige IOS-certifikatmyndighedspakke. De certifikater, der føjes til gateway-tillidspuljen, bruges til at bekræfte adgang til Webex-servere. Brug følgende konfigurationskommando til at importere bundtet.

    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: 

Den overordnede status for den forbindelse, der vises i Control Hub, afhænger af tilstanden af telemetri- og administrationsforbindelserne på den administrerede gateway.

Forbindelsestilstande i Control Hub	Beskrivelse
Online	Angiver, at forbindelsen er Forbundet til Cisco Webex Cloud.
Offline	Angiver, at forbindelsen ikke er forbundet til Cisco Webex Cloud.
Sat på pause	Angiver, at stikket er tilsluttet, men er midlertidigt sat på pause.

Lokal administration af administrationsforbindelsen

Du kan bruge Webex Calling med din gateway, når du har installeret forbindelsen. Om nødvendigt kan du opdatere en række forbindelsesindstillinger ved hjælp af de tilgængelige muligheder i scriptmenuen:

Du kan genstarte scriptet når som helst ved hjælp af følgende kommando: 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:

Vis status

Brug menupunktet s: Display Status Page. Systemet viser status for forskellige tilslutningsmoduler.

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

Aktivér gæsteshell

Aktivér cloud-connectoren ved hjælp af menupunktet e: Enable Guestshell. Dette ændrer status for forbindelsen fra INACTIVE til ACTIVE.

Deaktiver Guestshell

Deaktiver cloud-forbindelsen ved hjælp af menupunktet d: Disable Guestshell. Dette ændrer status for forbindelsen fra ACTIVE til INACTIVE.

Afinstaller Connector

Afinstaller cloud-connectoren ved hjælp af menupunktet u: Uninstall Connector. Dette sletter alle data i Guestshell-containeren og fjerner alle konfigurationer, der er relateret til cloud-connectoren.

Indsaml logfiler

Indsaml loggene ved hjælp af menupunktet l: Collect Logs. Systemet viser den placering, hvor disse logfiler er gemt, efter de er indsamlet.

Hvis du har en aktiv supportsag hos Cisco TAC, kan du vedhæfte loggene direkte til din serviceanmodning ved hjælp af kommandoen copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Følgende er en eksempelkommando:

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

Ryd logfiler

Ryd alle logfiler på enheden ved hjælp af menupunktet r: Clear Logs. Dette sletter alle eksisterende logfiler undtagen de seneste logfiler for TCL-scriptet og -forbindelserne.

Vis og rediger Cloud Connector-indstillinger

Foretag følgende ændringer af de eksisterende indstillinger for en cloud-connector ved hjælp af menupunktet 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

Opdater Gateway-legitimationsoplysninger

Opdater brugernavn og adgangskode til gatewayen ved hjælp af menupunktet c: Update Gateway Credentials.

Opdater ekstern grænseflade

Skift den grænseflade, som connectoren er bundet til, og connectorens IP-adresse ved hjælp af menupunktet v: View and Modify Cloud Connector Settings.

Opdater proxyoplysninger

Du kan udføre følgende opgaver ved hjælp af menupunktet 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

Opdater bekræftelsesnøgle for Connector-pakken

Hvis supportteknikeren i tilfælde af et teknisk problem anmoder om at udskifte din pakkebekræftelsesnøgle, skal du uploade den nye gateway-webex-connectors.gpg -fil til bootflash:/gateway_connector/ og bruge menupunktet k: Update Connector Package Verification Key til at bekræfte.

Rediger logniveauet for administrationsforbindelsen

Skift logføringsniveauet for forbindelsen ved hjælp af menupunktet l: Modify log level for Cloud Connector, og vælg derefter en af følgende muligheder:

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

Sådan administrerer du din gateway-instans:

1. Log ind på Control Hub.

2. Gå til TJENESTER, klik på Opkald, og klik derefter på Administrerede gateways.

3. For den relevante gateway-instans skal du klikke på … i kolonnen Handlinger og vælge den relevante handling.