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

Введение

Аннотация

В данном руководстве описаны процессы обновления компонентов программного обеспечения контроллера 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":

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

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

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

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

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

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

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

• Первичного загрузчика (sbi, bl1 в зависимости от модели контроллера):

  Версия первичного загрузчика на WLC-15

  SBI:1.17.3.11 (14/11/2022 - 12:55:55)
  Chip is NSP B1
  Booting from SPI-NOR

  
  

  Версия первичного загрузчика на WLC-30

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

  Версия первичного загрузчика на WLC-3200

  BRCM XLP Stage 1 Loader (X-Loader:1.17.3.11) [Big-Endian] (14/11/2022 - 13:21:58)
XLP316B2: Node 0 frequency: CPU=1400MHz, SOC=1999MHz, REF=133MHz
POWER ON RESET CFG:43F94FA8,VRM: 0x6868, PRID: 0xC1104

• Вторичного загрузчика (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.2 на 1.26.1

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

• Сделать резервную копию конфигурации (backup).
• Загрузить ПО для ТД на контроллер.
• Загрузить ПО для контроллера WLC.

• Выбрать образ ПО версии 1.26.1 для следующей загрузки.

  Отключение питания до окончания выполнения команды "boot system {image-1|image-2}" может привести к неисправности контроллера.

• Перезагрузить контроллер.

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

• WEP-1L/2L/30L/30L-Z/200L и WOP-2L/20L/30L/30LS — 2.5.0 или выше
• WEP-3ax — 1.12.0 или выше
• WEP-2ac/2ac Smart, WOP-2ac/2ac rev.B/2ac rev.C — 1.25.0 или выше

ПО для ТД необходимо загрузить на контроллер перед его обновлением. Тогда после перезагрузки WLC точки автоматически обновятся на новое ПО. Если ПО было загружено на контроллер после его обновления, тогда необходимо выполнить команду clear wlc ap, чтобы ТД переподключились и обновили ПО.

Обновление ПО с версии 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.19.0 и более поздних, более ранние версии не поддерживают кумулятивное обновление. Поэтому, кроме основного ПО, необходимо обновить также вторичный загрузчик. В результате, процесс обновления будет следующий:

• Загрузить вторичный загрузчик (U-boot) на контроллер WLC.
• Загрузить ПО (firmware-файл) на контроллер WLC.
• Выбрать образ ПО обновленной версии для следующей загрузки.
• Перезагрузить контроллер.

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. Скопировать файл <uboot-file> в рабочий раздел сервера удаленной загрузки файлов.
3. Обеспечить IP-связность между обновляемым контроллером WLC и сервером удаленного копирования файлов (маршрутизация).
4. Обеспечить работу протокола удаленного копирования между WLC и сервером удаленного копирования файлов (промежуточные firewall).
5. При необходимости (для протоколов ftp, sftp, scp, http, https) узнать имя пользователя и пароль для скачивания необходимого файла.

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

1. Отформатировать раздел USB/MMC-носителя в формате FAT32 или exFAT.
2. Скопировать файл <uboot-file> в корневой раздел 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. Запустить соответствующий сервер в сети (tftp/ftp/sftp/http/https/scp).
2. Скопировать файл ПО (wlc30-1.26.1-build4.firmware) в рабочий раздел сервера удаленной загрузки файлов.
3. Обеспечить IP-связность между обновляемым контроллером WLC и сервером удаленного копирования файлов (маршрутизация).
4. Обеспечить работу протокола удаленного копирования между WLC и сервером удаленного копирования файлов (промежуточные firewall).
5. При необходимости (для протоколов ftp, sftp, scp, http, https) узнать имя пользователя и пароль для скачивания необходимого файла.

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

1. Отформатировать раздел USB/MMC-носителя в формате FAT32 или exFAT.
2. Скопировать файл ПО (wlc30-1.26.1-build14.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.26.1 для следующей загрузки

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

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

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

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

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

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

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