Gateway-kopplingar är små program som körs i gatewayens GuestShell för att upprätthålla en anslutning till Control Hub, koordinera händelser och samla in statusinformation. För mer information om GuestShell, se GuestShell.

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

Det finns två typer av kontakter:

• Hanteringsanslutning

• Telemetri-kontakt

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

Hanteringsanslutningen hanterar gateway-registrering och livscykelhantering för telemetri-anslutningen.

När registreringen har slutförts laddar och installerar hanteringsanslutningen den senaste telemetri-anslutningen.

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

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

• Externt gränssnitt

• DNS-serveradresser

• Proxy-detaljer

• Anslutningens IP-adress

• Gateway-inloggningsuppgifter (användarnamn och lösenord)

TCL-skriptet utför följande konfigurationer:

• Virtuell portgrupp – Krävs för guestshell-konfiguration.

• Gästskal

• NETCONF Yang

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

• IP-rutt – För att dirigera anslutningsrelaterad trafik via en 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
!
 

Innan installationen, tänk på att kopplingsprogrammet inte kan användas med följande:

• Cisco 1100 Integrated Services Router-plattformar
• Plattformar konfigurerade i läget för hög tillgänglighet (HA)
• Plattformar konfigurerade i Controller-läge för SD-WAN-nätverk

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

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

• Använd inte Network Address Translation (NAT) på plattformar som är konfigurerade för en Cisco Unified Border Element (CUBE). Konfigurera därför kopplingsprogrammet med en routbar IP-adress. Det vill säga, den kan inte dela routerns gränssnittsadress.

Förbered din enhet 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

  För rekommenderade versioner, se Cisco Software Research. Sök efter plattformen och välj en av de Föreslagna utgåvorna.

• Systemförutsättningar

  • Minsta lediga minne – 256 MB

  • Minsta diskutrymme – Hårddisken (SSD) som är ansluten till gatewayen som används för installation av kontakten 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 kontakten. Sedan måste bootflash ha 2000 MB ledigt utrymme.

Om din routers bootflash är 4 GB och det finns mindre än 2 GB tillgänglig kapacitet (minimikapaciteten), radera alla binära IOS-avbildningar (.bin) förutom den som körs för närvarande. Frigör extra utrymme när du har tagit bort filerna.

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

1. Skapa en ny katalog med hjälp av.mkdir bootflash:/image

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

3. I konfigurationsläge, ta bort de aktuella startalternativen med hjälp av.no boot system

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

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

6. När routern har startats om, användshow version för att verifiera att routern startade från bootflash:/image/packages.conf. Om så är fallet:

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

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

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

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

   5. Om det fortfarande inte finns tillräckligt med diskutrymme, granska de återstående filerna i bootflash: och ta bort alla andra onödiga filer, såsom loggar och CDR:er.

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

  • DNS-servern är konfigurerad för att matcha publika domännamn.

  • För att konfigurera DNS-servern, använd följande kommando:

    • IP-namnserver <IP address>

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

  • Gateway-inloggningsuppgifter: En lokal autentiseringsuppgift (användarnamn och lösenord) med behörighetsnivå 15 krävs av anslutningsenheten för att komma åt gatewayen via dess NETCONF-gränssnitt.

    För att autentisera och auktorisera NETCONF-åtkomst, se till att standard-aaa-listorna är konfigurerade enligt följande exempel. Endast de kommandon som listas i det här dokumentet har validerats och stöds för hanterade gateways. Konfigurationer som involverar andra metoder (till exempel TACACS eller ISE) har inte validerats och stöds för närvarande inte.

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

  Nätverksförutsättningar

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

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

  • Var ansluten till Control Hub och lokala enheter för att slutföra registreringsprocessen.

  • URL:er för Webex-tjänster:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportprotokoll: Transport Layer Security (TLS) version 1.2

  • Importera det offentliga certifikatutfärdarpaketet för IOS. Certifikaten som läggs till i gateway-förtroendepoolen används för att verifiera åtkomst till Webex-servrar. Använd följande konfigurationskommando 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å tillståndet för telemetri- och hanteringsanslutningarna på den hanterade gatewayen.

Anslutningstillstånd i Control Hub	Beskrivning
Online	Indikerar att anslutningen är Ansluten till Cisco Webex-molnet.
Offline	Indikerar att anslutningen är Inte ansluten till Cisco Webex-molnet.
Pausad	Indikerar att kontakten är ansluten men är tillfälligt pausad.

Lokal administration av hanteringsanslutningen

Du kan använda Webex Calling med din gateway efter att du har installerat anslutningen. Om det behövs kan du uppdatera ett antal kopplingsinställningar med hjälp av 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:

Visa status

Använd menyalternativet s: Display Status Page. Systemet visar statusen 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ästshell

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

Inaktivera gästshell

Inaktivera molnanslutningen med menyalternativet d: Disable Guestshell. Detta ändrar kopplingens status från ACTIVE till INACTIVE.

Avinstallera kopplingen

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

Samla in loggar

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

Om du har ett aktivt supportärende hos 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 i enheten med hjälp av menyalternativet r: Clear Logs. Detta tar bort alla befintliga loggar förutom de senaste loggarna för TCL-skriptet och anslutningarna.

Visa och ändra inställningar för molnanslutning

Gör följande ändringar i de befintliga inställningarna 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 Gateway-autentiseringsuppgifter

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

Uppdatera externt gränssnitt

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

Uppdatera proxyuppgifter

Du kan utföra följande uppgifter med hjälp av menyalternativet 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

Uppdatera verifieringsnyckel för anslutningspaket

Om supportteknikern vid tekniska problem begär att ersätta er paketverifieringsnyckel, ladda upp den nya gateway-webex-connectors.gpg -filen till bootflash:/gateway_connector/ och använd menyalternativet k: Update Connector Package Verification Key för att verifiera.

Ändra loggnivån för hanteringsanslutningen

Ändra loggningsnivån för kopplingen 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 din gateway-instans:

1. Logga in på Control Hub.

2. Gå till TJÄNSTER, klicka på Samtaloch 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.