Zapisywanie bramek zarządzanych przez IOS Cisco do usługi Webex Cloud

Złącza bramy to małe aplikacje, które działają w GuestShell bramy w celu utrzymania połączenia z Control Hub, koordynowania zdarzeń i zbierania informacji o stanie. Aby uzyskać więcej informacji na temat GuestShell, patrz GuestShell.

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

Istnieją dwa rodzaje złączy:

• Łącznik zarządzania

• Złącze telemetryczne

Interaktywny skrypt TCL oparty na menu pomaga w skonfigurowaniu GuestShell, a także w instalacji i konserwacji łącznika zarządzania.

Złącze zarządzania zajmuje się rejestracją bramy i zarządzaniem cyklem życia złącza telemetrycznego.

Po pomyślnym zakończeniu rejestracji konektor zarządzania pobiera i instaluje najnowsze złącze telemetryczne.

Poniższa ilustracja przedstawia, jak różne komponenty łączą się w rozwiązaniu Webex Calling:

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

• Interfejs zewnętrzny

• Adresy serwerów DNS

• Szczegóły serwera proxy

• Adres IP złącza

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

Skrypt TCL wykonuje następujące konfiguracje:

• Grupa portów wirtualnych — wymagana dla konfiguracji guestshell.

• Guestshell

• NETCONF Yang

• Konfiguracja pułapki SNMP — wymagane do powiadomień z systemu Cisco IOS XE.

• Trasa IP — w celu przekierowania ruchu związanego z łącznikiem przez grupę portów wirtualnych.

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 elementami:

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

Podczas konfigurowania routera do użytku z aplikacją łącznika należy wziąć pod uwagę następujące elementy:

• IOS XE używa serwera proxy ARP do kierowania ruchu do powłoki gościa. Nie wyłączaj tej funkcji, konfigurując brak serwera proxy IP.
• Nie używaj tłumaczenia adresów sieciowych (NAT) na platformach skonfigurowanych dla CUBE. W związku z tym skonfiguruj aplikację łącznika z rutynowym adresem IP. Oznacza to, że nie może udostępniać adresu interfejsu routera.

Przygotuj urządzenie do rejestracji bramy:

• 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 nowsze

  • Bramy utrzymania — Cisco IOS XE Dublin 17.12.3 lub nowszy

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

• Wymagania wstępne systemu

  • Minimalna wolna pamięć — 256 MB

  • Minimalne miejsce na dysku — dysk twardy (SSD) podłączony do bramy używanej do instalacji łącznika musi mieć wolne miejsce 2000 MB. Również, bootflash musi mieć 50MB wolnego miejsca. Służy do przechowywania dzienników i plików RPM.

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

Jeśli bootflash routera wynosi 4 GB i jest mniej niż 2 GB dostępnej pojemności (minimalna pojemność), usuń wszystkie obrazy binarne IOS (.bin) z wyjątkiem tego, który jest obecnie uruchomiony. Po usunięciu plików zwolnij dodatkowy obszar.

Aby rozszerzyć obraz binarny i uruchomić go z elementó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:/<image>.bin to bootflash:/image.

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

4. Skonfiguruj nowe zdanie rozruchu: boot system bootflash:/image/packages.conf.

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

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

   1. Sprawdź, czy aplikacja bootflash:/sysboot katalog 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 nadal jest zbyt mało miejsca na dysku, przejrzyj pozostałe pliki w programie bootflash: i usunąć wszelkie inne nieistotne pliki, takie jak dzienniki i CDR.

• Obsługiwany router Cisco, który jest połączony z siecią ze ścieżką do Internetu. Podstawowa konfiguracja musi mieć następujące elementy:

  • Serwer DNS jest skonfigurowany do rozpoznawania nazw domen publicznych.

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

    • ip name-server <IP address="">

  • Serwer proxy HTTP, jeśli chcesz dotrzeć do Internetu za pośrednictwem serwera proxy.

  • Poświadczenia bramy: Poświadczenia (nazwa użytkownika i hasło) z dostępem na poziomie uprawnień 15, których można użyć do uzyskania dostępu do bramy za pośrednictwem interfejsu NETCONF.

    Aby uwierzytelnić i autoryzować dostęp NETCONF, upewnij się, że domyślne listy aaa są konfigurowane w sposób pokazany w przykładzie. Na liście domyślnej można użyć dowolnej opcji metody. Nie można użyć nazwanej listy aaa do kontrolowania dostępu NETCONF. Jeśli listy domyślne nie są poprawnie skonfigurowane, w dzienniku systemowym może być wyświetlany komunikat o błędzie „nieprawidłowa lista metod”.

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

  Wymagania wstępne sieci

  • Adres IP złącza musi znajdować się w tej samej sieci, co adres przeznaczony do połączenia zewnętrznego. Może to być adres sieci prywatnej, ale musi mieć dostęp HTTPS do Internetu.

    Jeśli używasz wirtualnego CUBE w Amazon Web Services (AWS) jako bramy lokalnej, zapoznaj się ze skojarzeniem drugorzędnego adresu IP dla wirtualnego CUBE w AWS, aby dowiedzieć się, jak powiązać drugorzędny adres IP do korzystania z łącznika.

  • Aby zakończyć proces rejestracji, należy połączyć się z Control Hub i urządzeniami lokalnymi.

  • Adresy URL usług Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

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

  • Importuj pakiet władz certyfikatów publicznych IOS. Certyfikaty dodane do puli zaufania bramy są używane do weryfikacji dostępu do serwerów Webex. Aby zaimportować pakiet, użyj następującego polecenia konfiguracji.

    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 <alerts> level and they would be changed to <notifications>
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świetlanego w Control Hub zależy od stanu łączników telemetrii i zarządzania na Managed Gateway.

Stany łącznika w Control Hub	Opis
Online	Wskazuje, że złącze jest Podłączone do chmury Cisco Webex.
Offline	Wskazuje, że złącze Nie jest Połączone z chmurą Cisco Webex.
Wstrzymane	Wskazuje, że złącze jest podłączone, ale jest tymczasowo wstrzymane .

Lokalna administracja konektora zarządzania

Po pomyślnym zainstalowaniu łącznika można korzystać z usługi Webex Calling przy użyciu bramy. W razie potrzeby można zaktualizować szereg ustawień łącznika, korzystając z opcji dostępnych w menu skryptu:

Skrypt można uruchomić ponownie w dowolnym momencie przy użyciu 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:

Stan wyświetlania

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

===============================================================
                 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 złącze chmury za pomocą e: Enable Guestshell opcja menu. Powoduje to zmianę stanu złącza INACTIVE do ACTIVE.

Wyłącz Guestshell

Wyłącz złącze chmury za pomocą d: Disable Guestshell opcja menu. Powoduje to zmianę stanu złącza ACTIVE do INACTIVE.

Odinstaluj złącze

Odinstaluj złącze chmury za pomocą u: Uninstall Connector opcja menu. Spowoduje to usunięcie wszystkich danych w kontenerze Guestshell i usunięcie wszystkich konfiguracji związanych ze złączem chmury.

Zbieranie dzienników

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

Jeśli masz aktywną sprawę pomocy technicznej z Cisco TAC, możesz dołączyć dzienniki bezpośrednio do żądania usługi za pomocą polecenia copy bootflash:/guest-share/<log-filename> scp://<case-number>:<cxd-token>@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 na urządzeniu za pomocą r: Clear Logs opcja menu. 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 w chmurze

Dokonaj następujących zmian w istniejących ustawieniach złącza chmury za pomocą 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 opcja menu.

Zaktualizuj interfejs zewnętrzny

Zmień interfejs, do którego złącze jest podłączone, oraz adres IP złącza za pomocą v: View and Modify Cloud Connector Settings opcja menu.

Aktualizuj szczegóły serwera Proxy

Następujące zadania można wykonać za pomocą p: Update Proxy Details opcja menu:

• 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 weryfikacji pakietu łącznika

Jeśli masz problem techniczny i inżynier pomocy technicznej poprosi Cię o zastąpienie klucza weryfikacji pakietów, prześlij nowy gateway-webex-connectors.gpg do pliku bootflash:/gateway_connector/ i korzystać z k: Update Connector Package Verification Key opcja menu do weryfikacji.

Modyfikuj poziom dziennika dla konektora zarządzania

Zmień poziom rejestrowania dla złącza za pomocą l: Modify log level for Cloud Connector opcja menu, a następnie wybrać 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. W obszarze USŁUGI kliknij opcję Połączenie, a następnie kliknij kartę Zarządzane bramy .

2. W przypadku wystąpienia odpowiedniej bramy kliknij sąsiednie kropki (…) w kolumnie Akcje i wybierz odpowiednie działanie.