A Shared Block | |||||
---|---|---|---|---|---|
| |||||
|
Оглавление | ||
---|---|---|
|
Введение
Аннотация
В данном руководстве описаны процессы обновления компонентов программного обеспечения контроллера WLC с учетом особенностей конкретных моделей и предыдущих версий программного обеспечения, используемых обновляемым устройством.
Целевая аудитория
Данное руководство предназначено для технического персонала, выполняющего обновление устройств посредством интерфейса командной строки (CLI).
Условные обозначения
Обозначение | Описание | ||
---|---|---|---|
[ ] | В квадратных скобках в командной строке указываются необязательные параметры, но их ввод предоставляет определенные дополнительные опции. | ||
{ } | В фигурных скобках в командной строке указываются возможные обязательные параметры. Необходимо выбрать один из параметров. | ||
«,» «-» | Данные знаки в описании команды используются для указания диапазонов. | ||
«|» | Данный знак в описании команды обозначает «или». | ||
Полужирный курсив | Полужирным шрифтом выделены примечания, предупреждения или информация. | ||
<Полужирный курсив> | Полужирным курсивом в угловых скобках указываются названия клавиш на клавиатуре. | ||
| В рамках с текстом указаны примеры и результаты выполнения команд. |
Scroll Pagebreak |
---|
Примечание |
---|
Примечания содержат важную информацию, советы или рекомендации по использованию и настройке устройства. |
Предупреждение |
---|
Предупреждения информируют пользователя о ситуациях, которые могут нанести вред устройству или человеку, привести к некорректной работе устройства или потере данных. |
Информация |
---|
Информация содержит справочные данные об использовании устройства. |
Создание резервной копии текущей конфигурации
Перед началом работ по обновлению ПО на контроллере WLC необходимо сделать резервную копию текущей конфигурации.
Копирование текущей конфигурации с контроллера WLC возможно как с использованием протоколов удаленного копирования файлов, так и на локально подключенные USB/MMC-носители.
Предупреждение |
---|
При переходе с более новой версии ПО на более старую (downgrade) вероятна ситуация, когда более старая версия ПО не сможет применить конфигурацию, сохраненную в более новой версии. В результате конфигурация будет утеряна и контроллер WLC загрузится с пустой конфигурацией. |
Подготовка
Для создания резервной копии текущей конфигурации контроллера с использованием серверов удаленного копирования файлов необходимо:
- Запустить соответствующий сервер на ПК/сервере в сети.
- Обеспечить возможность сохранения файлов в рабочем разделе сервера.
- Обеспечить IP-связность между обновляемым контроллером WLC и сервером удаленного копирования файлов (маршрутизация).
- Обеспечить работу протокола удаленного копирования между WLC и сервером удаленного копирования файлов (промежуточные firewall).
- При необходимости (для протоколов ftp, sftp, scp, http) узнать имя пользователя и пароль для записи необходимого файла.
Для создания резервной копии текущей конфигурации контроллера на локально подключенный USB/MMC-носитель необходимо:
- Раздел USB/MMC-носителя должен быть отформатирован в формате FAT32.
- Подключить 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-сервера.
Scroll Pagebreak |
---|
1. Определить метку тома подключенного USB/MMC-накопителя.
панель | ||
---|---|---|
| ||
|
панель | ||
---|---|---|
| ||
|
2. Скопировать файл на используемый USB/MMC-накопитель:
Примечание |
---|
При выполнении команд копирования на USB/MMC-носители необходимо вместо полей <USB_DISK> или <MMC_DISK> использовать настоящие метки тома определенные при выполнении пункта 1. |
панель | ||
---|---|---|
| ||
|
панель | ||
---|---|---|
| ||
|
- <config-file-name> — имя файла, с которым будет сохранена текущая конфигурация контроллера;
- <USB_DISK> — имя раздела на USB-носителе;
- <MMC_DISK> — имя раздела на MMC-носителе.
Восстановление конфигурации из резервной копии
В случае потери конфигурации на контроллере в процессе эксплуатации, обновления или "отката" на более старую версию ПО конфигурацию контроллера можно восстановить, используя созданную ранее резервную копию.
Копирование резервной копии конфигурации на контроллер WLC возможно как с использованием протоколов удаленного копирования файлов, так и на локально подключенные USB/MMC-носители.
Предупреждение |
---|
При переходе с более новой версии ПО на более старую (downgrade) вероятна ситуация, когда более старая версия ПО не сможет применить конфигурацию, сохраненную в более новой версии. В результате конфигурация будет утеряна и контроллер WLC загрузится с пустой конфигурацией. |
Подготовка
Для восстановления конфигурации контроллера из резервной копии с использованием серверов удаленного копирования файлов необходимо:
- Запустить соответствующий сервер на ПК/сервере в сети.
- Разместить в рабочем разделе сервера файл с созданной ранее резервной копией контроллера.
- Настроить контроллер для появления IP-связности с сервером удаленного копирования файлов.
- Обеспечить IP-связность между обновляемым контроллером WLC и сервером удаленного копирования файлов (маршрутизация).
- Обеспечить работу протокола удаленного копирования между WLC и сервером удаленного копирования файлов (промежуточные firewall).
- При необходимости (для протоколов ftp, sftp, scp, http) узнать имя пользователя и пароль для записи необходимого файла.
Для восстановления конфигурации контроллера из резервной копии с локально подключенного USB/MMC-носителя необходимо:
- Раздел USB/MMC-носителя должен быть отформатирован в формате FAT32.
- На USB/MMC-носителе должен быть помещен файл с ранее созданной резервной копией конфигурации контроллера.
- Подключить USB/MMC-носитель в соответствующий слот WLC.
Scroll Pagebreak |
---|
С использованием протоколов удаленного копирования файлов
В зависимости от протокола удаленного копирования файлов в 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-накопитель:
Примечание |
---|
При выполнении команд копирования на USB/MMC-носители необходимо вместо полей <USB_DISK> или <MMC_DISK> использовать настоящие метки тома, определенные при выполнении пункта 1. |
панель | ||
---|---|---|
| ||
|
панель | ||
---|---|---|
| ||
|
- <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. В процессе загрузки в консоль будет выведена информация о версиях:
Первичного загрузчика:
панель title Версия первичного загрузчика на ESR-20/21/30 NOTICE: Cold boot
NOTICE: BL1:1.15.3.2 (28/12/2022 - 15:56:46)
Вторичного загрузчика (U-boot):
панель title Версия вторичного загрузчика NOTICE: BL31:1.15.3.2 (28/12/2022 - 15:56:46)
U-Boot:1.15.3.2 (28/12/2022 - 15:56:46)
Scroll Pagebreak Основного ПО (Firmware):
панель title Версия основного ПО [ 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.15.3
ПО версии 1.19.0 является кумулятивным (содержит обновленные версии первичного и вторичного загрузчиков). ПО версии 1.15.3 поддерживает кумулятивное обновление всех компонентов ПО, поэтому будет достаточно:
- Сделать бэкап конфигурации.
- Отредактировать конфигурацию.
- Загрузить ПО (firmware-файл) на контроллер WLC.
- Выбрать образ ПО версии 1.19.0 для следующей загрузки.
- Перезагрузить контроллер.
- Загрузить обновленную конфигурацию.
Подготовка конфигурации при обновлении с версий 1.15.3
Версия 1.19.0 содержит ряд изменений уже имеющегося функционала, поэтому после обновления 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-сервера.
Scroll Pagebreak |
---|
Определить метку тома подключенного USB/MMC-накопителя.
панель | ||
---|---|---|
| ||
|
панель | ||
---|---|---|
| ||
|
Скопировать файл на используемый USB/MMC-накопитель:
Примечание |
---|
При выполнении команд копирования на USB/MMC-носители необходимо вместо полей <USB_DISK> или <MMC_DISK> использовать настоящие метки тома определенные при выполнении пункта 1. |
панель | ||
---|---|---|
| ||
|
панель | ||
---|---|---|
| ||
|
- <config-file-name> — имя файла, с которым будет сохранена текущая конфигурация контроллера;
- <USB_DISK> — имя раздела на USB-носителе;
- <MMC_DISK> — имя раздела на MMC-носителе.
2. Отредактировать сохраненную конфигурацию в соответствии с изменениями:
a. Изменена схема регистрации точек доступа на контроллере. Теперь используется не только порт 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-30# configure wlc-30(config)# wlc wlc-30(config-wlc)# service-activator wlc-30(config-wlc-service-activator)# aps join auto wlc-30(config-wlc-service-activator)# do commit wlc-30(config-wlc-service-activator)# do confirm |
b. Изменена схема включения туннелей SoftGRE
В версии 1.15.3:
Клиентский трафик вылетает с ТД в gre туннель с заданным тэгом vlan , на стороне WLC для каждого vlan создается отдельный subgre туннель и включается в заданные bridge, при выходе из subgre метка vlan снимается. При такой реализации для каждого vlan нужно создавать subgre туннель и включать его в какой-то bridge. WLC не знает vlan которые выдаются в момент авторизации по radius (если используются c-vlan с внешним radius сервером) и не может поднять туннели для таких клиентов.
Drawio border true viewerToolbar true fitWindow false diagramName wlc_gre_1.19 simpleViewer false width pageId 380174570 diagramWidth 797.7
В версии 1.19.0:
Drawio border true viewerToolbar true fitWindow false diagramName wlc_gre_1.19 simpleViewer false width pageId 380174570 diagramWidth 797.7
Изменена логика работы SoftGRE-туннелей в режиме wlc. Ранее subgre безусловно включался в Bridge по конфигурации WLC, в новой реализации subgre туннелей отсутствуют. Vlan, указанный в настройках SSID, попадает в WLC без терминации sub-туннеля в Bridge. Поддержано использование c-vlan в схеме c туннелированием клиентского трафика. Для корректной работы vlan должен быть создан в настройках WLC и должен быть членом Bridge или интерфейса.
Для поднятия туннелей теперь не используется параметр location, который ранее задавался на bridge и в ap-location для SSID. Вместо этого необходимо включить mode tunnel в ap-location.
Vlan-id в ssid-profile должен совпадать с vlan-id в bridge пользователей.
Версия ПО 1.15.3 | Версия ПО 1.19.0 |
---|---|
bridge 3 | bridge 3 |
ap-location default-location | 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 |
c. Wireless-controller переименован в softgre-controller:
Версия ПО 1.15.3 | Версия ПО 1.19.0 |
---|---|
wireless-controller | softgre-controller |
Якорь | ||||
---|---|---|---|---|
|
При загрузке ПО с использованием серверов удаленного копирования файлов необходимо:
- Запустить соответствующий сервер в сети (tftp/ftp/sftp/http/https/scp).
- Скопировать файл ПО (wlc13-1.19.0-build2.firmware) в рабочий раздел сервера удаленной загрузки файлов.
- Обеспечить IP-связность между обновляемым контроллером WLC и сервером удаленного копирования файлов (маршрутизация).
- Обеспечить работу протокола удаленного копирования между WLC и сервером удаленного копирования файлов (промежуточные firewall).
- При необходимости (для протоколов ftp, sftp, scp, http, https) узнать имя пользователя и пароль для скачивания необходимого файла.
При загрузке ПО с использованием USB/MMC-носителя необходимо:
- Раздел USB/MMC-носителя должен быть отформатирован в формате FAT32 или exFAT.
- Скопировать файл ПО (wlc30-1.19.0-build2.firmware) в корневой раздел USB/MMC-носителя. Правила использования файлов ПО для различных моделей см. выше.
- Подключить USB/MMC-носитель в соответствующий слот контроллера.
- Определить метку тома подключенного 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/MMC-носителей необходимо вместо полей <USB_DISK> или <MMC_DISK> использовать настоящие метки тома, определенные выше. |
панель | ||
---|---|---|
| ||
|
панель | ||
---|---|---|
| ||
|
- <USB_DISK> – имя раздела на USB-носителе;
- <MMC_DISK> – имя раздела на MMC-носителе.
Выбор образа ПО версии 1.19.0 для следующей загрузки
На контроллере WLC одновременно хранится два образа ПО (image-1 и image-2).
1. Проверить содержимое образов ПО, загруженных на контроллер:
панель |
---|
|
При загрузке файла ПО в раздел system:firmware загрузка осуществляется всегда в неактивный в данный момент раздел.
2. Выбрать раздел, содержащий ПО версии 1.19.0, в качестве загрузочного:
панель | ||
---|---|---|
| ||
wlc# boot system image-1 |
Scroll Pagebreak |
---|
панель |
---|
|
Предупреждение |
---|
Если для последующей загрузки будет выбрана версия ПО, которая была выпущена ранее версии ПО, используемой в данный момент, после перезагрузки станет невозможна конвертация текущей конфигурации, и будет применена пустая конфигурация (без заводских настроек). При пустой конфигурации к контроллеру можно подключиться только используя консольное подключение и логин/пароль по умолчанию (admin/password). |
Перезагрузка контроллера
Перезагрузить контроллер при помощи команды:
панель | ||
---|---|---|
| ||
|
Загрузка обновленной конфигурации
С использованием протоколов удаленного копирования файлов
В зависимости от протокола удаленного копирования файлов в 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-накопитель:
Примечание |
---|
При выполнении команд копирования на USB/MMC-носители необходимо вместо полей <USB_DISK> или <MMC_DISK> использовать настоящие метки тома, определенные при выполнении пункта 1. |
панель | ||
---|---|---|
| ||
|
панель | ||
---|---|---|
| ||
|
- <config-file-name> — имя файла резервной копии конфигурации контроллера;
- <USB_DISK> — имя раздела на USB-носителе;
- <MMC_DISK> — имя раздела на MMC-носителе.
Применение и подтверждение загруженной конфигурации
Для применения и подтверждения работы конфигурации, загруженной ранее в раздел "system:candidate-config", необходимо выполнить команды:
панель | ||
---|---|---|
| ||
|