Łączniki bramy to niewielkie aplikacje działające w GuestShell bramy, które utrzymują połączenie z Control Hub, koordynują zdarzenia i zbierają informacje o stanie. Więcej informacji na temat GuestShell znajdziesz w GuestShell.

Złącza bramy są instalowane w kontenerze Cisco IOS XE GuestShell.

Istnieją dwa rodzaje złączy:

• Złącze zarządzania

• Złącze telemetryczne

Interaktywny skrypt TCL sterowany za pomocą menu pomaga w skonfigurowaniu GuestShell, a także w instalacji i konserwacji łącznika zarządzającego.

Łącznik zarządzania odpowiada za rejestrację bramy i zarządzanie cyklem życia łącznika telemetrycznego.

Po pomyślnym zakończeniu rejestracji łącznik zarządzania pobierze i zainstaluje najnowszą wersję łącznika telemetrycznego.

Poniższa grafika przedstawia sposób łączenia różnych komponentów w rozwiązaniu Webex Calling:

W ramach wykonywania skryptu TCL zbierane są następujące informacje od użytkownika:

• Interfejs zewnętrzny

• Adresy serwerów DNS

• Szczegóły proxy

• Adres IP złącza

• Dane uwierzytelniające bramy (nazwa użytkownika i hasło)

Skrypt TCL wykonuje następujące konfiguracje:

• Grupa portów wirtualnych — wymagana do konfiguracji powłoki gościa.

• Gościnna skorupa

• NETCONF Yang

• Konfiguracja pułapki SNMP — wymagana do otrzymywania powiadomień z Cisco IOS XE.

• Trasa IP — kierowanie ruchem związanym ze złączem przez wirtualną grupę portów.

Skrypt TCL wykonuje następujące konfiguracje:

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

Przed instalacją należy wziąć pod uwagę, że aplikacja łącznika nie może być używana z następującymi urządzeniami:

• Platformy routerów usług zintegrowanych Cisco 1100
• Platformy skonfigurowane w trybie wysokiej dostępności (HA)
• Platformy skonfigurowane w trybie kontrolera dla sieci SD-WAN

Konfigurując router do współpracy z aplikacją łącznikową, należy wziąć pod uwagę następujące kwestie:

• System iOS XE używa protokołu proxy ARP do kierowania ruchu do powłoki gościa. Nie konfiguruj polecenia no ip proxy-arp, aby wyłączyć tę funkcję.

• Nie należy używać translacji adresów sieciowych (NAT) na platformach skonfigurowanych dla Cisco Unified Border Element (CUBE). Dlatego należy skonfigurować aplikację łącznika przy użyciu routowalnego adresu IP. Oznacza to, że nie może współdzielić adresu interfejsu routera.

Przygotuj urządzenie do rejestracji w bramie sieciowej:

• Dostęp do Control Hub jako administrator organizacji

• Adres IP, nazwa użytkownika i hasło dla urządzeń, które chcesz skonfigurować.

• Wersja Cisco IOS XE:

  • Bramy lokalne — Cisco IOS XE Bengaluru 17.6.1a lub nowszy

  • Bramy zapewniające przetrwanie — Cisco IOS XE Dublin 17.12.3 lub nowszy

  Zalecane wersje można znaleźć w Cisco Software Research. Wyszukaj platformę i wybierz jedną z sugerowanych wersji.

• Wymagania systemowe

  • Minimalna ilość wolnej pamięci — 256 MB

  • Minimalna ilość miejsca na dysku — Dysk twardy (SSD) podłączony do bramy, który jest używany do instalacji łącznika, musi mieć 2000 MB wolnego miejsca. Ponadto bootflash musi mieć 50 MB wolnego miejsca. Służy do przechowywania dzienników i plików RPM.

    Jeśli do bramy nie jest podłączony dysk twardy, do instalacji złącza używany jest bootflash. Następnie bootflash musi mieć 2000 MB wolnego miejsca.

Jeśli pamięć rozruchowa routera ma 4 GB, a dostępnej pojemności jest mniej niż 2 GB (minimalna pojemność), usuń wszystkie obrazy binarne systemu iOS (.bin) z wyjątkiem tego, który jest aktualnie uruchomiony. Po usunięciu plików zwolnij dodatkowe miejsce.

Aby rozszerzyć obraz binarny i uruchomić go z komponentów, wykonaj następujące czynności:

1. Utwórz nowy katalog za pomocą.mkdir bootflash:/image

2. Rozwiń obraz binarny IOS za pomocą.request platform software package expand file bootflash:/.bin to bootflash:/image

3. W trybie konfiguracji usuń bieżące opcje rozruchu za pomocą.no boot system

4. Skonfiguruj nowe polecenie rozruchowe: boot system bootflash:/image/packages.conf.

5. Wyjdź z trybu konfiguracji, zapisz konfigurację i uruchom ponownie.

6. Po ponownym uruchomieniu routera użyj , abyshow version sprawdzić, czy router uruchomił się z bootflash:/image/packages.conf. W takim razie:

   1. Sprawdź, czy katalog bootflash:/sysboot jest pusty.

   2. Usuń pozostały obraz binarny IOS.

   3. Usuń wszystkie obrazy rdzeniowe za pomocą.delete /f /r bootflash:/core/*

   4. Usuń pliki dziennika śledzenia za pomocą.delete /f /r bootflash:/tracelogs/*

   5. Jeśli na dysku nadal brakuje miejsca, sprawdź pozostałe pliki w bootflashu: i usuń wszystkie nieistotne pliki, takie jak dzienniki i listy połączeń.

• Obsługiwany router Cisco, który jest podłączony do sieci mającej ścieżkę do Internetu. Podstawowa konfiguracja musi zawierać następujące elementy:

  • Serwer DNS jest skonfigurowany do rozpoznawania nazw domen publicznych.

  • Aby skonfigurować serwer DNS, użyj następującego polecenia:

    • serwer nazw ip <IP address>

  • Serwer proxy HTTP, jeśli chcesz uzyskać dostęp do Internetu za pomocą serwera proxy.

  • Dane uwierzytelniające bramki: Aby uzyskać dostęp do bramy poprzez interfejs NETCONF, łącznik wymaga lokalnych danych uwierzytelniających (nazwy użytkownika i hasła) z poziomem uprawnień 15.

    Aby uwierzytelnić i autoryzować dostęp do NETCONF, upewnij się, że domyślne listy aaa są skonfigurowane tak, jak pokazano w poniższym przykładzie. Tylko polecenia wymienione w tym dokumencie zostały sprawdzone i są obsługiwane w przypadku bram zarządzanych. Konfiguracje wykorzystujące inne metody (na przykład TACACS lub ISE) nie zostały zweryfikowane i obecnie nie są obsługiwane.

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

  Wymagania sieciowe

  • Adres IP łącznika musi znajdować się w tej samej sieci, co adres wybrany do połączenia zewnętrznego. Może to być prywatny adres sieciowy, ale musi mieć dostęp do Internetu za pomocą protokołu HTTPS.

    Jeśli używasz Virtual CUBE w Amazon Web Services (AWS) jako bramy lokalnej, zapoznaj się z tematem Kojarzenie dodatkowego adresu IP dla Virtual CUBE w AWS, aby uzyskać instrukcje dotyczące kojarzenia dodatkowego adresu IP w celu użycia łącznika.

  • Połącz się z Control Hub i urządzeniami lokalnymi, aby dokończyć proces rejestracji.

  • Adresy URL usług Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protokół transportowy: Wersja 1.2 protokołu Transport Layer Security (TLS)

  • Zaimportuj pakiet publicznego urzędu certyfikacji IOS. Certyfikaty dodane do puli zaufania bramy służą do weryfikacji dostępu do serwerów Webex. Aby zaimportować pakiet, użyj następującego polecenia konfiguracyjnego.

    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: 

Ogólny stan łącznika wyświetlany w Control Hub zależy od stanu łączników telemetrycznych i zarządzających w Managed Gateway.

Stany łączników w centrum sterowania	Opis
Online	Oznacza, że złącze jest połączone z chmurą Cisco Webex.
Offline	Oznacza, że złącze jest Niepołączone z chmurą Cisco Webex.
Wstrzymane	Oznacza, że złącze jest podłączone, ale jest tymczasowo wstrzymane.

Lokalna administracja łącznika zarządzania

Po pomyślnym zainstalowaniu łącznika możesz używać usługi Webex Calling ze swoją bramką. W razie potrzeby możesz zaktualizować szereg ustawień łącznika, korzystając z opcji dostępnych w menu skryptu:

Możesz ponownie uruchomić skrypt w dowolnym momencie, używając następującego polecenia: 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:

Wyświetl status

Użyj opcji menu s: Display Status Page. System wyświetla stan różnych modułów złączy.

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

Włącz Guestshell

Włącz łącznik chmury za pomocą opcji menu e: Enable Guestshell. Zmienia to status złącza z INACTIVE na ACTIVE.

Wyłącz Guestshell

Wyłącz łącznik chmury za pomocą opcji menu d: Disable Guestshell. Zmienia to status złącza z ACTIVE na INACTIVE.

Odinstaluj łącznik

Odinstaluj łącznik chmury za pomocą opcji menu u: Uninstall Connector. Spowoduje to usunięcie wszystkich danych w kontenerze Guestshell i wszystkich konfiguracji powiązanych z łącznikiem w chmurze.

Zbieranie dzienników

Zbierz dzienniki korzystając z opcji menu l: Collect Logs. Po zebraniu logów system wyświetla lokalizację, w której są one przechowywane.

Jeśli masz aktywną sprawę pomocy technicznej w Cisco TAC, możesz dołączyć dzienniki bezpośrednio do swojego zgłoszenia serwisowego, używając polecenia copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Poniżej znajduje się przykładowe polecenie:

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

Wyczyść dzienniki

Wyczyść wszystkie pliki dziennika w urządzeniu, korzystając z opcji menu r: Clear Logs. Spowoduje to usunięcie wszystkich istniejących dzienników z wyjątkiem najnowszych dzienników skryptu TCL i łączników.

Wyświetlanie i modyfikowanie ustawień Cloud Connector

Wprowadź następujące zmiany w istniejących ustawieniach łącznika w chmurze, korzystając z opcji menu 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

Aktualizuj dane uwierzytelniające bramy

Zaktualizuj nazwę użytkownika i hasło bramy korzystając z opcji menu c: Update Gateway Credentials.

Aktualizuj interfejs zewnętrzny

Zmień interfejs, do którego przypisany jest łącznik, i adres IP łącznika, korzystając z opcji menu v: View and Modify Cloud Connector Settings.

Aktualizuj szczegóły serwera proxy

Za pomocą opcji menu p: Update Proxy Details możesz wykonać następujące zadania:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Aktualizuj klucz weryfikacyjny pakietu łącznika

W przypadku problemu technicznego, jeśli inżynier pomocy technicznej poprosi o wymianę klucza weryfikacyjnego pakietu, prześlij nowy plik gateway-webex-connectors.gpg do bootflash:/gateway_connector/ i użyj opcji menu k: Update Connector Package Verification Key w celu weryfikacji.

Modyfikowanie poziomu dziennika dla łącznika zarządzania

Zmień poziom rejestrowania dla łącznika, korzystając z opcji menu l: Modify log level for Cloud Connector, a następnie wybierz jedną z następujących opcji:

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

Aby zarządzać instancją bramy:

1. Zaloguj się do Centrum sterowania.

2. Przejdź do USŁUGI, kliknij Połączenia, a następnie kliknij Zarządzane bramy.

3. Aby uzyskać dostęp do odpowiedniej instancji bramy, kliknij … w kolumnie Akcje i wybierz odpowiednią akcję.