Зареєструвати керовані шлюзи Cisco IOS у хмару Webex

З’єднувачі шлюзу — це невеликі програми, які запускаються в шлюзі GuestShell для підтримки з’єднання з Control Hub, координування подій і збору інформації про стан. Додаткову інформацію про GuestShell див. в GuestShell.

З’єднувачі шлюзу встановлено на контейнері Cisco IOS XE GuestShell.

Існує два типи з’єднувачів:

• З’єднувач керування

• З’єднувач телеметрії

Інтерактивний сценарій TCL з керуванням меню допомагає налаштувати GuestShell, а також встановити та підтримувати з’єднувач керування.

З’єднувач керування дбає про реєстрацію шлюзу та керування життєвим циклом з’єднувача телеметрії.

Після успішного завершення реєстрації з’єднувач керування завантажує та інсталює останній з’єднувач телеметрії.

Наведений далі графік показує, як різні компоненти підключаються в рішенні Webex Calling.

У рамках виконання сценарію TCL від користувача збирається така інформація:

• Зовнішній інтерфейс

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

• Відомості про проксі

• IP-адреса з’єднувача

• Облікові дані шлюзу (ім’я користувача та пароль)

Сценарій TCL виконує такі конфігурації:

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

• Гестшелл

• 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 для маршрутизації трафіку до гостьової оболонки. Не налаштовуйте команду IP-проксі-arp , щоб вимкнути цю функцію.

• Не використовуйте перетворення мережевих адрес (NAT) на платформах, налаштованих для Cisco Unified Border Element (CUBE). Тому налаштуйте програму з’єднувача з IP-адресою, яку можна маршрутизувати. Тобто він не може надати спільний доступ до адреси інтерфейсу маршрутизатора.

Підготуйте свій пристрій до реєстрації шлюзу:

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

• IP-адреса, ім’я користувача та пароль для пристроїв, які потрібно налаштувати.

• Версія Cisco IOS XE:

  • Локальні шлюзи — Cisco IOS XE Bengaluru 17.6.1a або пізнішої версії

  • Шлюзи Survivability — Cisco IOS XE Dublin 17.12.3 або пізнішої версії

  Рекомендовані версії див. в Cisco Software Research. Знайдіть платформу й виберіть один із Запропонованих випусків.

• Обов’язкові умови системи

  • Мінімальна безкоштовна пам’ять — 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 для керування доступом до 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 

Увімкнути Guestshell

Увімкніть з’єднувач хмари за допомогою параметра 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 і з’єднувачів.

Переглянути та змінити налаштування з’єднувача хмари

Внесіть такі зміни до наявних налаштувань з’єднувача хмари за допомогою параметра 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. Перейдіть до СЛУЖБИ, клацніть Виклик, а потім клацніть Керовані шлюзи.

3. Для застосовного екземпляра шлюзу клацніть … у стовпці Дії і виберіть відповідну дію.