Регистрация шлюзов Cisco IOS в Control Hub упрощает управление устройствами и позволяет использовать новые сервисы Webex Calling. Поскольку шлюзы поддерживают соединение с Control Hub, вы можете управлять ими и контролировать их из любой точки мира, как и остальные устройства Webex Calling. Чтобы зарегистрировать шлюз, необходимо установить приложение соединителя управления и убедиться в наличии защищенного соединения с облаком Cisco Webex. После установления соединения вы можете зарегистрировать шлюз, войдя в Control Hub.

Этот процесс не применяется к голосовым шлюзам Cisco IOS, таким как VG400, которые полностью управляются как устройства в Control Hub.

Небольшое приложение-коннектор, известное как GuestShell, отвечает за установление и поддержание соединения между шлюзом и Control Hub. Приложения GuestShell и коннектора настраиваются и устанавливаются с помощью скрипта, который запускается на шлюзе из облака Webex во время процесса регистрации.

Для упрощения процесса установки скрипт добавляет ряд необходимых настроек шлюза.

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