Konektory brány jsou malé aplikace, které běží v GuestShellu brány a udržují připojení k Control Hubu, koordinují události a shromažďují informace o stavu. Více informací o GuestShellu naleznete v GuestShell.

Konektory brány jsou nainstalovány v kontejneru Cisco IOS XE GuestShell.

Existují dva typy konektorů:

• Konektor pro správu

• Konektor telemetrie

Interaktivní skript TCL s ovládáním pomocí menu pomáhá s nastavením GuestShellu a také s instalací a údržbou 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 si konektor pro správu stáhne a nainstaluje nejnovější telemetrický konektor.

Následující obrázek znázorňuje, jak se různé komponenty propojují v řešení Webex Calling:

V rámci provádění skriptu TCL se od uživatele shromažďují následující informace:

• Externí rozhraní

• Adresy DNS serverů

• Podrobnosti o 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 guestshellu.

• Hostovská schránka

• NETCONF Yang

• Konfigurace SNMP Trap – Vyžadováno pro oznámení ze systému Cisco IOS XE.

• IP trasa – Směrování provozu souvisejícího s konektorem 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
!
 

Před instalací vezměte v úvahu, že aplikaci konektoru nelze použít s následujícími:

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

Při konfiguraci routeru pro použití s aplikací konektoru zvažte následující:

• IOS XE používá proxy ARP ke směrování provozu do hostovaného shellu. Nekonfigurujte příkaz no ip proxy-arp pro zakázání této funkce.

• Nepoužívejte překlad síťových adres (NAT) na platformách, které jsou konfigurovány pro Cisco Unified Border Element (CUBE). Proto nakonfigurujte aplikaci konektoru s routovatelnou IP adresou. To znamená, že nemůže sdílet adresu rozhraní routeru.

Připravte si zařízení k registraci brány:

• Přístup k Control Hubu jako administrátor 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 pro zajištění odolnosti – Cisco IOS XE Dublin 17.12.3 nebo novější

  Doporučené verze naleznete na Cisco Software Research. Vyhledejte platformu a vyberte jedno z doporučených vydání.

• 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 2000 MB volného místa. Také bootflash musí mít 50 MB volného místa. Používá se k ukládání protokolů a RPM souborů.

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

Pokud má bootflash vašeho routeru 4 GB a k dispozici je méně než 2 GB (minimální kapacita), smažte všechny binární obrazy IOS (.bin) kromě toho, který je aktuálně spuštěný. Po odstranění souborů uvolněte další místo.

K rozbalení binárního obrazu a spuštění z komponent použijte následující kroky:

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

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

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

4. Nakonfigurujte nový bootovací příkaz: boot system bootflash:/image/packages.conf.

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

6. Jakmile se router restartuje, ověřte pomocíshow version, zda se router spustil z bootflash:/image/packages.conf. Pokud ano:

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

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

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

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

   5. Pokud stále není dostatek místa na disku, zkontrolujte zbývající soubory v bootflash paměti: a smažte všechny ostatní nepodstatné soubory, jako jsou protokoly a soubory CDR.

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

  • DNS server je nakonfigurován pro překlad veřejných doménových jmen.

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

    • IP jmenný server <IP address>

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

  • Přihlašovací údaje k bráně: Konektor vyžaduje pro přístup k bráně prostřednictvím rozhraní NETCONF lokální přihlašovací údaje (uživatelské jméno a heslo) s úrovní oprávnění 15.

    Pro ověření a autorizaci přístupu k NETCONF se ujistěte, že jsou výchozí seznamy AAA nakonfigurovány, jak je znázorněno v následujícím příkladu. Pouze příkazy uvedené v tomto dokumentu byly ověřeny a jsou podporovány pro spravované brány. Konfigurace zahrnující jiné metody (například TACACS nebo ISE) nebyly ověřeny a v současné době nejsou podporovány.

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

  Předpoklady pro síť

  • IP adresa konektoru musí být ve stejné síti jako ta, která je zvolena pro externí připojení. Může se jednat o adresu soukromé sítě, ale musí mít přístup k internetu přes HTTPS.

    Pokud jako lokální bránu používáte Virtual CUBE na Amazon Web Services (AWS), postupujte podle pokynů k přidružení sekundární IP adresy pro použití konektoru v části Přidružení sekundární IP adresy pro Virtual CUBE na AWS.

  • Pro dokončení procesu registrace se připojte k Control Hubu a místním zařízením.

  • URL adresy pro služby Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Transportní protokoly: Zabezpečení transportní vrstvy (TLS) verze 1.2

  • Importujte balíček veřejné certifikační autority IOS. Certifikáty přidané do fondu důvěryhodných bran se používají k ověřování přístupu k serverům Webex. Pro import balíčku použijte následující konfigurační příkaz.

    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: 

Celkový stav konektoru zobrazený v Control Hubu závisí na stavu telemetrických a řídicích konektorů na spravované bráně.

Stavy konektorů v Control Hubu	Popis
Online	Označuje, že konektor je připojen ke cloudu Cisco Webex.
Offline	Označuje, že konektor není připojen ke cloudu Cisco Webex.
Pozastaveno	Označuje, že konektor je připojen, ale je dočasně pozastaven.

Lokální 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 řadu 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í

Použijte možnost nabídky s: Display Status Page. Systém zobrazuje stav různých konektorových modulů.

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

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

Zakázat guestshell

Zakažte cloudový konektor pomocí možnosti nabídky d: Disable Guestshell. Tím se změní stav konektoru z ACTIVE na INACTIVE.

Odinstalace konektoru

Odinstalujte cloudový konektor pomocí možnosti nabídky u: Uninstall Connector. Tím se odstraní všechna data v kontejneru Guestshell a odstraní se všechny konfigurace související s cloudovým konektorem.

Shromáždit protokoly

Shromážděte protokoly pomocí možnosti nabídky l: Collect Logs. Systém po shromáždění těchto protokolů zobrazí umístění, kde jsou tyto protokoly uloženy.

Pokud máte aktivní žádost o podporu u Cisco TAC, můžete protokoly připojit přímo k požadavku na službu pomocí příkazu copy bootflash:/guest-share/ scp://:@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í možnosti nabídky r: Clear Logs. Tím se smažou všechny existující protokoly kromě nejnovějších protokolů skriptu TCL a konektorů.

Zobrazení a úprava nastavení cloudového konektoru

Proveďte následující změny v existujícím nastavení cloudového konektoru pomocí možnosti nabídky 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

Aktualizace přihlašovacích údajů brány

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

Aktualizace externího rozhraní

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

Aktualizovat podrobnosti o proxy serveru

Pomocí možnosti nabídky p: Update Proxy Details můžete provádět následující úkoly:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Ověřovací klíč balíčku aktualizačního konektoru

V případě technického problému, pokud technik podpory požádá o výměnu ověřovacího klíče vašeho balíčku, nahrajte nový soubor gateway-webex-connectors.gpg do bootflash:/gateway_connector/ a ověřte jej pomocí možnosti nabídky k: Update Connector Package Verification Key.

Úprava úrovně protokolování pro Management Connector

Změňte úroveň protokolování pro konektor pomocí možnosti nabídky l: Modify log level for Cloud Connector 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. Přihlaste se do ovládacího centra.

2. Přejděte na SLUŽBY, klikněte na Volánía poté klikněte na Spravované brány.

3. Pro příslušnou instanci brány klikněte na … ve sloupci Akce a vyberte příslušnou akci.