Зарегистрировать управляемые шлюзы Cisco IOS в облако Webex

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

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

Существует два типа соединителей:

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

• Соединитель телеметрии

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

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

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

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

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

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

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

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

• IP-адрес соединителя

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

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

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

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

• ЯНГ, НЕТКОНФ

• Конфигурация ловушки 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 для маршрутизации трафика в гостевую оболочку. Не отключайте эту функцию, настроив нет ip-прокси-arp.
• Не используйте преобразование сетевых адресов (NAT) на платформах, настроенных для 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 . Найдите платформу и выберите один из выпусков "Suggested".

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

  • Минимальная свободная память: 256 МБ

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

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

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

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

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

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

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

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

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

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

    Если в качестве локального шлюза используется виртуальный 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 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 <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: 

Общее состояние соединителя, отображаемого в 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/<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 и соединителей.

Просмотр и изменение настроек соединителя облака

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