WLC-Series. Руководство по обновлению ПО. Версия 1.19.2

Введение

Аннотация

В данном руководстве описаны процессы обновления компонентов программного обеспечения контроллера WLC с учетом особенностей конкретных моделей и предыдущих версий программного обеспечения, используемых обновляемым устройством.Целевая аудитория

Данное руководство предназначено для технического персонала, выполняющего обновление устройства посредством интерфейса командной строки (CLI).

Условные обозначения

Текст в рамке

Примечания и предупреждения

Создание резервной копии текущей конфигурации

Перед началом работ по обновлению ПО на контроллере WLC необходимо сделать резервную копию текущей конфигурации.

Копирование текущей конфигурации с контроллера WLC возможно как с использованием протоколов удаленного копирования файлов, так и на локально подключенные USB/MMC-носители.

Подготовка

Для создания резервной копии текущей конфигурации контроллера с использованием серверов удаленного копирования файлов необходимо:

1. Запустить соответствующий сервер на ПК/сервере в сети.
2. Обеспечить возможность сохранения файлов в рабочем разделе сервера.
3. Обеспечить IP-связность между обновляемым контроллером WLC и сервером удаленного копирования файлов (маршрутизация).
4. Обеспечить работу протокола удаленного копирования между WLC и сервером удаленного копирования файлов (промежуточные firewall).
5. При необходимости (для протоколов ftp, sftp, scp, http) узнать имя пользователя и пароль для записи необходимого файла.

Для создания резервной копии текущей конфигурации контроллера на локально подключенный USB/MMC-носитель необходимо:

1. Отформатировать раздел USB/MMC-носителя в формате FAT32.
2. Подключить USB/MMC-носитель в соответствующий слот WLC.

Копирование файла с резервной копией конфигурации

С использованием протоколов удаленного копирования файлов

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

• <config-file-name> – имя файла, с которым будет сохранена текущая конфигурация контроллера;
• <tftp-server-ip> – IP-адрес используемого TFTP-сервера;
• <ftp-username> – имя пользователя на FTP-сервере;
• <ftp-userpassword> – пароль пользователя на FTP-сервере;
• <ftp-server-ip> – IP-адрес используемого FTP-сервера;
• <sftp-username> – имя пользователя на SFTP-сервере;
• <sftp-userpassword> – пароль пользователя на SFTP-сервере;
• <sftp-server-ip> – IP-адрес используемого SFTP-сервера;
• <scp-username> – имя пользователя на SCP-сервере;
• <ftp-userpassword> – пароль пользователя на FTP-сервере;
• <scp-server-ip> – IP-адрес используемого SCP-сервера;
• <http-username> – имя пользователя на HTTP-сервере;
• <http-userpassword> – пароль пользователя на HTTP-сервере;
• <http-server-ip> – IP-адрес используемого HTTP-сервера.

На локально подключенный USB/MMC-носитель

1. Определить метку тома подключенного USB/MMC-накопителя:

2. Скопировать файл на используемый USB/MMC-накопитель:

• <config-file-name> – имя файла, с которым будет сохранена текущая конфигурация контроллера;
• <USB_DISK> – имя раздела на USB-носителе;
• <MMC_DISK> – имя раздела на MMC-носителе.

Восстановление конфигурации из резервной копии

В случае потери конфигурации на контроллере в процессе эксплуатации, обновления или "отката" на более старую версию ПО конфигурацию контроллера можно восстановить, используя созданную ранее резервную копию.

Копирование резервной копии конфигурации на контроллер WLC возможно как с использованием протоколов удаленного копирования файлов, так и на локально подключенные USB/MMC-носители.

Подготовка

Для восстановления конфигурации контроллера из резервной копии с использованием серверов удаленного копирования файлов необходимо:

1. Запустить соответствующий сервер на ПК/сервере в сети.
2. Разместить в рабочем разделе сервера файл с созданной ранее резервной копией контроллера.
3. Настроить контроллер для появления IP-связности с сервером удаленного копирования файлов.
4. Обеспечить IP-связность между обновляемым контроллером WLC и сервером удаленного копирования файлов (маршрутизация).
5. Обеспечить работу протокола удаленного копирования между WLC и сервером удаленного копирования файлов (промежуточные firewall).
6. При необходимости (для протоколов ftp, sftp, scp, http) узнать имя пользователя и пароль для записи необходимого файла.

Для восстановления конфигурации контроллера из резервной копии с локально подключенного USB/MMC-носителя необходимо:

1. Отформатировать раздел USB/MMC-носителя в формате FAT32.
2. Поместить файл с ранее созданной резервной копией конфигурации контроллера на USB/MMC-носитель.
3. Подключить USB/MMC-носитель в соответствующий слот WLC.

Копирование файла с резервной копией конфигурации

С использованием протоколов удаленного копирования файлов

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

• <config-file-name> – имя файла резервной копии конфигурации контроллера;
• <tftp-server-ip> – IP-адрес используемого TFTP-сервера;
• <ftp-username> – имя пользователя на FTP-сервере;
• <ftp-userpassword> – пароль пользователя на FTP-сервере;
• <ftp-server-ip> – IP-адрес используемого FTP-сервера;
• <sftp-username> – имя пользователя на SFTP-сервере;
• <sftp-userpassword> – пароль пользователя на SFTP-сервере;
• <sftp-server-ip> – IP-адрес используемого SFTP-сервера;
• <scp-username> – имя пользователя на SCP-сервере;
• <ftp-userpassword> – пароль пользователя на FTP-сервере;
• <scp-server-ip> – IP-адрес используемого SCP-сервера;
• <http-username> – имя пользователя на HTTP-сервере;
• <http-userpassword> – пароль пользователя на HTTP-сервере;
• <http-server-ip> – IP-адрес используемого HTTP-сервера.

С локально подключенного USB/MMC-носителя

1. Определить метку тома подключенного USB/MMC-накопителя.

2. Скопировать файл на используемый USB/MMC-накопитель:

• <config-file-name> – имя файла резервной копии конфигурации контроллера;
• <USB_DISK> – имя раздела на USB-носителе;
• <MMC_DISK> – имя раздела на MMC-носителе.

Применение и подтверждение загруженной конфигурации

Для применения и подтверждения работы конфигурации, загруженной ранее в раздел "system:candidate-config", необходимо выполнить команды:

Определение текущей версии ПО и версии вторичного загрузчика (U-boot)

Определить версии используемого в данный момент вторичного загрузчика (U-boot) и основного ПО можно:

• в CLI основного ПО;
• в выводе консольного интерфейса при загрузке контроллера.

Определение текущей версии ПО и версии вторичного загрузчика (U-boot) в CLI основного ПО

Для определения текущей версии ПО и версии вторичного загрузчика (U-boot) в CLI основного ПО необходимо выполнить команду "show version":

Определение текущей версии ПО и версии первичного (X-Loader) и вторичного (U-boot) загрузчиков в выводе консольного интерфейса при загрузке контроллера

Для определения текущей версии ПО и версии вторичного загрузчика (U-boot) в выводе консольного интерфейса при загрузке контроллера необходимо:

1. Подключиться к сервисному контроллеру WLC через интерфейс Сonsole на передней панели контроллера, используя следующие параметры интерфейса RS-232 на ПК:

• Скорость: 115200 бит/с;
• Биты данных: 8 бит;
• Четность: нет;
• Стоповые биты: 1;
• Управление потоком: нет.

2. Перезагрузить контроллер одним из следующих способов:

• Отключить и включить питание. Интервал между отключением и включением должен составить не менее 20 секунд.
  • Кратковременно нажать функциональную кнопку F на передней панели контроллера.
• Выполнить команду "reload system" в CLI основного ПО контроллера.

3. В процессе загрузки в консоль будет выведена информация о версиях:

• Первичного загрузчика:

  Версия первичного загрузчика на ESR-20/21/30

  NOTICE: Cold boot
NOTICE: BL1:1.15.3.2 (28/12/2022 - 15:56:46)

• Вторичного загрузчика (U-boot):

  Версия вторичного загрузчика

  NOTICE: BL31:1.15.3.2 (28/12/2022 - 15:56:46)
U-Boot:1.15.3.2 (28/12/2022 - 15:56:46)

• Основного ПО (Firmware):

  Версия основного ПО

  [ 0.000000] Booting Linux on physical CPU 0x0
[ 0.000000] Software version: 1.15.3 build 3[2555a4e8a] date 28/12/2022 time 17:44:53

Обновление основного ПО в CLI WLC

Обновление ПО с версии 1.19.1 на 1.19.2 

ПО версии 1.19.2 является кумулятивным (содержит обновленные версии первичного и вторичного загрузчиков), поэтому будет достаточно:

• Сделать резервную копию конфигурации (backup).
• Загрузить ПО для ТД.
• Загрузить ПО (firmware-файл) на контроллер WLC.
• Выбрать образ ПО версии 1.19.2 для следующей загрузки.
• Перезагрузить контроллер.
• Проверить параметры в конфигурации.

В версии 1.19.2 произведен переход от персональных board-profile к универсальным radio-profile, при переходе произойдет конвертация конфигурации, board-profile будут заменены на преднастроенные radio-profile, нужно проверить настройку radio-profile.

Если у вас были настроены индивидуальные профили для точек доступа и были переопределены board-profile (настройки радио интерфейсов точки доступа), в которых был включен автовыбор каналов и не задан список каналов в параметре limit-channel, то после обновления будет использован список каналов из общих radio-profile. При необходимости изменить каналы – задайте нужный список limit-channel в индивидуальном профиле необходимой точки доступа.

Минимальная версия ПО ТД:

• WEP-1L/2L/30L/200L и WOP-2L/20L/30L/30LS — 2.3.2
• WEP-3ax — 1.11.0

Нужно загрузить ПО для ТД на контроллер. ТД обновится автоматически, после подключения.

Обновление ПО с версии 1.19.0 на 1.19.1

После обновления необходимо отредактировать конфигурацию в соответствии с изменениями:

1. В 1.19.1 поддержано избирательное включение vlan в SoftGRE-туннели. Добавлена команда service-vlan в разделе softgre-controller, указанные vlan будут включены в туннели после обновления. В 1.19.0 все созданные vlan включались в туннели. Нужно добавить используемые vlan для Wi-Fi в конфигурацию.
   

   softgre-controller
     service-vlan add 3
   exit

2. Поддержана настройка  telnet, ssh, web, snmp сервисов на точках доступа, после обновления они будут отключены. Их можно включить в профиле ap-profile.

   На точках доступа web отключается/включается одновременно для  HTTP/HTTPS-сервисов.

   Для включения нужно перейти в раздел конфигурации wlc → ap-profile default-ap → services.

   wlc(config-wlc-ap-profile)# services 
   wlc(config-wlc-ap-profile-services)# 
     snmp-server  Enable SNMP service
   
   wlc(config-wlc-ap-profile-services)# ip 
     http    Configure web-configurator service
     https   Configure web-configurator service
     ssh     Configure SSH service
     telnet  Configure telnet service
   

Обновление ПО с версии 1.15.3 на 1.19.0

1. После обновления необходимо отредактировать конфигурацию в соответствии с изменениями:

   Изменена схема регистрации точек доступа на контроллере. Теперь используется не только порт 8043, но и 8044. Необходимо добавить порт 8044 в object-group service sa:

   object-group service sa
     port-range 8044
   exit

   После обновления WLC точки доступа попадут в список сервиса инициализации и будут ожидать авторизации. Просмотр списка неавторизованных точек осуществляется командой:

   show wlc service-activator aps 

   Для авторизации всех точек доступа из списка используется команда:
   

   join wlc ap 

   Для авторизации конкретной точки используется команда:

   join wlc ap <MAC_AP>

   Есть возможность включить в конфигурации режим автоматической авторизации:

   wlc# configure 
   wlc(config)# wlc
   wlc(config-wlc)# service-activator 
   wlc(config-wlc-service-activator)# aps join auto 
   wlc(config-wlc-service-activator)# do commit
   wlc(config-wlc-service-activator)# do confirm 

2. Изменена схема включения туннелей SoftGRE:

   В версии 1.15.3:

   Клиентский трафик приходит с ТД в gre-туннель с заданным тегом vlan, на стороне WLC для каждого vlan создается отдельный subgre-туннель и включается в заданные Bridge, при выходе из subgre метка vlan снимается. При такой реализации для каждого vlan нужно создавать subgre-туннель и включать его в один из Bridge. WLC не знает vlan, которые выдаются в момент авторизации по radius (если используются c-vlan с внешним radius-сервером), и не может поднять туннели для таких клиентов. 
   
   

   
   В версии 1.19.0:

   Изменена логика работы SoftGRE-туннелей в режиме wlc. Ранее subgre безусловно включался в Bridge по конфигурации WLC, в новой реализации subgre-туннели отсутствуют. Vlan, указанный в настройках SSID, попадает в WLC без терминации sub-туннеля в Bridge. Поддержано использование c-vlan в схеме c туннелированием клиентского трафика. Для корректной работы vlan должен быть создан в настройках WLC и должен быть членом Bridge или интерфейса.
   

   
   
   

3. Для поднятия туннелей теперь не используется параметр location, который ранее задавался на Bridge и в ap-location для SSID. Вместо этого необходимо включить mode tunnel в ap-location.
   Vlan-id в ssid-profile должен совпадать с vlan-id в bridge пользователей.

   Версия ПО 1.15.3	Версия ПО 1.19.0
   bridge 3   security-zone users   ip address 192.168.2.1/24   location default   enable exit	bridge 3   vlan 3 (=vlan-id в SSID-profile)   mtu 1458   security-zone users   ip address 192.168.2.1/24   enable exit
   ap-location default-location   description default-location   board-profile WEP-1L default_wep-1l_profile   board-profile WEP-20L default_wep-20l_profile   board-profile WEP-2L default_wep-2l_profile   board-profile WEP-3ax default_wep-3ax_profile   board-profile WEP-3ax-Z default_wep-3ax-z_profile   board-profile WOP-20L default_wop-20l_profile   board-profile WOP-2L default_wop-2l_profile   board-profile WOP-3ax default_wop-3ax_profile   ssid-profile default-ssid default exit	ap-location default-location   description default-location   mode tunnel   ap-profile default-ap   board-profile WEP-1L default_wep-1l_profile   board-profile WEP-200L default_wep-200l_profile   board-profile WEP-20L default_wep-20l_profile   board-profile WEP-2L default_wep-2l_profile   board-profile WEP-30L default_wep-30l_profile   board-profile WEP-3ax default_wep-3ax_profile   board-profile WEP-3ax-Z default_wep-3ax-z_profile   board-profile WOP-20L default_wop-20l_profile   board-profile WOP-2L default_wop-2l_profile   board-profile WOP-30L default_wop-30l_profile   board-profile WOP-3ax default_wop-3ax_profile   ssid-profile default-ssid exit
   	vlan 3   force-up exit

4. Wireless-controller переименован в softgre-controller:

   Версия ПО 1.15.3	Версия ПО 1.19.0
   wireless-controller   nas-ip-address 127.0.0.1   data-tunnel configuration wlc   aaa radius-profile default_radius   keepalive-disable   enable exit	softgre-controller   nas-ip-address 127.0.0.1   data-tunnel configuration wlc   aaa radius-profile default_radius   keepalive-disable   enable exit

5. Изменились команды мониторинга WLC:

   Формат в версии ПО 1.15.3	Формат в версии ПО 1.19.0	Назначение команды
   show wlc connected-ap	show wlc ap	Просмотр списка обслуживаемых контроллером точек доступа
   show wlc connected-ap detailed	sh wlc ap detailed	Просмотр детальной информации по всем авторизованным точкам доступа
   show wlc connected-ap detailed <MAC_AP>	sh wlc ap detailed <MAC_AP>	Просмотр детальной информации по одной из авторизованных точек доступа
   show wlc connected-ap-clients <MAC_AP>	sh wlc clients ap <MAC_AP>	Просмотр информации о подключениях беспроводных клиентов определенной точки доступа
   show wlc connected-ap-clients <MAC_AP> detailed	sh wlc clients ap <MAC_AP> detailed	Просмотр детальной информации о подключениях беспроводных клиентов определенной точки доступа
   show wlc connected-client <MAC_STA>	sh wlc clients <MAC_STA>	Просмотр информации о подключении беспроводного клиента по его MAC-адресу
   show wlc connected-client <MAC_STA> detailed	sh wlc clients <MAC_STA> detailed	Просмотр детальной информации о подключении беспроводного клиента по его MAC-адресу
   show wlc connected-ap-interfaces <MAC_AP>	show wlc ap interfaces <MAC_AP>	Просмотр информации и счетчиков по интерфейсам точки доступа
   show wlc connected-ap-radios <MAC_AP>	show wlc ap radios <MAC_AP>	Просмотр основных параметров радиоинтерфейсов точки доступа

Подготовка к загрузке ПО

При загрузке ПО с использованием серверов удаленного копирования файлов необходимо:

1. Запустить соответствующий сервер в сети (tftp/ftp/sftp/http/https/scp).
2. Скопировать файл ПО (wlc30-1.19.2-build4.firmware) в рабочий раздел сервера удаленной загрузки файлов.
3. Обеспечить IP-связность между обновляемым контроллером WLC и сервером удаленного копирования файлов (маршрутизация).
4. Обеспечить работу протокола удаленного копирования между WLC и сервером удаленного копирования файлов (промежуточные firewall).
5. При необходимости (для протоколов ftp, sftp, scp, http, https) узнать имя пользователя и пароль для скачивания необходимого файла.

При загрузке ПО с использованием USB/MMC-носителя необходимо:

1. Отформатировать раздел USB/MMC-носителя в формате FAT32 или exFAT.
2. Скопировать файл ПО (wlc30-1.19.2-build4.firmware) в корневой раздел USB/MMC-носителя. Правила использования файлов ПО для различных моделей см. выше.
3. Подключить USB/MMC-носитель в соответствующий слот контроллера.
4. Определить метку тома подключенного USB/MMC-накопителя.

Загрузка ПО

С использованием одного из протоколов удаленной загрузки файлов

• <tftp-server-ip> – IP-адрес используемого TFTP-сервера;
• <ftp-username> – имя пользователя на FTP-сервере;
• <ftp-userpassword> – пароль пользователя на FTP-сервере;
• <ftp-server-ip> – IP-адрес используемого FTP-сервера;
• <sftp-username> – имя пользователя на SFTP-сервере;
• <sftp-userpassword> – пароль пользователя на SFTP-сервере;
• <sftp-server-ip> – IP-адрес используемого SFTP-сервера;
• <scp-username> – имя пользователя на SCP-сервере;
• <ftp-userpassword> – пароль пользователя на FTP-сервере;
• <scp-server-ip> – IP-адрес используемого SCP-сервера;
• <http-username> – имя пользователя на HTTP-сервере;
• <http-userpassword> – пароль пользователя на HTTP-сервере;
• <http-server-ip> – IP-адрес используемого HTTP-сервера.

С использованием USB/MMC-накопителя

1. Определение имени метки тома подключенного USB/MMC-накопителя:

2. Копирование файла с используемого USB/MMC-накопителя:

• <USB_DISK> – имя раздела на USB-носителе;
• <MMC_DISK> – имя раздела на MMC-носителе.

Выбор образа ПО версии 1.19.2 для следующей загрузки

На контроллере WLC одновременно хранится два образа ПО (image-1 и image-2).

1. Проверить содержимое образов ПО, загруженных на контроллер:

При загрузке файла ПО в раздел system:firmware загрузка осуществляется всегда в неактивный в данный момент раздел.

2. Выбрать раздел, содержащий ПО версии 1.19.2, в качестве загрузочного:

3. Проверить, что образ, содержащий ПО версии 1.19.2, выбран для загрузки:

Перезагрузка контроллера

Перезагрузка контроллера осуществляется при помощи команды: