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

• adresa IP 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 hostujícího prostředí.

• Shell hostů

• NETCONF Nebo

• Konfigurace SNMP depeše – vyžadováno pro oznámení ze Cisco IOS XE.

• Směrování IP – Ke směrování provozu souvisejícího s konektory přes skupinu 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
!
 

Pro konfiguraci vzorku: Jako externí rozhraní je přiřazena síť GigabitEthernet1. Adresa adresa IP sítě GigabitEthernet1 je 10.65.125.142. Adresa adresa IP konektoru musí být ve stejné síti jako adresa vybraná pro externí připojení. Může to být síťová adresa, ale musí mít přístup k internetu HTTP. Skript TCL sleduje a ukládá změny konfigurace spouštěcí konfigurace systému Cisco IOS XE. Skript TCL v rámci procesu odinstalace odstraní změny konfigurace.

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

U hlasových bran Cisco IOS, jako je VG400, není nutné instalovat aplikaci konektoru. Můžete jej plně konfigurovat a spravovat prostřednictvím centra Control Hub.

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 Cupertino 17.9.3a nebo novější

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

• Systémové požadavky

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

Následují volitelné kroky k uvolnění místa na disku bootflash. Proveďte následující kroky a změňte zaváděcí soubory do instalačního režimu pouze v případě, že: Router používá zaváděcí režim balíčku (spouštění z .bin). .pkgs již není rozbalen (instalační režim).

Pomocí následujících kroků můžete rozbalit binární obraz a zavést systém ze součástí:

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, že bootflash:/sysboot adresář je prázdný.

   2. Odstraňte zbývající binární obraz 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 dostatek místa, zkontrolujte zbývající soubory pomocí nástroje BootFlash: a odstraňte všechny ostatní nepodstatné soubory, jako jsou protokoly a soubory CDR.

• 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 server DNS použijte následující příkazy:

    • IP jmenný server <IP address="">

    • HTTP Proxy server, pokud se chcete dostat k internetu přes proxy server.

  • proxy server HTTP server, pokud se chcete k Internetu připojit prostřednictvím proxy serveru.

  • Přihlašovací údaje brány: Přihlašovací údaje (uživatelské jméno a heslo) s úrovní oprávnění 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. Můžete použít libovolnou možnost způsobu z výchozího seznamu. K ovládání přístupu k síti NETCONF nelze použít seznam pojmenovaných aaa. Pokud nejsou výchozí seznamy správně nakonfigurovány, může se v systémovém protokolu 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ě

  • Adresa adresa IP konektoru musí být ve stejné síti jako adresa vybraná pro externí připojení. Může to být síťová adresa, ale musí mít přístup k internetu HTTP.

    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.

  • Adresy URL pro služby Webex :

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Přenosové protokoly: TLS (zabezpečení přenášených dat) (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 http://www.cisco.com/security/pki/trs/ios.p7b

Než budete pokračovat v instalaci konektoru pro správu, přesvědčte se, že splňujete všechny požadavky Předpoklady .

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

Stavy konektorů pro správu a telemetrii se zobrazují na stránce s podrobnostmi o konektoru.

• Přihlaste se do organizace zákazníka na adrese https://admin.webex.com.

• Přejít na Služby > Volání.

• Klikněte na možnost Spravovat brány.

Místní správa konektoru Management Connector

Po úspěšné instalaci konektoru můžete s bránou používat službu Webex Calling. V případě potřeby můžete aktualizovat řadu nastavení konektoru pomocí možností dostupných z nabídky 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:

Povolit prostředí Hosté

Povolte konektor cloudu pomocí možnosti e: Enable Guestshell možnost nabídky. Tato akce změní stav konektoru z INACTIVE do ACTIVE.

Zakázat Guesthell

Zakažte konektor cloudu pomocí d: Disable Guestshell možnost nabídky. Tato akce změní stav konektoru z ACTIVE do INACTIVE.

Odinstalovat konektor

Odinstalujte cloudový konektor pomocí u: Uninstall Connector možnost nabídky. Tato akce odstraní všechna data v kontejneru Guesthell a odebere všechny konfigurace, které souvisejí s cloudovým konektorem.

Shromáždit protokoly

Sbírejte protokoly pomocí l: Collect Logs možnost nabídky. Po shromáždění protokolů systém zobrazí umístění, kde jsou tyto protokoly uloženy.

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

Vymažte všechny soubory protokolu v zařízení pomocí funkce r: Clear Logs možnost nabídky. Tato akce odstraní všechny stávající protokoly kromě nejnovějších protokolů skriptu a konektorů Tcl.

Zobrazte a upravte nastavení konektoru cloudu

Proveďte následující změny stávajícího 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

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

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

Aktualizujte externí rozhraní

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

Aktualizujte podrobnosti o proxy serveru

Pomocí ovladače můžete provádět následující úlohy 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

Aktualizujte 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 k ověření.

Upravte úroveň protokolu pro konektor pro správu

Změňte úroveň protokolování pro konektor pomocí funkce l: Modify log level for Cloud Connector možnost nabídky a potom 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 sousední tečky ( … ) v nabídce Akce a vyberte požadovanou akci.