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

Соединители шлюзов установлены в контейнере Cisco IOS XE GuestShell.

Разъемы бывают двух типов:

• Соединитель управления

• Разъем телеметрии

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

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

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

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

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

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

• адреса сервера DNS

• Сведения о прокси

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

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

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

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

• Гостевая оболочка

• NETCONF Ян

• Конфигурация прерывания SNMP - требуется для уведомлений от Cisco IOS XE.

• IP Route - для маршрутизации трафика, связанного с соединителем, через группу виртуальных портов.

Сценарий 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
!
 

Для примера конфигурации: GigabitEthernet1 назначается в качестве внешнего интерфейса. IP-адрес GigabitEthernet1 - 10.65.125.142. IP-адрес соединителя должен быть в той же сети, что и выбранный для внешнего подключения. Это может быть сетевой адрес, но он должен иметь доступ к Интернету по протоколу HTTP. Сценарий TCL отслеживает и сохраняет изменения конфигурации в конфигурации запуска Cisco IOS XE. В процессе удаления сценарий TCL удаляет изменения конфигурации.

Перед установкой примите во внимание, что приложение соединителя не может использоваться со следующими параметрами:

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

Для голосовых шлюзов Cisco IOS, таких как VG400, не требуется устанавливать приложение соединителя. Его можно полностью настроить и управлять с помощью Control Hub.

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

• IOS XE использует прокси-сервер ARP для маршрутизации трафика в гостевую оболочку. Не отключайте эту функцию, настроив нет ip-прокси-arp.
• Не используйте преобразование сетевых адресов (NAT) на платформах, настроенных для CUBE. Поэтому настройте приложение соединителя с маршрутизируемым IP-адресом. То есть он не может предоставлять совместный доступ к адресу интерфейса маршрутизатора.

Подготовьте устройство к регистрации на шлюзе.

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

• IP-адрес, имя пользователя и пароль для устройств, которые необходимо настроить.

• Версия Cisco IOS XE:

  • Локальные шлюзы: Cisco IOS XE Bengaluru 17.6.1a или более поздняя версия

  • Шлюзы устойчивости: Cisco IOS XE Cupertino 17.9.3a или более поздняя версия

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

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

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

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

    Если жесткий диск не прикреплен к шлюзу, для установки соединителя используется bootflash. В таком случае, bootflash должен иметь свободное пространство 2000 МБ.

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

Ниже приведены необязательные шаги, чтобы освободить место на диске bootflash. Выполните следующие действия и измените загрузочные файлы на режим установки, только если: Маршрутизатор использует режим пакетной загрузки (загрузка с .bin). .pkgs еще не извлечен (режим установки).

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

1. Создайте новый каталог с помощью mkdir bootflash:/image.

2. Раскройте двоичный образ IOS с помощью request platform software package expand file bootflash:/<image>.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-прокси-сервер, если вы хотите подключиться к Интернету через прокси-сервер.

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

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

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

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

  Требования к сети

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

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

  • Чтобы завершить процесс регистрации, необходимо подключиться к Control Hub и локальным устройствам.

  • URL-адреса для служб Webex :

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Транспортные протоколы: Transport Layer Security (TLS) версии 1.2

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

    crypto pki trustpool import url http://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 <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: 

Состояния соединителей соединителей управления и телеметрии отображаются на странице сведений о соединителе.

• Войдите в клиентскую организацию по адресу https://admin.webex.com.

• Перейти к Службы > Вызовы.

• Щелкните Управление шлюзами.

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

После успешной установки соединителя 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:

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

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

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

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

Удалить коннектор

Удалите облачный коннектор с помощью u: Uninstall Connector пункт меню. При этом будут удалены все данные в контейнере гостевой оболочки и все конфигурации, связанные с облачным соединителем.

Сбор журналов

Соберите журналы с помощью l: Collect Logs пункт меню. Система отображает место хранения этих журналов после сбора журналов.

При наличии активного обращения в службу поддержки Cisco TAC можно прикрепить журналы непосредственно к запросу на обслуживание с помощью команды copy bootflash:/guest-share/<log-filename> scp://<case-number>:<cxd-token>@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. В разделе СЛУЖБЫ щелкните Вызовы, а затем откройте вкладку Управляемые шлюзы .

2. Для соответствующего экземпляра шлюза щелкните соседние точки ( … ) в Действия столбец и выберите подходящее действие.