Соединители шлюзов — это небольшие приложения, которые запущены в шлюзе 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
• Платформы, настроенные в режиме высокой доступности
• Платформы, настроенные в режиме контроллера для сетей SD-WAN

При настройке маршрутизатора для использования с приложением соединителя учтите приведенное ниже.

• IOS XE использует ARP-прокси для маршрутизации трафика в гостевую оболочку. Для отключения этой функции не настройте соединение без прокси-сервера IP .

• Не используйте преобразование сетевых адресов (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. Найдите платформу и выберите один из предложенных выпусков.

• Предварительные требования системы

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

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

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

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

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

  • Чтобы настроить сервер DNS, используйте следующую команду:

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

  • Прокси-сервер HTTP, если необходимо подключиться к Интернету через прокси-сервер.

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

    Для аутентификации и авторизации доступа к NETCONF убедитесь, что списки AAA по умолчанию настроены, как показано в примере. Невозможно использовать список с именем AAA для управления доступом NETCONF. Если списки по умолчанию настроены неверно, в системном журнале может отображаться сообщение об ошибке "Недопустимый список методов". Возможно, вы захотите использовать другие методы вместе с локальными для AAA, это может быть достигнуто, однако потребуется обновление определенной конфигурации.

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

  Предварительные требования к сети

  • IP-адрес соединителя должен находиться в той же сети, что и адрес, выбранный для внешнего подключения. Это может быть адрес частной сети, но он должен иметь доступ к Интернету по протоколу HTTPS.

    Если в качестве локального шлюза используется виртуальный CUBE в веб-службах Amazon (AWS), см. статью Связывание дополнительного IP-адреса для виртуального 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.

Отключить 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 и соединителей.

Просмотр и изменение настроек 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 меню для проверки.

Изменение уровня журнала для Management Connector

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