Zaregistrovat brány spravované systémem Cisco IOS do služby Webex Cloud

Konektory brány jsou malé aplikace, které běží v bráně Shell, aby udržovaly připojení k centru Control Hub, koordinovaly události a shromažďovaly informace o stavu. Další informace o produktu Shell naleznete v tématu Shell.

Konektory brány jsou nainstalovány do kontejneru Cisco IOS XE Shell.

Existují dva typy konektorů:

• Konektor pro správu

• Konektor telemetrie

Interaktivní TCL skript řízený menu pomáhá nastavit Shell, stejně jako instalaci a údržbu konektoru pro správu.

Konektor pro správu se stará o registraci brány a správu životního cyklu konektoru telemetrie.

Po úspěšném dokončení registrace konektor pro správu stáhne a nainstaluje nejnovější konektor telemetrie.

Následující obrázek ukazuje, jak se jednotlivé komponenty připojují v řešení Webex Calling:

V rámci spuštění skriptu TCL jsou od uživatele shromažďovány následující informace:

• Externí rozhraní

• Adresy serveru DNS

• Detaily proxy serveru

• IP adresa konektoru

• Přihlašovací údaje brány (uživatelské jméno a heslo)

Skript TCL provádí následující konfigurace:

• Skupina virtuálních portů – vyžadováno pro konfiguraci guestshell.

• Guestshell (rozcestník)

• TŘÍDA ''NETCONF''

• Konfigurace pasti SNMP – vyžaduje se pro oznámení od systému Cisco IOS XE.

• Route IP – směrování provozu souvisejícího s konektorem prostřednictvím skupiny virtuálních portů.

Skript TCL provádí následující konfigurace:

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

Před instalací zvažte, že konektor nelze použít s následujícími prvky:

• Platformy směrovačů integrovaných služeb Cisco 1100
• Platformy nakonfigurované v režimu vysoké dostupnosti (HA)
• Platformy nakonfigurované v režimu Controller pro sítě SD-WAN

Při konfiguraci směrovače pro použití s konektorovou aplikací zvažte následující:

• IOS XE používá proxy ARP pro směrování provozu do shell hosta. Nezakažte tuto funkci konfigurací žádný proxy server IP.
• Nepoužívejte překlad síťových adres (NAT) na platformách, které jsou nakonfigurovány pro CUBE. Proto nakonfigurujte aplikaci konektoru s adresou IP směrovatelnou. To znamená, že nemůže sdílet adresu rozhraní směrovače.

Připravte zařízení na registraci brány:

• Přístup k centru Control Hub jako správce organizace

• IP adresa, uživatelské jméno a heslo pro zařízení, která chcete konfigurovat.

• Verze Cisco IOS XE:

  • Místní brány – Cisco IOS XE Bengaluru 17.6.1a nebo novější

  • Brány Survivability – Cisco IOS XE Dublin 17.12.3 nebo novější

  Doporučené verze naleznete na stránce Cisco Software Research. Vyhledejte platformu a vyberte jednu z „navrhovaných“ verzí.

• Systémové předpoklady

  • Minimální volná paměť – 256 MB

  • Minimální místo na disku – pevný disk (SSD) připojený k bráně, který se používá pro instalaci konektoru, musí mít volné místo 2 000 MB. Bootflash musí mít také 50MB volného místa. Používá se k ukládání protokolů a souborů RPM.

    Pokud není k bráně připojen pevný disk, použije se pro instalaci konektoru bootflash. Bootflash musí mít 2000 MB volného místa.

Pokud je bootflash vašeho routeru 4 GB a je tam méně než 2 GB dostupné kapacity (minimální kapacita), odstraňte všechny binární obrázky IOS (.bin) s výjimkou právě spuštěného souboru. Po odstranění souborů uvolněte prostor navíc.

Pomocí následujících kroků rozbalte binární obraz a spusťte z komponent:

1. Vytvořit nový adresář pomocí mkdir bootflash:/image.

2. Rozbalit binární obraz IOS pomocí request platform software package expand file bootflash:/<image>.bin to bootflash:/image.

3. V režimu konfigurace odeberte aktuální možnosti spouštění pomocí no boot system.

4. Konfigurace nového spouštěcího příkazu: boot system bootflash:/image/packages.conf.

5. Ukončete konfigurační režim, uložte konfiguraci a restartujte ji.

6. Po restartování směrovače použijte show version k ověření, že směrovač byl spuštěn z bootflash:/image/packages.conf. Pokud ano:

   1. Ověřte, zda bootflash:/sysboot adresář je prázdný.

   2. Odstraňte zbývající binární obrázek systému IOS.

   3. Odstranit všechny základní obrázky pomocí delete /f /r bootflash:/core/*.

   4. Smazat soubory protokolu trasování pomocí delete /f /r bootflash:/tracelogs/*.

   5. Pokud je na disku stále nedostatek místa, zkontrolujte zbývající soubory v bootflash: a odstranit všechny ostatní nepodstatné soubory, jako jsou protokoly a CDRS.

• Podporovaný směrovač Cisco, který je připojen k síti s cestou k internetu. Základní konfigurace musí mít následující:

  • Server DNS je nakonfigurován pro řešení názvů veřejných domén.

  • Ke konfiguraci serveru DNS použijte následující příkaz:

    • název IP serveru <IP address="">

  • HTTP Proxy server, pokud chcete kontaktovat Internet prostřednictvím proxy serveru.

  • Přihlašovací údaje brány: Přihlašovací údaje (uživatelské jméno a heslo) s oprávněním úrovně 15, které může konektor použít pro přístup k bráně prostřednictvím rozhraní NETCONF.

    Chcete-li ověřit a autorizovat přístup k NETCONF, ujistěte se, že jsou výchozí seznamy aaa nakonfigurovány tak, jak je znázorněno v příkladu. Ve výchozím seznamu můžete použít libovolnou možnost metody. K ovládání přístupu k síti NETCONF nelze použít seznam pojmenovaných aaa. Pokud výchozí seznamy nejsou správně nakonfigurovány, v systémovém protokolu se může zobrazit chybová zpráva „neplatný seznam metod“.

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

  Předpoklady sítě

  • IP adresa konektoru musí být ve stejné síti jako adresa zvolená pro externí připojení. Může to být adresa soukromé sítě, ale musí mít přístup k internetu pomocí protokolu HTTPS.

    Pokud jako místní bránu používáte Virtual CUBE on Amazon Web Services (AWS), podívejte se na Přiřazení sekundární IP adresy pro Virtual CUBE na AWS , kde najdete kroky, jak přiřadit sekundární IP adresu pro použití konektoru.

  • Chcete-li dokončit proces registrace, musíte být připojeni k centru Control Hub a místním zařízením.

  • s pro služby Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportní protokoly: Transport Layer Security (TLS) verze 1.2

  • Importujte balíček veřejné certifikační autority IOS. Certifikáty přidané do fondu důvěryhodnosti brány se používají k ověření přístupu k serverům Webex. K importu balíčku použijte následující příkaz konfigurace.

    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: 

Celkový stav konektoru zobrazeného v centru Control Hub závisí na stavu konektorů telemetrie a správy na spravované bráně.

Stavy konektoru v prostředí Control Hub	Popis
Online	Udává, že je konektor Připojen ke cloudu Cisco Webex.
Offline	Udává, že konektor není připojen ke cloudu Cisco Webex.
Pozastaveno	Udává, že je konektor připojen, ale je dočasně pozastaven.

Místní správa konektoru pro správu

Po úspěšné instalaci konektoru můžete s bránou používat službu Webex Calling. V případě potřeby můžete aktualizovat několik nastavení konektoru pomocí možností dostupných v nabídce skriptu:

Skript můžete kdykoli znovu spustit pomocí následujícího příkazu: 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:

Stav zobrazení

Pomocí nástroje s: Display Status Page možnost nabídky. Systém zobrazuje stav různých modulů konektoru.

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

Povolit guestshell

Povolit cloudový konektor pomocí e: Enable Guestshell možnost nabídky. Tím se změní stav konektoru z INACTIVE do ACTIVE.

Zakázat guestshell

Zakázat cloudový konektor pomocí d: Disable Guestshell možnost nabídky. Tím se změní stav konektoru z ACTIVE do INACTIVE.

Odinstalovat konektor

Odinstalujte cloudový konektor pomocí u: Uninstall Connector možnost nabídky. Tím se odstraní všechna data v kontejneru Guestshell a odstraní se všechny konfigurace, které se týkají cloudového konektoru.

Shromáždit protokoly

Shromažďujte protokoly pomocí l: Collect Logs možnost nabídky. Systém zobrazuje umístění, kde jsou tyto protokoly uloženy po shromáždění protokolů.

Pokud máte aktivní případ podpory ve službě Cisco TAC, můžete pomocí příkazu připojit protokoly přímo k žádosti o službu. copy bootflash:/guest-share/<log-filename> scp://<case-number>:<cxd-token>@cxd.cisco.com .

Následuje ukázkový příkaz:

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

Vymazat protokoly

Vymazat všechny soubory protokolu v zařízení pomocí r: Clear Logs možnost nabídky. Tím se odstraní všechny existující protokoly kromě nejnovějších protokolů skriptu a konektorů Tcl.

Zobrazení a úprava nastavení cloudového konektoru

Proveďte následující změny stávajících nastavení cloudového konektoru pomocí v: View and Modify Cloud Connector Settings možnost nabídky.

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

Aktualizovat přihlašovací údaje brány

Aktualizujte uživatelské jméno a heslo brány pomocí c: Update Gateway Credentials možnost nabídky.

Aktualizovat externí rozhraní

Změňte rozhraní, ke kterému je konektor vázán, a adresu IP konektoru pomocí v: View and Modify Cloud Connector Settings možnost nabídky.

Aktualizovat podrobnosti o proxy serveru

Můžete provádět následující úkoly pomocí p: Update Proxy Details možnost nabídky:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Aktualizovat ověřovací klíč balíčku konektoru

Pokud máte technický problém a jste požádáni technikem podpory o výměnu ověřovacího klíče balíčku, nahrajte nový gateway-webex-connectors.gpg soubor do bootflash:/gateway_connector/ a použijte k: Update Connector Package Verification Key možnost nabídky ověřit.

Úprava úrovně protokolu pro konektor správy

Změňte úroveň protokolování konektoru pomocí l: Modify log level for Cloud Connector možnost nabídky a poté vyberte jednu z následujících možností:

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

Správa instance brány:

1. V části SLUŽBY klikněte na možnost Volání a potom na kartu Spravované brány .

2. Pro příslušnou instanci brány klikněte na přilehlé tečky (…) ve sloupci Akce a vyberte příslušnou akci.