Zarejestruj bramy zarządzane Cisco IOS w usłudze Webex Cloud

Konektory bramy to małe aplikacje działające w bramie GuestShell w celu utrzymania połączenia z Control Hub, koordynowania zdarzeń i zbierania informacji o stanie. Aby uzyskać więcej informacji na temat programu GuestShell, zobacz GuestShell.

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

Dostępne są dwa typy złączy:

• Łącznik zarządzania

• Złącze telemetrii

Interaktywny skrypt TCL oparty na menu pomaga skonfigurować GuestShell, a także zainstalować i utrzymać łącznik zarządzania.

Łącznik zarządzania zapewnia rejestrację bramy i zarządzanie cyklem życia łącznika telemetrii.

Po pomyślnym ukończeniu rejestracji łącznik zarządzania pobiera i instaluje najnowszy łącznik telemetrii.

Na poniższej ilustracji pokazano, w jaki sposób różne składniki łączą się w rozwiązaniu Webex Calling:

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

• Interfejs zewnętrzny

• Adresy serwera DNS

• Szczegóły serwera proxy

• Adres IP łącznika

• Poświadczenia bramy (nazwa użytkownika i hasło)

Skrypt TCL wykonuje następujące konfiguracje:

• Grupa portów wirtualnych — wymagana do konfiguracji powłoki guestShell.

• Powłoka gościa

• Jang NETCONF

• Konfiguracja pułapki SNMP — wymagana w przypadku powiadomień z systemu Cisco IOS XE.

• Trasa IP — służy do kierowania ruchu związanego 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 pamiętać, że aplikacji łącznika nie można używać z następującymi urządzeniami:

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

Konfigurując router do użytku z aplikacją łącznika, 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 komunikatu Brak komunikatu IP proxy-arp , aby wyłączyć tę funkcję.

• Nie należy korzystać z translacji adresów sieciowych (NAT) na platformach skonfigurowanych dla elementu Cisco Unified Border Element (CUBE). Skonfiguruj aplikację łącznika z routowalnym adresem IP. Oznacza to, że nie może udostępniać adresu interfejsu routera.

Przygotuj urządzenie do rejestracji bramy:

• Uzyskuj 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 nowsza

  • Bramy utrzymania — Cisco IOS XE Dublin 17.12.3 lub nowszy

  Aby uzyskać informacje o zalecanych wersjach, zobacz Badania nad oprogramowaniem Cisco. Wyszukaj platformę i wybierz jedną z sugerowanych wersji.

• Wymagania wstępne systemu

  • Minimalna wolna pamięć — 256 MB

  • Minimalna przestrzeń na dysku — dysk twardy (SSD) podłączony do bramy używanej 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 dysk twardy nie jest podłączony do bramy, do instalacji konektora służy bootflash. Następnie bootflash musi mieć 2000 MB wolnego miejsca.

Jeśli wartość flash bootflash routera wynosi 4 GB, a pojemność jest mniejsza niż 2 GB (minimalna), usuń wszystkie obrazy binarne IOS (.bin) z wyjątkiem aktualnie uruchomionego. Po usunięciu plików zwolnij dodatkowe miejsce.

Aby rozwinąć obraz binarny i rozruch z komponentów, wykonaj poniższe 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. Konfigurowanie nowego polecenia rozruchu: boot system bootflash:/image/packages.conf.

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

6. Po ponownym uruchomieniu routera należy sprawdzić, show version czy router został uruchomiony z poziomu bootflash:/image/packages.conf. Jeśli tak:

   1. Upewnij się, że bootflash:/sysboot katalog jest pusty.

   2. Usuń pozostały obraz binarny systemu 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 nadal masz za mało miejsca na dysku, sprawdź pozostałe pliki w pliku bootflash: oraz usunąć wszystkie inne, nieistotne pliki, takie jak dzienniki i CDR.

• Obsługiwany router Cisco podłączony do sieci ze ścieżką do Internetu. Konfiguracja podstawowa 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 się łączyć z Internetem za pośrednictwem serwera proxy.

  • Poświadczenia bramy: Aby uzyskać dostęp do bramy za pośrednictwem interfejsu NETCONF, konektor musi podać lokalne poświadczenie (nazwę użytkownika i hasło) z dostępem na poziomie 15 uprawnień.

    Aby uwierzytelnić i autoryzować dostęp do sieci NETCONF, domyślne listy AAA są skonfigurowane w sposób przedstawiony w przykładzie. Do kontrolowania dostępu do NETCONF nie można używać listy AAA o nazwie. Jeśli listy domyślne nie są poprawnie skonfigurowane, w dzienniku systemowym może być wyświetlany komunikat o błędzie „lista nieprawidłowych metod”. Może być konieczne użycie innych metod wraz z lokalnymi metodami dla AAA, może to zostać osiągnięte, jednak wymagana będzie aktualizacja konkretnej konfiguracji.

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

  Wymagania wstępne sieci

  • Adres IP łącznika musi należeć do tej samej sieci, co adres wybrany dla połączeń zewnętrznych. Może to być adres sieci prywatnej, ale musi mieć dostęp do Internetu za pośrednictwem protokołu HTTPS.

    Jeśli używasz wirtualnego CUBE w Amazon Web Services (AWS) jako bramy lokalnej, zapoznaj się z tematem Przypisywanie pomocniczego adresu IP dla wirtualnego CUBE w AWS , aby uzyskać instrukcje dotyczące kojarzenia pomocniczego adresu IP do użytku konektora.

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

  • Adresy URL usług Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protokoły transportu: Transport Layer Security (TLS) wersja 1.2

  • Zaimportuj pakiet publicznych urzędów certyfikacji IOS. Certyfikaty dodane do puli zaufania bramy są używane do weryfikowania dostępu do serwerów Webex. Do zaimportowania pakietu 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 konektora wyświetlany w Control Hub zależy od stanu konektorów telemetrii i zarządzania w bramie zarządzanej.

Stany łącznika w Control Hub	Opis
Online	Wskazuje, że konektor jest Połączony z chmurą Cisco Webex.
Offline	Wskazuje, że konektor nie jest połączony z chmurą Cisco Webex.
Wstrzymane	Wskazuje, że konektor jest podłączony, ale jest tymczasowo wstrzymany .

Administracja lokalna łącznika zarządzania

Po pomyślnej instalacji konektora możesz korzystać z usługi Webex Calling z bramą. W razie potrzeby można zaktualizować kilka ustawień łącznika, korzystając z opcji dostępnych w menu skryptu:

Skrypt można ponownie uruchomić w dowolnym momencie za pomocą 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 stan

Użyj s: Display Status Page opcji menu. 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ą e: Enable Guestshell opcji menu. Spowoduje to zmianę stanu konektora z INACTIVE na ACTIVE.

Wyłącz Guestshell

Wyłącz łącznik chmury za pomocą d: Disable Guestshell opcji menu. Spowoduje to zmianę stanu konektora z ACTIVE na INACTIVE.

Odinstaluj łącznik

Odinstaluj łącznik chmury za pomocą u: Uninstall Connector opcji menu. Powoduje to usunięcie wszystkich danych w kontener Guestshell i usunięcie wszystkich konfiguracji związanych z łącznikiem chmury.

Zbieranie dzienników

Zbierz dzienniki za pomocą l: Collect Logs opcji menu. Po zebraniu dzienników system wyświetla lokalizację, w której te dzienniki są przechowywane.

Jeśli masz aktywną sprawę referencyjną w programie Cisco TAC, dzienniki można dołączyć bezpośrednio do zgłoszenia serwisowego za pomocą polecenia copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Oto 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 dzienników w urządzeniu za pomocą r: Clear Logs opcji menu. Spowoduje to usunięcie wszystkich istniejących dzienników z wyjątkiem najnowszych dzienników skryptu TCL i łączników.

Wyświetl i modyfikuj ustawienia łącznika chmury

Wprowadź następujące zmiany w istniejących ustawieniach łącznika chmury, korzystając z v: View and Modify Cloud Connector Settings opcja menu.

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

Zaktualizuj poświadczenia bramy

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

Zaktualizuj interfejs zewnętrzny

Za pomocą v: View and Modify Cloud Connector Settings opcji menu zmień interfejs, z którym jest połączony łącznik, oraz adres IP łącznika.

Zaktualizuj szczegóły serwera proxy

Za pomocą p: Update Proxy Details opcji menu można 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, jeśli inżynier działu pomocy technicznej poprosi o zastąpienie klucza weryfikacyjnego pakietu, prześlij nowy gateway-webex-connectors.gpg plik do bootflash:/gateway_connector/ i skorzystaj z k: Update Connector Package Verification Key opcji menu w celu weryfikacji.

Zmodyfikuj poziom dziennika dla łącznika zarządzania

Zmień poziom rejestrowania konektora za pomocą l: Modify log level for Cloud Connector opcji menu, 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ć wystąpieniem bramy:

1. Zaloguj się do Centrum sterowania.

2. Przejdź do pozycji USŁUGI, kliknij pozycję Połączenie , a następniekliknij pozycję Bramy zarządzane.

3. Dla odpowiedniego wystąpienia bramy kliknij w kolumnie Czynności i wybierz odpowiednią czynność.