Gatewayanslutningar är små program som körs i gatewayens GuestShell för att upprätthålla en anslutning till Control Hub, samordna händelser och samla in statusinformation. Mer information om GuestShell finns i GuestShell.

Gatewayanslutningarna är installerade på Cisco IOS XE GuestShell-behållaren.

Det finns två typer av anslutningar:

• Hanteringsanslutning

• Telemetrianslutning

Ett interaktivt menydriven TCL-skript hjälper till att konfigurera GuestShell, samt installation och underhåll av hanteringsanslutningen.

Hanteringsanslutningen sköter gatewayregistreringen och livscykelhanteringen för telemetrianslutningen.

När registreringen har slutförts hämtar och installerar hanteringsanslutningen den senaste telemetrianslutningen.

Följande bild visar hur de olika komponenterna ansluter i en Webex Calling-lösning:

Som en del av TCL-skriptet samlas följande information in från användaren:

• Externt gränssnitt

• DNS-serveradresser

• Proxyuppgifter

• IP-adress för anslutning

• Inloggningsuppgifter för gateway (användarnamn och lösenord)

TCL-skriptet utför följande konfigurationer:

• Virtuell portgrupp – krävs för konfiguration av gästrum.

• Gästrum

• NETCONF Yang

• SNMP Trap-konfiguration – krävs för aviseringar från Cisco IOS XE.

• IP-route – för att dirigera anslutningsrelaterad trafik genom virtuell portgrupp.

TCL-skriptet utför följande 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öre installation bör du tänka på att anslutningsprogrammet inte kan användas med följande:

• Router-plattformar för integrerade tjänster för Cisco 1100
• Plattformar konfigurerade i läget Hög tillgänglighet (HA)
• Plattformar konfigurerade i styrningsläge för SD-WAN-nätverk

Tänk på följande när du konfigurerar din router för användning med ett anslutningsprogram:

• IOS XE använder proxy ARP för att dirigera trafik till gästskalet. Konfigurera inte ingen ip-proxy-arp för att inaktivera den här funktionen.

• Använd inte NAT (Network Address Translation) på plattformar som är konfigurerade för en Cisco Unified Border Element (CUBE). Konfigurera därför anslutningsprogrammet med en dirigerbar IP-adress. Det innebär att den inte kan dela routergränssnittets adress.

Förbered enheten för en gateway-registrering:

• Åtkomst till Control Hub som organisationsadministratör

• IP-adress, användarnamn och lösenord för de enheter som du vill konfigurera.

• Cisco IOS XE-version:

  • Lokala gateways – Cisco IOS XE Bengaluru 17.6.1a eller senare

  • Överlevnadsgateways – Cisco IOS XE Dublin 17.12.3 eller senare

  Se Ciscos programvaruforskning för rekommenderade versioner. Sök efter plattformen och välj en av de Föreslagna versionerna.

• Systemförutsättningar

  • Minsta ledigt minne – 256 MB

  • Minsta diskutrymme – hårddisken (SSD) som är ansluten till gatewayen som används för anslutningsinstallation måste ha 2000 MB ledigt utrymme. Bootflash måste också ha 50 MB ledigt utrymme. Den används för att lagra loggar och RPM-filer.

    Om en hårddisk inte är ansluten till gatewayen används bootflash för installation av anslutningar. Då måste bootflash ha 2000 MB ledigt utrymme.

Om startflänsen på din router är 4 GB och det finns mindre än 2 GB tillgänglig kapacitet (minsta kapacitet) ska du ta bort alla IOS-binära (.bin) bilder förutom den som för närvarande körs. Frigör extra utrymme när du har tagit bort filerna.

Använd följande steg för att expandera den binära bilden och starta från komponenter:

1. Skapa en ny katalog med mkdir bootflash:/image.

2. Expandera den binära IOS-bilden med request platform software package expand file bootflash:/.bin to bootflash:/image.

3. I konfigurationsläget tar du bort de aktuella startalternativen med no boot system.

4. Konfigurera en ny startsats: boot system bootflash:/image/packages.conf.

5. Avsluta konfigurationsläget, spara konfigurationen och starta om.

6. När routern har startat om använder du show version för att verifiera att routern har startats från bootflash:/image/packages.conf. Om så är fallet:

   1. Kontrollera att bootflash:/sysboot katalogen är tom.

   2. Ta bort den återstående binära IOS-bilden.

   3. Ta bort alla kärnbilder med delete /f /r bootflash:/core/*.

   4. Ta bort spårningsloggfiler med delete /f /r bootflash:/tracelogs/*.

   5. Om det fortfarande inte finns tillräckligt med diskutrymme kan du granska de återstående filerna i bootflash: och ta bort alla andra icke nödvändiga filer, t.ex. loggar och CDR:er.

• En Cisco-router som stöds och är ansluten till ett nätverk med en sökväg till internet. Den grundläggande konfigurationen måste ha följande:

  • DNS-servern är konfigurerad för att lösa offentliga domännamn.

  • Använd följande kommando för att konfigurera DNS-servern:

    • IP-namnserver <IP address>

  • HTTP-proxyserver om du vill nå internet via en proxy.

  • Inloggningsuppgifter för gateway: Autentiseringsuppgifter (användarnamn och lösenord) med privilegienivå 15-åtkomst som anslutningen kan använda för att komma åt gatewayen via dess NETCONF-gränssnitt.

    För att autentisera och auktorisera NETCONF-åtkomst ska du se till att standardlistorna för aaa är konfigurerade enligt exemplet. Du kan använda valfritt metodalternativ i standardlistan. Du kan inte använda en namngiven aaa-lista för att styra NETCONF-åtkomst. Om standardlistorna inte är korrekt konfigurerade kan du se felmeddelandet ”Ogiltig metodlista” i systemloggen.

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

  Nätverkskrav

  • Anslutningens IP-adress måste vara i samma nätverk som det som har valts för extern anslutning. Den kan vara en privat nätverksadress, men den måste ha HTTPS-åtkomst till internet.

    Om du använder virtuell CUBE på Amazon Web Services (AWS) som din lokala gateway, se Associera en sekundär IP-adress för virtuell CUBE på AWS för steg om hur du associerar en sekundär IP-adress för anslutningsanvändning.

  • Anslut till Control Hub och lokala enheter för att slutföra inskrivningsprocessen.

  • URL:er till Webex-tjänster:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportprotokoll: Transport Layer Security (TLS) version 1.2

  • Importera det offentliga IOS-certifikatutfärdarpaketet. Certifikaten som lagts till i gatewayens förtroendepool används för att verifiera åtkomsten till Webex-servrar. Använd följande konfigurationskommandon för att importera paketet.

    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 övergripande statusen för anslutningen som visas i Control Hub beror på statusen för telemetri- och hanteringsanslutningarna på den hanterade gatewayen.

Anslutningsstatus i Control Hub	Beskrivning
Online	Anger att anslutningen är Ansluten till Cisco Webex-molnet.
Offline	Anger att anslutningen Inte är ansluten till Cisco Webex-molnet.
Pausad	Anger att anslutningen är ansluten men är Pausad tillfälligt.

Lokal administration av hanteringsanslutningen

Du kan använda Webex Calling med din gateway när anslutningen har installerats. Vid behov kan du uppdatera ett antal anslutningsinställningar med alternativen som finns i skriptmenyn:

Du kan starta om skriptet när som helst med följande 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:

Visningsstatus

Använd s: Display Status Page menyalternativet. Systemet visar status för olika anslutningsmoduler.

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

Aktivera gästskal

Aktivera molnanslutningen med hjälp av menyalternativet e: Enable Guestshell . Detta ändrar anslutningens status från INACTIVE till ACTIVE.

Inaktivera gästskal

Inaktivera molnanslutningen med hjälp av menyalternativet d: Disable Guestshell . Detta ändrar anslutningens status från ACTIVE till INACTIVE.

Avinstallera anslutning

Avinstallera molnanslutningen med hjälp av menyalternativet u: Uninstall Connector . Detta raderar alla data i Guestshell-behållaren och tar bort alla konfigurationer som är relaterade till molnanslutningen.

Samla in loggar

Samla in loggarna med hjälp av l: Collect Logs menyalternativet. Systemet visar platsen där loggarna lagras efter att loggarna har samlats in.

Om du har ett aktivt supportärende med Cisco TAC kan du bifoga loggarna direkt till din serviceförfrågan med kommandot copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Följande är ett exempelkommando:

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

Rensa loggar

Rensa alla loggfiler på enheten med hjälp av menyalternativet r: Clear Logs . Detta raderar alla befintliga loggar förutom de senaste loggarna i TCL-skriptet och -anslutningarna.

Visa och ändra inställningar för molnanslutning

Gör följande ändringar i befintliga inställningar för en molnanslutning med hjälp av menyalternativet 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

Uppdatera inloggningsuppgifter för gateway

Uppdatera gatewayens användarnamn och lösenord med hjälp av menyalternativet c: Update Gateway Credentials .

Uppdatera externt gränssnitt

Ändra gränssnittet som anslutningen är bunden till och anslutningens IP-adress med hjälp av menyalternativet v: View and Modify Cloud Connector Settings .

Uppdatera proxyinformation

Du kan utföra följande uppgifter med hjälp av p: Update Proxy Details menyalternativet:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Uppdatera verifieringsnyckel för anslutningspaket

I händelse av ett tekniskt problem om supportteknikern begär ersättning av din paketverifieringsnyckel ska du ladda upp den nya gateway-webex-connectors.gpg filen till bootflash:/gateway_connector/ och använda k: Update Connector Package Verification Key menyalternativet för att verifiera.

Ändra loggnivån för hanteringsanslutningen

Ändra loggningsnivån för anslutningen med hjälp av menyalternativet l: Modify log level for Cloud Connector och välj sedan ett av följande alternativ:

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

Så här hanterar du gateway-instansen:

1. Logga in på Control Hub.

2. Gå till TJÄNSTER, klicka på Samtal och klicka sedan på Hanterade gateways.

3. För tillämplig gateway-instans klickar du på i kolumnen Åtgärder och väljer tillämplig åtgärd.