Конекторите на шлюза са малки приложения, които се изпълняват в GuestShell на шлюза, за да поддържат връзка с Control Hub, да координират събития и да събират информация за състоянието. За повече информация относно GuestShell, вижте GuestShell.

Шлюзовите конектори са инсталирани на контейнера Cisco IOS XE GuestShell.

Има два вида конектори:

• Конектор за управление

• Телеметричен конектор

Интерактивен TCL скрипт, управляван от меню, помага за настройването на GuestShell, както и за инсталирането и поддръжката на конектора за управление.

Конекторът за управление се грижи за регистрацията на шлюз и управлението на жизнения цикъл на телеметричния конектор.

След успешно завършване на регистрацията, конекторът за управление изтегля и инсталира най-новия телеметричен конектор.

Следната графика показва как различните компоненти се свързват в решението Webex Calling:

Като част от изпълнението на TCL скрипта, от потребителя се събира следната информация:

• Външен интерфейс

• Адреси на DNS сървъри

• Детайли за прокси сървъра

• IP адрес на конектора

• Идентификационни данни за шлюз (потребителско име и парола)

TCL скриптът изпълнява следните конфигурации:

• Група виртуални портове – Задължително за конфигурация на гостова обвивка.

• Гостшел

• NETCONF Ян

• Конфигурация на SNMP Trap – Задължителна за известия от Cisco IOS XE.

• IP маршрут – За маршрутизиране на трафик, свързан с конектора, през група виртуални портове.

TCL скриптът изпълнява следните конфигурации:

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

Преди инсталирането, имайте предвид, че приложението за конектори не може да се използва със следното:

• Платформи за рутери с интегрирани услуги Cisco 1100
• Платформи, конфигурирани в режим на висока достъпност (HA)
• Платформи, конфигурирани в режим на контролер за SD-WAN мрежи

Обърнете внимание на следното, когато конфигурирате рутера си за използване с приложение за конектор:

• IOS XE използва прокси ARP, за да насочва трафика към гостовата обвивка. Не конфигурирайте командата no ip proxy-arp, за да деактивирате тази функция.

• Не използвайте превод на мрежови адреси (NAT) на платформи, които са конфигурирани за Cisco Unified Border Element (CUBE). Следователно, конфигурирайте приложението за конектор с маршрутизируем IP адрес. Тоест, не може да споделя адреса на интерфейса на рутера.

Подгответе устройството си за регистрация в шлюз:

• Достъп до Control Hub като администратор на организацията

• IP адрес, потребителско име и парола за устройствата, които искате да конфигурирате.

• Версия на Cisco IOS XE:

  • Локални шлюзове—Cisco IOS XE Bengaluru 17.6.1a или по-нова версия

  • Шлюзове за оцеляване — Cisco IOS XE Dublin 17.12.3 или по-нова версия

  За препоръчителните версии вижте Cisco Software Research. Потърсете платформата и изберете една от предложените версии.

• Системни предварителни изисквания

  • Минимална свободна памет — 256 MB

  • Минимално дисково пространство – Твърдият диск (SSD), свързан към шлюза, който се използва за инсталиране на конектора, трябва да има 2000 MB свободно пространство. Също така, bootflash паметта трябва да има 50MB свободно място. Използва се за съхранение на лог файлове и RPM файлове.

    Ако към шлюза не е свързан твърд диск, за инсталиране на конектора се използва bootflash. След това, bootflash паметта трябва да има 2000MB свободно място.

Ако флаш паметта на вашия рутер е 4GB и има по-малко от 2GB наличен капацитет (минималният капацитет), изтрийте всички двоични (.bin) образи на IOS, с изключение на този, който се изпълнява в момента. След като изтриете файловете, освободете допълнително място.

Използвайте следните стъпки, за да разширите двоичния образ и да стартирате от компоненти:

1. Създайте нова директория, използвайки .mkdir bootflash:/image

2. Разгънете двоичното изображение на IOS с помощта на.request platform software package expand file bootflash:/.bin to bootflash:/image

3. В режим на конфигурация премахнете текущите опции за зареждане, като използвате.no boot system

4. Конфигурирайте нова команда за зареждане: boot system bootflash:/image/packages.conf.

5. Излезте от режим на конфигурация, запазете конфигурацията и рестартирайте.

6. След като рутерът се рестартира, използвайтеshow version, за да проверите дали рутерът е стартирал от bootflash:/image/packages.conf. Ако е така:

   1. Проверете дали директорията bootflash:/sysboot е празна.

   2. Изтрийте останалия двоичен образ на IOS.

   3. Изтрийте всички основни изображения, използвайки .delete /f /r bootflash:/core/*

   4. Изтрийте файловете с журнали за проследяване, като използвате.delete /f /r bootflash:/tracelogs/*

   5. Ако все още няма достатъчно място на диска, прегледайте останалите файлове в bootflash паметта: и изтрийте всички други несъществени файлове, като например лог файлове и CDR файлове.

• Поддържан рутер на Cisco, който е свързан към мрежа с път към интернет. Основната конфигурация трябва да има следното:

  • DNS сървърът е конфигуриран да разрешава имена на публични домейни.

  • За да конфигурирате DNS сървъра, използвайте следната команда:

    • IP сървър за имена <IP address>

  • HTTP прокси сървър, ако искате да се свържете с интернет чрез прокси.

  • Идентификационни данни за шлюз: Конекторът изисква локални идентификационни данни (потребителско име и парола) с ниво на привилегии 15 за достъп до шлюза чрез неговия NETCONF интерфейс.

    За да удостоверите и оторизирате достъпа до NETCONF, уверете се, че списъците с aaa по подразбиране са конфигурирани, както е показано в следния пример. Само командите, изброени в този документ, са валидирани и се поддържат за управляеми шлюзове. Конфигурации, включващи други методи (например TACACS или ISE), не са валидирани и не се поддържат в момента.

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

  Мрежови предварителни изисквания

  • IP адресът на конектора трябва да е в същата мрежа като избраната за външна свързаност. Може да е адрес в частна мрежа, но трябва да има HTTPS достъп до интернет.

    Ако използвате Virtual CUBE на Amazon Web Services (AWS) като ваш локален шлюз, вижте Свързване на вторичен IP адрес за Virtual CUBE на AWS за стъпки как да свържете вторичен IP адрес за използване на конектор.

  • Бъдете свързани към Control Hub и локалните устройства, за да завършите процеса на регистрация.

  • URL адреси за услугите на Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Транспортни протоколи: Защита на транспортния слой (TLS) версия 1.2

  • Импортирайте пакета на публичния сертифициращ орган за IOS. Сертификатите, добавени към пула за доверие на шлюза, се използват за проверка на достъпа до сървърите на Webex. Използвайте следната команда за конфигуриране, за да импортирате пакета.

    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: 

Общото състояние на конектора, показано в контролния център, зависи от състоянието на телеметричните и управляващите конектори на управлявания шлюз.

Състояния на конекторите в контролния център	Описание
Онлайн	Показва, че конекторът е свързан към облака Cisco Webex.
Офлайн	Показва, че конекторът не е свързан към облака Cisco Webex.
На пауза	Показва, че конекторът е свързан, но е временно на пауза.

Локално администриране на конектора за управление

Можете да използвате Webex Calling с вашия шлюз, след като инсталирате конектора успешно. Ако е необходимо, можете да актуализирате редица настройки на конектора, като използвате опциите, налични в менюто на скрипта:

Можете да рестартирате скрипта по всяко време, като използвате следната команда: 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:

Състояние на дисплея

Използвайте опцията от менюто s: Display Status Page. Системата показва състоянието на различните конекторни модули.

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

Активиране на Guestshell

Активирайте облачния конектор, като използвате опцията от менюто e: Enable Guestshell. Това променя състоянието на конектора от INACTIVE на ACTIVE.

Деактивиране на Guestshell

Деактивирайте облачния конектор, като използвате опцията от менюто d: Disable Guestshell. Това променя състоянието на конектора от ACTIVE на INACTIVE.

Деинсталиране на конектор

Деинсталирайте облачния конектор, като използвате опцията от менюто u: Uninstall Connector. Това изтрива всички данни в контейнера Guestshell и премахва всички конфигурации, свързани с облачния конектор.

Събиране на регистрационни файлове

Съберете лог файловете, като използвате опцията от менюто l: Collect Logs. Системата показва мястото, където се съхраняват тези лог файлове, след като ги събере.

Ако имате активна заявка за поддръжка към Cisco TAC, можете да прикачите лог файловете директно към заявката си за обслужване, като използвате командата copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Следва примерна команда:

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

Изчистване на лог файлове

Изчистете всички лог файлове в устройството, като използвате опцията от менюто r: Clear Logs. Това изтрива всички съществуващи лог файлове, с изключение на най-новите лог файлове на TCL скрипта и конекторите.

Преглед и промяна на настройките на облачния конектор

Направете следните промени в съществуващите настройки на облачен конектор, като използвате опцията от менюто 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

Актуализиране на идентификационните данни на шлюза

Актуализирайте потребителското име и паролата за шлюза, като използвате опцията от менюто c: Update Gateway Credentials.

Актуализиране на външния интерфейс

Променете интерфейса, към който е свързан конекторът, и IP адреса на конектора, като използвате опцията от менюто v: View and Modify Cloud Connector Settings.

Актуализиране на подробности за прокси сървъра

Можете да изпълнявате следните задачи, като използвате опцията от менюто p: Update Proxy Details :

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Ключ за проверка на пакета с актуализация на конектора

В случай на технически проблем, ако инженерът по поддръжката поиска да замени ключа за проверка на вашия пакет, качете новия gateway-webex-connectors.gpg файл в bootflash:/gateway_connector/ и използвайте опцията от менюто k: Update Connector Package Verification Key, за да го проверите.

Промяна на нивото на регистриране за конектора за управление

Променете нивото на регистриране за конектора, като използвате опцията от менюто l: Modify log level for Cloud Connector, след което изберете една от следните опции:

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

За да управлявате вашия екземпляр на шлюз:

1. Влезте в Control Hub.

2. Отидете на УСЛУГИ, щракнете върху Повикванияи след това щракнете върху Управлявани шлюзове.

3. За съответния екземпляр на шлюз щракнете върху … в колоната Действия и изберете съответното действие.