Gateway-kontakter er små programmer som kjører i gatewayen GuestShell for å opprettholde tilkobling til Control Hub, koordinere hendelser og samle inn statusinformasjon. For mer informasjon om GuestShell, se GuestShell.

Gateway-kontaktene er installert på Cisco IOS XE GuestShell-beholderen.

Det finnes to typer kontakter:

• Kontakt for administrasjon

• Telemetrikontakt

Et interaktivt menydrevet TCL-skript bidrar til å konfigurere GuestShell, samt installasjon og vedlikehold av administrasjonskontakten.

Administrasjonskontakten tar seg av gateway-registrering og livssyklusadministrasjon av telemetrikontakten.

Etter vellykket fullføring av registreringen laster administrasjonskontakten ned og installerer den nyeste telemetrikontakten.

Følgende grafikk viser hvordan de forskjellige komponentene kobles til i en Webex Calling-løsning:

Som en del av TCL skriptkjøringen blir følgende informasjon samlet inn fra brukeren:

• Eksternt grensesnitt

• DNS-serveradresser

• Proxy-detaljer

• Kontaktens IP-adresse

• Gateway-legitimasjon (brukernavn og passord)

TCL-skriptet utfører følgende konfigurasjoner:

• Virtuell portgruppe – kreves for konfigurasjon av gjesteskal.

• Gjesteskal

• NETCONF Yang

• SNMP Trap-konfigurasjon – kreves for varsler fra Cisco IOS XE.

• IP-rute – For å rute koblingsrelatert trafikk gjennom virtuell portgruppe.

TCL-skriptet utfører følgende konfigurasjoner:

! grensesnitt VirtualPortGroup 0 ip unummerert GigabitEthernet1 ingen mop aktivert ingen mop sysid ! ! app-hosting appid guestshell app-vnic gateway0 virtualportgroup 0 gjest-grensesnitt 0 gjest-ipaddress 10.65.125.227 netmask 255.255.255.128 app-default-gateway 10.65.125.142 gjest-grensesnitt 0 app-resource profile egendefinert CPU 800 MINNE 256 persistent-disk 500 navn-server0 72.163.128.140 navn-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 nødsituasjoner logging snmp-trap varsler logging snmp-trap kritisk logging snmp-trap feil logging snmp-trap varsler logging snmp-trap varsler ! ! snmp-serverfellesskapet Gateway-Webex-Cloud RO snmp-server aktiver trapper syslog snmp-server manager ! ! ip-rute 10.65.125.227 255.255.255.255 VirtualPortGroup0 ! 

Før installasjonen må du være oppmerksom på at koblingsapplikasjonen ikke kan brukes med følgende:

• Cisco 1100 Integrated Services Router-plattformer
• Plattformer konfigurert i modus for høy tilgjengelighet (HA)
• Plattformer konfigurert i kontrollmodus for SD-WAN-nettverk

Vurder følgende når du konfigurerer ruteren for bruk med et tilkoblingsprogram:

• IOS XE bruker proxy-ARP til å rute trafikk til gjesteskallet. Ikke konfigurer ingen ip proxy-arp comand for å deaktivere denne funksjonen.

• Ikke bruk NAT (Network Address Translation) på plattformer som er konfigurert for et Cisco Unified Border Element (CUBE). Konfigurer derfor koblingsprogrammet med en IP-adresse som kan rutes. Det vil si at den ikke kan dele adressen til rutergrensesnittet.

Klargjør enheten din for en gateway-registrering:

• Tilgang til Control Hub som organisasjonsadministrator

• IP-adresse, brukernavn og passord for enhetene du vil konfigurere.

• Cisco IOS XE versjon:

  • Lokale gatewayer – Cisco IOS XE Bengaluru 17.6.1a eller nyere

  • Overlevelsesgatewayer – Cisco IOS XE Dublin 17.12.3 eller nyere

  Se Cisco Software Research for anbefalte versjoner. Søk etter plattformen og velg en av Foreslåtte versjonene.

• Systemforutsetninger

  • Minimum ledig minne – 256 MB

  • Minimum diskplass – Harddisken (SSD) som er koblet til gatewayen som brukes til tilkoblingsinstallasjon, må ha 2000 MB ledig plass. Bootflash må også ha 50 MB ledig plass. Den brukes til å lagre logger og RPM-filer.

    Hvis en harddisk ikke er koblet til gatewayen, brukes oppstartsflash til tilkoblingsinstallasjon. Deretter må bootflash ha 2000 MB ledig plass.

Hvis oppstartsflash på ruteren din er 4 GB og det er mindre enn 2 GB tilgjengelig kapasitet (minimum kapasitet), sletter du alle IOS binære bilder (.bin) unntatt det som kjører for øyeblikket. Når du har slettet filene, frigjør du ekstra plass.

Bruk følgende trinn for å utvide det binære bildet og oppstarten fra komponenter:

1. Opprett en ny katalog ved hjelp av mkdir bootflash:/image.

2. Utvid IOS-binærbildet ved hjelp av programvarepakken for forespørsel om å utvide filen bootflash:/.bin til bootflash:/image.

3. Fjern de gjeldende oppstartsalternativene i konfigurasjonsmodus ved å bruke ingen oppstartssystem.

4. Konfigurer en ny oppstartsmelding: boot system bootflash:/image/packages.conf.

5. Avslutt konfigurasjonsmodus, lagre konfigurasjonen og start på nytt.

6. Når ruteren har startet på nytt, bruker du vis versjon for å bekrefte at ruteren har startet fra bootflash:/image/packages.conf. I så fall:

   1. Kontroller at bootflash:/sysboot -katalogen er tom.

   2. Slett det gjenværende IOS-binære bildet.

   3. Slett alle kjernebilder ved å bruke delete /f /r bootflash:/core/*.

   4. Slett sporingsloggfiler ved hjelp av delete /f /r bootflash:/tracelogs/*.

   5. Hvis det fremdeles er utilstrekkelig diskplass, kan du se gjennom de gjenværende filene i bootflash: og slette andre ikke-essensielle filer, som logger og CDR-er.

• En støttet Cisco-ruter som er koblet til et nettverk med bane til Internett. Den grunnleggende konfigurasjonen må ha følgende:

  • DNS-serveren er konfigurert til å løse offentlige domenenavn.

  • Bruk følgende kommando for å konfigurere DNS-serveren:

    • IP-navneserver

  • HTTP Proxy-server hvis du ønsker å nå Internett via en proxy.

  • Gateway-legitimasjon: Legitimasjon (brukernavn og passord) med tilgang på rettighetsnivå 15 som kontakten kan bruke til å få tilgang til gatewayen via NETCONF-grensesnittet.

    For å godkjenne og godkjenne NETCONF-tilgang må du sørge for at standard aaa-lister er konfigurert som illustrert i eksemplet. Du kan bruke et hvilket som helst metodealternativ i standardlisten. Du kan ikke bruke en navngitt aaa-liste til å kontrollere NETCONF-tilgang. Hvis standardlistene ikke er riktig konfigurert, kan det hende du ser feilmeldingen «ugyldig metodeliste» i systemloggen.

     aaa ny-modell aaa godkjenningspålogging standard radius lokal aaa godkjenning utfør standard radius lokal hvis godkjent brukernavn test rettighet 15 hemmelig  

  Nettverksforutsetninger

  • IP-adressen til tilkoblingen må være i samme nettverk som det som er valgt for ekstern tilkobling. Det kan være en privat nettverksadresse, men den må ha HTTPS-tilgang til Internett.

    Hvis du bruker Virtual CUBE på Amazon Web Services (AWS) som lokal gateway, kan du se Knytte en sekundær IP-adresse for Virtual CUBE på AWS for trinn om hvordan du knytter en sekundær IP-adresse for bruk av kontakter.

  • Koble til Control Hub og lokale enheter for å fullføre registreringsprosessen.

  • URL-adresser for Webex-tjenester:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportprotokoller: Transport Layer Security (TLS) versjon 1.2

  • Importer IOS offentlige sertifiseringsinstanser. Sertifikatene som legges til i gateway-klareringsutvalget, brukes til å bekrefte tilgangen til Webex-servere. Bruk følgende konfigurasjonskommando for å importere pakken.

    krypto pki trustpool import URL https://www.cisco.com/security/pki/trs/ios.p7b

 =============================================================== Installasjon av Webex Gateway Connector =============================================================== Velg det eksterne grensesnittet fra listen over tilgjengelige grensesnitt nedenfor: =============================================================== Status for nummergrensesnitt IP-adresse ===============================================================      1 GigabitEthernet1 10.65.125.142 opp =============================================================== Angi et nummer for å velge det eksterne grensesnittet: 1 

 Disse DNS-innstillingene ble oppdaget i gateway-konfigurasjonen:  72.163.128.140 Vil du bruke disse innstillingene for kontakten? [Y/n]: 

 Disse DNS-innstillingene ble oppdaget i gateway-konfigurasjonen: 72.163.128.140 Vil du bruke disse innstillingene for kontakten? [Y/n]: n 

 Disse proxy-innstillingene ble oppdaget i gateway-konfigurasjonen:  Proxy-server: proxy-wsa.esl.cisco.com Proxy-port: 80 Vil du bruke disse innstillingene for kontakten? [Y/n]: 

 SNMP-trapper for syslog-meldinger er konfigurert på -nivå, og de vil bli endret til -nivå for å sende varsler til Webex Cloud. Bekreft at det er greit å fortsette?:  [Y/n]: 

 Angi kontaktens IP-adresse: 10.65.125.227 

 Angi gateway-brukernavn: lab Angi gateway-passord: *** Bekreft gateway-passord: ***

 =============================================================== Webex Managed Gateway Connector =============================================================== *** Skykontakt er installert. *** ------------------------------------------------------- *** Grensesnittstatus *** ------------------------------------------------------- Grensesnittstatus IP-adressestatus ------------------------------------------------------- GigabitEthernet1 10.65.125.142 opp VirtualPortGroup0 10.65.125.142 opp Connector 10.65.125.188 opp ------------------------------------------------------- *** Appstatus *** ------------------------------------------------------- Tjenestestatus ------------------------------------------------------- Guestshell RUNNING Management Connector RUNNING ------------------------------------------------------- =============================================================== Velg alternativ h for startmeny eller q for å avslutte: 

Den generelle statusen til tilkoblingen som vises i Control Hub, avhenger av tilstanden til telemetri- og administrasjonskoblingene på den administrerte gatewayen.

Tilkoblingsstatuser i Control Hub	Beskrivelse
På nett	Angir at kontakten er Koblet til Cisco Webex-skyen.
Frakoblet	Angir at kontakten er Ikke koblet til Cisco Webex-skyen.
Satt på pause	Angir at kontakten er tilkoblet, men at den er midlertidig stanset .

Lokal administrasjon av administrasjonskontakten

Du kan bruke Webex Calling med gatewayen etter at koblingen er installert. Om nødvendig kan du oppdatere en rekke koblingsinnstillinger ved hjelp av alternativene som er tilgjengelige i skriptmenyen:

Du kan starte skriptet på nytt når som helst ved hjelp av følgende kommando: tclsh bootflash:/gateway_connector/gateway_onboarding.tcl.

 =============================================================== Webex Managed Gateway Connector =============================================================== Alternativer: Vis statusside v: Vis og endre innstillinger for skytilkobling e : Aktiver Guestshell d: Deaktiver gjesteskal l: Samle inn logger r: Tøm logger: Avinstaller kontakt q: Avslutt =============================================================== Velg et alternativ fra menyen:

Visningsstatus

Bruk s: Vis Status Page menyalternativ. Systemet viser statusen til de forskjellige tilkoblingsmodulene.

 =============================================================== Webex Managed Gateway Connector =============================================================== ------------------------------------------------------- *** Grensesnittstatus *** ------------------------------------------------------- Grensesnittstatus IP-adresse ------------------------------------------------------- GigabitEthernet1 10.123.221.224 opp Connector 10.123.221.223 opp ------------------------------------------------------- *** Appstatus *** ------------------------------------------------------- Tjenestestatus ------------------------------------------------------- Guestshell RUNNING Management Connector RUNNING ------------------------------------------------------- =============================================================== Velg alternativ h for startmeny eller q for å avslutte: q 

Aktiver Guestshell

Aktiver skykontakten ved hjelp av e: Aktiver menyalternativet Guestshell. Dette endrer statusen til kontakten fra INAKTIV til AKTIV.

Deaktiver gjesteskal

Deaktiver skykontakten ved hjelp av d: Deaktiver menyalternativet Guestshell. Dette endrer statusen til kontakten fra AKTIV til INAKTIV.

Avinstaller kontakt

Avinstaller skykontakten ved hjelp av u: Avinstaller Connector menyalternativ. Dette sletter alle dataene i Guestshell-beholderen og fjerner alle konfigurasjoner som er relatert til skytilkoblingen.

Samle inn logger

Samle inn loggene ved hjelp av l: Innhente logger menyalternativet. Systemet viser plasseringen der disse loggene lagres etter at loggene er samlet.

Hvis du har en aktiv støttesak med Cisco TAC, kan du legge loggene direkte til tjenesteforespørselen ved hjelp av 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

Tøm logger

Tøm alle loggfilene på enheten ved hjelp av r: Tøm Logger menyalternativet. Dette sletter alle eksisterende logger unntatt de nyeste loggene i TCL-skriptet og kontaktene.

Vise og endre innstillinger for skytilkobling

Gjør følgende endringer i de eksisterende innstillingene for en skykontakt ved hjelp av v: Menyalternativet Vis og endre skytilkoblingsinnstillinger .

 =============================================================== Webex Managed Gateway Connector =============================================================== Skriptversjon: 2.0.2 Vertsnavn/IP-adresse: 10.65.125.188 DNS-server(er): 10.64.86.70 Gateway-brukernavn : eksternt grensesnitt for lab: GigabitEthernet1-proxy-vertsnavn/IP-adresse: proxy-wsa.esl.cisco.com:80 =============================================================== Alternativer c:  Oppdater gateway-legitimasjon e:  Oppdatering av eksternt grensesnitt p:  Oppdater proxy-detaljer n:  Oppdater DNS-server k:  Oppdater bekreftelsesnøkkel for koblingspakke l:  Endre loggnivå for Cloud Connector h:  Gå til startmenyen q :  Avslutt =============================================================== Velg et alternativ fra menyen: c

Oppdater gateway-legitimasjon

Oppdater gatewayens brukernavn og passord ved hjelp av c: Oppdater menyalternativet for gateway-legitimasjon.

Oppdater eksternt grensesnitt

Endre grensesnittet som kontakten er koblet til, og tilkoblingens IP-adresse ved hjelp av v: Menyalternativet Vis og endre skytilkoblingsinnstillinger .

Oppdater proxy-detaljer

Du kan utføre følgende oppgaver ved hjelp av p: Menyalternativ for oppdatering av proxy-detaljer :

• i: Oppdater proxy-IP og port

• c: Oppdater proxy-legitimasjon

• r: Fjern proxy-legitimasjon

• a: Fjern alle proxy-detaljer

• h: Gå til startmenyen

Oppdater bekreftelsesnøkkel for koblingspakke

Hvis det oppstår et teknisk problem, hvis støtteteknikeren ber om å erstatte pakkebekreftelsesnøkkelen, laster du opp den nye gateway-webex-connectors.gpg -filen til bootflash:/gateway_connector/ og bruker k: Oppdater menyalternativet for nøkkelbekreftelse for koblingspakke for å bekrefte.

Endre loggnivået for Management Connector

Endre loggingsnivået for kontakten ved hjelp av l: Endre loggnivået for menyalternativet Cloud Connector , og velg deretter ett av følgende alternativer:

 ===================================== Nivå for nummerlogg =====================================    1 feilsøking     2 opplysninger     3 advarsel     4 feil     5 kritiske ====================================== 

Slik administrerer du gateway-forekomsten:

1. Logg på Control Hub.

2. Gå til TJENESTER, klikk på Anrop og klikk deretter på Administrerte gatewayer.

3. For den aktuelle gateway-forekomsten klikker du på i Handlinger -kolonnen og velger den aktuelle handlingen.