Zarejestrowanie bram Cisco IOS w Control Hub pomaga uprościć zarządzanie urządzeniami i umożliwia korzystanie z nowych usług Webex Calling. Ponieważ bramy utrzymują połączenie z Control Hub, możesz nimi zarządzać i monitorować je z dowolnego miejsca, podobnie jak pozostałe urządzenia Webex Calling. Aby zarejestrować bramę, musisz zainstalować aplikację łącznika zarządzania i upewnić się, że istnieje bezpieczne połączenie z chmurą Cisco Webex. Po nawiązaniu połączenia możesz zarejestrować bramę, logując się do Control Hub.

Proces ten nie dotyczy bramek głosowych Cisco IOS, takich jak VG400, które są w pełni zarządzane jako urządzenia w Control Hub.

Mała aplikacja łącznika, znana jako GuestShell, odpowiada za nawiązywanie i utrzymywanie połączenia między bramą a Control Hub. Aplikacje GuestShell i łącznika są konfigurowane i ustawiane za pomocą skryptu uruchamianego na bramie z chmury Webex podczas procesu rejestracji.

Aby uprościć proces instalacji, skrypt dodaje szereg niezbędnych konfiguracji bramy.

Łą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ą zainstalowane 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 skonfigurować GuestShell, a także zainstalować i konserwować łącznik zarządzający.

Łą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 serwera 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.

• Guestshell

• NETCONF Yang

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

• Trasa IP — kierowanie ruchem związanym z łącznikiem 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:

• 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ć 50MB 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ęć bootflash routera ma pojemność 4 GB, a dostępnej pojemności jest mniej niż 2 GB (minimalna pojemność), usuń wszystkie obrazy binarne IOS (.bin) oprócz tego, który jest aktualnie uruchomiony. Po usunięciu plików zwolnij dodatkowe miejsce.

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

1. Utwórz nowy katalog używając.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żyjshow version, aby sprawdzić, czy router został uruchomiony 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 rdzenia 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 za pomocą ścieżki do Internetu. Podstawowa konfiguracja musi obejmować 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 za pośrednictwem interfejsu 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 łączności zewnętrznej. Może to być prywatny adres sieciowy, ale musi mieć dostęp HTTPS do Internetu.

    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

  • Protokoły transportowe: Protokół Transport Layer Security (TLS) w wersji 1.2

  • Zaimportuj pakiet publicznego urzędu certyfikacji IOS. Certyfikaty dodane do puli zaufanych bram 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 łącznik jest Niepołączony 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ą bramą. 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, korzystając z opcji menu e: Enable Guestshell. Zmienia to status łącznika z INACTIVE na ACTIVE.

Wyłącz Guestshell

Wyłącz łącznik chmury, korzystając z opcji menu d: Disable Guestshell. Zmienia to status łącznika z ACTIVE na INACTIVE.

Odinstaluj łącznik

Odinstaluj łącznik chmury, korzystając z 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 przedstawiono 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ń łącznika chmury

Wprowadź następujące zmiany w istniejących ustawieniach łącznika chmury, 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

Aktualizacja poświadczeń bramy

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

Aktualizacja interfejsu zewnętrznego

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

Zaktualizuj klucz weryfikacyjny pakietu łącznika

W przypadku problemu technicznego, gdy inżynier wsparcia poprosi o wymianę klucza weryfikacyjnego pakietu, prześlij nowy plik gateway-webex-connectors.gpg do bootflash:/gateway_connector/ i skorzystaj z opcji menu k: Update Connector Package Verification Key, aby dokonać 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 > PSTN & Rozgromienie > Konfiguracje bramy > Zarządzaj bramami

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