Коннекторы шлюза — это небольшие приложения, которые работают в GuestShell шлюза для поддержания соединения с Control Hub, координации событий и сбора информации о состоянии. Более подробную информацию о GuestShell см. в разделе GuestShell.

Разъемы шлюза устанавливаются на контейнере Cisco IOS XE GuestShell.

Существует два типа разъемов:

• Управляющий разъем

• Телеметрический разъем

Интерактивный скрипт TCL, управляемый с помощью меню, помогает настроить GuestShell, а также установить и обслуживать коннектор управления.

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

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

На следующем рисунке показано, как различные компоненты соединяются в решении Webex Calling:

В ходе выполнения скрипта TCL от пользователя собирается следующая информация:

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

• Адреса DNS-серверов

• Данные прокси

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

• Учетные данные шлюза (имя пользователя и пароль)

Скрипт TCL выполняет следующие настройки:

• Группа виртуальных портов — требуется для настройки гостевой оболочки.

• Guestshell

• NETCONF Ян

• Конфигурация SNMP-ловушки — требуется для уведомлений от 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 Bangaluru 17.6.1a или новее.

  • Шлюзы обеспечения отказоустойчивости — Cisco IOS XE Dublin 17.12.3 или более поздняя версия

  Рекомендованные версии см. в Cisco Software Research. Найдите платформу и выберите один из предложенных релизов.

• Системные требования

  • Минимальный объем свободной памяти — 256 МБ

  • Минимальное дисковое пространство. Жесткий диск (SSD), подключенный к шлюзу, который используется для установки разъема, должен иметь 2000 МБ свободного места. Кроме того, на загрузочной флеш-памяти должно быть 50 МБ свободного места. Он используется для хранения журналов и файлов RPM.

    Если к шлюзу не подключен жесткий диск, то для установки разъема используется загрузочная флэш-память. Тогда на загрузочной флеш-памяти должно быть 2000 МБ свободного места.

Если загрузочная флэш-память вашего маршрутизатора составляет 4 ГБ, а доступной емкости менее 2 ГБ (минимальная емкость), удалите все двоичные образы IOS (.bin), кроме того, который в данный момент запущен. После удаления файлов освободите дополнительное место.

Для развертывания двоичного образа и загрузки с компонентов выполните следующие действия:

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. Если места на диске по-прежнему недостаточно, просмотрите оставшиеся файлы в загрузочной флэш-памяти: и удалите все остальные ненужные файлы, такие как журналы и CDR.

• Поддерживаемый маршрутизатор Cisco, подключенный к сети с выходом в Интернет. Базовая конфигурация должна иметь следующее:

  • DNS-сервер настроен на разрешение публичных доменных имен.

  • Для настройки DNS-сервера используйте следующую команду:

    • ip имя-сервер <IP address>

  • HTTP-прокси-сервер, если вы хотите выйти в Интернет через прокси.

  • Учетные данные шлюза: Для доступа к шлюзу через интерфейс NETCONF коннектору требуются локальные учетные данные (имя пользователя и пароль) с уровнем привилегий 15.

    Для аутентификации и авторизации доступа 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: 

Общее состояние коннектора, отображаемое в Control Hub, зависит от состояния коннекторов телеметрии и управления на управляемом шлюзе.

Состояния соединителя в Control Hub	Описание
Онлайн	Указывает, что соединитель подключен к облаку 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 

Включить гостевую оболочку

Включите облачный коннектор с помощью пункта меню e: Enable Guestshell. Это изменяет статус соединителя с INACTIVE на ACTIVE.

Отключить гостевую оболочку

Отключите облачный коннектор с помощью пункта меню 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 и коннекторов.

Просмотр и изменение настроек Cloud Connector

Внесите следующие изменения в существующие настройки облачного коннектора с помощью пункта меню 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. Для соответствующего экземпляра шлюза нажмите … в столбце Действия и выберите соответствующее действие.