Управление ПО точек доступа
Загрузка ПО
Для загрузки прошивки используйте команду:
wlc# copy tftp://192.168.1.2:/WEP-1L-1.6.0_build_75.tar.gz system:access-points-firmwares # где # IP-адрес TFTP-сервера: 192.168.1.2, # название файла ПО: WEP-1L-1.6.0_build_75.tar.gz.
- Всегда загружайте актуальную версию ПО точек доступа на контроллер для обновления новых точек при их подключении. Это требуется для корректной работы, т.к. управление контроллером поддерживается не на всех версиях ПО точек доступа.
- Если на контроллер загружено несколько версий ПО для одной модели точки доступа, то актуальным будет считаться ПО старшее по номеру. Например, если загружены версии ПО: WEP-1L-1.5.0_build_100.tar.gz и WEP-1L-1.6.0_build_50.tar.gz, то то актуальным будет ПО 1.6.0_build_50.tar.gz.
Просмотр файлов ПО
Для просмотра минимальной версии ПО конкретных моделей точек доступа, а так же версии и архива ПО, который будет использован в последующих обновлениях, необходимо использовать команду: show wlc ap firmware
# Столбец Board type - указывает название модели точки доступа, которая может работать под управлением контроллера. # Столбец Min SW version - показывает минимальную требуемую версию ПО точки доступа для работы под управлением контроллера. # Столбец Current SW version - показывает версию ПО для конкретной модели точки доступа, которая будет использоваться в последующих обновлениях. # Столбцу Filename - показывает название архива ПО для конкретной модели точки доступа в директории system:access-points-firmwares, который будет использоваться в последующих обновлениях wlc# show wlc ap firmware Board type Min SW version Current SW version Filename -------------------------------- -------------------------------- -------------------------------- ---------------------------------------------------------------- WEP-1L 2.8.0 build 0 -- -- WEP-200L 2.8.0 build 0 2.9.1 build 161 WEP-200L-2.9.1_build_161.tar.gz WEP-2L 2.8.0 build 0 -- -- WEP-2ac 1.25.6 build 0 -- -- WEP-2ac Smart 1.25.6 build 0 -- -- WEP-30L 2.8.0 build 0 2.10.0 build 193 WEP-30L-2.10.0_build_193.tar.gz WEP-30L-NB 2.8.0 build 0 2.10.0 build 193 WEP-30L-2.10.0_build_193.tar.gz WEP-30L-Z 2.8.0 build 0 2.10.0 build 193 WEP-30L-2.10.0_build_193.tar.gz WEP-3L 2.7.0 build 0 -- -- WEP-3ax 1.15.0 build 0 1.15.1 build 14 WEP-3ax-1.15.1_build_14.tar.gz WEP-50L 3.1.0 build 0 -- -- WEP-550K 1.2.2 build 0 -- -- WOP-20L 2.8.0 build 0 -- -- WOP-2L 2.8.0 build 0 -- -- WOP-2ac 1.25.6 build 0 -- -- WOP-2ac:rev.B 1.25.6 build 0 -- -- WOP-2ac:rev.C 1.25.6 build 0 -- -- WOP-30L 2.8.0 build 0 -- -- WOP-30LI 2.8.0 build 0 -- -- WOP-30LS 2.8.0 build 0 -- -- WOP-3L-EX 2.7.0 build 0 -- --
Для просмотра списка загруженных файлов используйте команду:
wlc# dir system:access-points-firmwares # Пример вывода Name Type Size -------------------------------------------------------- ---------- -------- -- WEP-1L-1.5.0_build_59.tar.gz File 9.07 MB WEP-1L-1.6.0_build_75.tar.gz File 9.08 MB
Удаление ПО
Для удаления конкретных или всех архивов ПО с контроллера используйте команды:
# Удаление всех файлов ПО. Команда требует подтверждения wlc# delete system:access-points-firmwares Do you really want to clear directory? (y/N): y # Удаление конкретного файла wlc# delete system:access-points-firmwares/WEP-1L-1.5.0_build_59.tar.gz
Автоматическое обновление ПО новых точек доступа
Настройка по умолчанию работает следующим образом: когда подключается новая точка доступа с версией ПО ниже или выше минимальной, она автоматически обновляется на версию ПО, используя архив, который загружен на WLC в директорию system:access-points-firmwares
В случае, если новая точка доступа подключается с версией ПО ниже минимальной, при этом на контроллере отсутствует архив с версией ПО равной, либо выше минимально допустимой, то такая точка не будет работать под управлением контроллера, и об этом будет выводиться соответствующий лог:
2024-01-18T14:16:57+07:00 %WLC-E-ERROR: SA:[e8:28:c1:da:c9:b0]:AP with board type 'WEP-1L' with unsupported firmware version '2.2.0 build 352', no firmware image for upgrade
Запрет автоматического обновления ПО новых точек доступа
Для того, чтобы отключить автоматическое обновление новых точек с версией ПО которая совпадает либо выше минимальной версии ПО, необходимо включить настройку aps auto-upgrade disable в сервис-активаторе:
wlc# configure wlc(config)# wlc wlc(config-wlc)# service-activator wlc(config-wlc-service-activator)# aps auto-upgrade disable
Настройка aps auto-upgrade disable не влияет на:
- Обновления ПО новых точек доступа, которые подключаются с версией ПО ниже минимальной. Такие точки доступа будут обновлены всегда, при условии, что на контроллере присутствует файл с версией ПО равной либо выше минимально допустимой версией для работы с контроллером
Подробная информация и команда для просмотра информации описаны выше - Немедленные задания на обновления ПО точек доступа
- Отложенные задания на обновления ПО точек доступа
- Ежедневные (цикличные) обновления ПО всех точек доступа
Обновления ПО точек доступа под управлением контроллера по команде администратора
Немедленные и отложенные задания на обновления ПО точек доступа
- Максимальное количество немедленных и отложенных заданий на обновление ПО, которые можно создать равно 255. При превышении лимита необходимо удалить задания на обновлении ПО с помощью команды: clear wlc ap firmware-update
#пример сообщения при превышении лимита в 255 заданий на обновление ПО. SA_FW:number of manual upgrades hit limit: 255. Please clear some tasks
- Контроллер выполняет немедленные и отложенные задания на обновление ПО параллельно. Одновременно во всех задачах могут участвовать 50 точек доступа.
- Контроллер выполняет немедленные и отложенные задания на обновление ПО независимо от подключенных к точкам доступа клиентам. Всегда будет происходит перерыв сервиса на всех точках, которые являются объектом таких обновлений.
- Задания на обновление ПО со статусом Finished автоматически удаляются из вывода команды show wlc ap firmware-update status через 1 месяц.
#пример сообщения при автоматическом удалении задания на обновление ПО с task-id 10 SA_FW:upgrade task (id: 10). Reached after finish cleaning time. Task cleared
- Немедленные и отложенные задания на обновления ПО точек доступа сохраняются в случае нештатных ситуаций:
- При перезагрузке контроллера
- При смене статуса VRRP MASTER, когда контроллер работает в схеме с резервированием.
- Модели точек доступа, для которых отсутствует архив с ПО, исключаются из задания на обновление. Если точка доступа единственная в рамках задания на обновление, то задание завершается некорректно (статус Failed)
SA_FW:upgrade task (id: 2): board types: WEP-3ax have no uploaded firmware. Listed board types skipped from upgrade task
Немедленные задания на обновления ПО точек доступа
Немедленное обновление конкретной точки доступа
Для немедленного обновления ПО конкретной точки доступа, используйте команду update wlc ap firmware mac <MAC> , где
<MAC> - это MAC-адрес выбранной точки доступа.
Команда работает в интерактивном режиме и требует подтверждения администратора.
После подтверждения, создается задание на обновление ПО конкретной точки доступа и сразу же запускается процесс обновления.
wlc# update wlc ap firmware mac 68:13:e2:1f:7f:e0 Do you really want to update firmware for AP: 68:13:e2:1f:7f:e0 now? (y/N): y wlc# 2026-04-03T09:57:52+07:00 %WLC-W-WARN: SA_FW:upgrade task (id: 1): SCHEDULED -> RUNNING
Немедленное на обновление конкретной локации
Для немедленного обновления ПО точек доступа в рамках конкретной локации, используйте команду: update wlc ap firmware location <LOCATION> , где
<LOCATION> - это название локации точек доступа.
Команда работает в интерактивном режиме и требует подтверждения администратора.
После подтверждения, создается задание на обновление ПО точек доступа в рамках конкретной локации и сразу же запускается процесс обновления.
wlc# update wlc ap firmware location default-location Do you really want to update firmware for APs in location: default-location now? (y/N): y wlc# 2026-04-03T10:10:40+07:00 %WLC-W-WARN: SA_FW:upgrade task (id: 2): SCHEDULED -> RUNNING
Немедленное обновление всех точек доступа
Для немедленного обновления ПО точек доступа под управлением контроллера, используйте команду: update wlc ap firmware all.
Команда работает в интерактивном режиме и требует подтверждения администратора.
После подтверждения, создается задание на обновление ПО всех точек доступа под управлением контроллера и сразу же запускается процесс их обновления.
wlc# update wlc ap firmware all Do you really want to update firmware for all APs now? (y/N): y wlc# 2026-04-03T10:14:47+07:00 %WLC-W-WARN: SA_FW:upgrade task (id: 3): SCHEDULED -> RUNNING
Отложенные задания на обновление ПО точек доступа
- Отложенные обновления выполняются по текущему системному времени контроллера, поэтому изменение системного времени контроллера вручную через команду set date или со стороны NTP ( ntp server ) влияет на время начала интервала обновления для уже ранее созданных заданий.
Рекомендация
Рекомендуется всегда проверять наличие отложенных заданий на обновление (статус Scheduled) в выводе команды show wlc ap firmware-update status, перед изменением системного времени контроллера вручную или со стороны NTP сервера.
Если такие задания на обновления присутствуют, необходимо удалить их с помощью команды clear wlc ap firmware-update, изменить системное время и только потом создать их повторно.
- Минимальный интервал отложенного задания на обновление ТД: 10 минут, максимальный: 24 часа.
- Отложенные задания на обновление сохраняют часовой пояс на момент cоздания. Изменение часового пояса в глобальной конфигурации через команду clock timzone или в локации точки доступа через команду timezone не влияет на уже ранее созданные задания на обновления.
- Отложенные задания на обновление ПО могут завершиться раньше, чем фактическое значение параметра stop-time, если все точки доступа в рамках задания успешно обновлены.
- Если точка доступа перешла в статус Lost или Failed или Pre-configured в процессе выполнения отложенного задания на обновление, попытка обновить её снова продолжиться, когда точка доступа восстановит соединение с контроллером, если интервал обновления (параметр stop-time) не завершился.
Отложенное обновление конкретной точки доступа
Для отложенного обновления ПО конкретной точки доступа, используйте команду: update wlc ap firmware mac <MAC> start-time <TIME> <DAY> <MONTH> stop-time <TIME> <DAY> <MONTH> где,
<MAC> - это MAC-адрес конкретной точки доступа,
<START-TIME> - время начала интервала обновления ПО точек доступа в формате HH:MM,
<STOP-TIME> - время конца интервала обновления ПО точек доступа в формате HH:MM,
<DAY> - день в рамках месяца,
<MONTH> - название месяца.
Команда работает в интерактивном режиме и требует подтверждения администратора.
#Пример отложенного обновления точки доступа с MAC-адресом 68:13:e2:1f:7f:e0 в интервал с 16:00 по 16:10 по часовому поясу GMT+7 4 апреля wlc# update wlc ap firmware mac 68:13:e2:1f:7f:e0 start-time 16:00 4 april stop-time 16:10 4 april Do you really want to schedule firmware update for AP: 68:13:e2:1f:7f:e0 from 2026-04-04 16:00:00 GMT+07 to 2026-04-04 16:10:00 GMT+07? (y/N): y
Отложенное обновление конкретной локации
Для отложенного обновления ПО точек доступа в рамках конкретной локации, используйте команду update wlc ap firmware location <LOCATION> start-time <STAR-TIME> <DAY> <MONTH> stop-time <STOP-TIME> <DAY> <MONTH> где,
<LOCATION> - это название локации точек доступа,
<START-TIME> - время начала интервала обновления ПО точек доступа в формате HH:MM,
<STOP-TIME> - время конца интервала обновления ПО точек доступа в формате HH:MM,
<DAY> - день в рамках месяца,
<MONTH> - название месяца.
Команда работает в интерактивном режиме и требует подтверждения администратора.
#Пример отложенного обновления точек доступа в пределах локации "default-location" в интервал с 12:15 по 12:25 по часовому поясу GMT+7 3 апреля wlc# update wlc ap firmware location default-location start-time 12:15 3 april stop-time 12:25 3 april Do you really want to schedule APs firmware update in location: default-location from 2026-04-03 12:15:00 GMT+07 to 2026-04-03 12:25:00 GMT+07? (y/N): y
Отложенные обновления одной точки доступа и локаций с учетом разницы часовых поясов
По умолчанию, в настройках локации (ap-location) не задан параметр timezone, поэтому все отложенные задания на обновление ПО одной точки доступа либо в пределах локации будут выполняться по текущему времени и часовому поясу контроллера.
Пример:
# Настройка таймзоны на WLC wlc# show running-config clock clock timezone gmt +7 #текущее время на WLC wlc# show date "2026-04-03 12:44:01 #параметр timezone не сконфигурирован в локации "aps_in_Novosibirsk" wlc# show running-config wlc ap-location aps_in_Novosibirsk ap-location aps_in_Novosibirsk description "Novosibirsk" mode tunnel ap-profile default-ap airtune-profile default_airtune ssid-profile default-ssid exit #Все созданные отложенные задания на обновление ПО точек доступа будут использовать текущее время, дату и часовой пояс контроллера (GMT+7) wlc# update wlc ap firmware mac 68:13:e2:1f:7f:e0 start-time 13:20 3 april stop-time 13:30 3 april Do you really want to schedule firmware update for AP: 68:13:e2:1f:7f:e0 from 2026-04-03 13:20:00 GMT+07 to 2026-04-03 13:30:00 GMT+07? (y/N): y wlc# show wlc ap firmware-update status wlc# show wlc ap firmware-update status Task-id Status Start-time Stop-time Object ------- --------- --------------------------- --------------------------- ------------------------------- 1 Scheduled 2026-04-03 13:20:00 GMT+07 2026-04-03 13:30:00 GMT+07 MAC AP: 68:13:e2:1f:7f:e0
В случаях, когда контроллер WLC и точки доступ расположены в разных часовых поясах и требуется выполнять обновления ПО точек доступа с учетом разницы часовых поясов, необходимо:
- Предварительно корректно настроить параметр timezone в нужных локациях (ap-location).
- В последующих отложенных заданиях на обновление ПО точек доступа задавать время с учетом часового пояса локации, а не контроллера.
Пример:
# текущая настройка часового пояса на WLC wlc# show running-config clock clock timezone gmt +7 #текущее время на WLC wlc# show date "2026-04-03 13:52:45 #параметр timezone сконфигурирован в локации "aps_in_Irkutsk" и равен GMT+8 wlc# show running-config wlc ap-location aps_in_Irkutsk ap-location aps_in_Irkutsk description "Irkutsk" mode tunnel ap-profile default-ap airtune-profile default_airtune timezone gmt +8 ssid-profile default-ssid exit #При создании отложенных заданий на обновление ПО точек доступа необходимо настроить параметр start-time с учетом часового пояса локации, т.е GMT+8 wlc# update wlc ap firmware mac 68:13:e2:1f:7f:e0 start-time 14:55 3 april stop-time 15:05 3 april Do you really want to schedule firmware update for AP: 68:13:e2:1f:7f:e0 from 2026-04-03 14:55:00 GMT+08 to 2026-04-03 15:05:00 GMT+08? (y/N): y wlc# show wlc ap firmware-update status Task-id Status Start-time Stop-time Object ------- --------- --------------------------- --------------------------- ------------------------------- 1 Scheduled 2026-04-03 14:55:00 GMT+08 2026-04-03 15:05:00 GMT+08 MAC AP: 68:13:e2:1f:7f:e0 # В случае если не учитывать часовой пояс GMT+8 при создании отложенного задания, а попытаться настроить параметр start-time по текущему времени контроллера в часовом поясе GMT+7,сработает предупреждение. wlc# update wlc ap firmware mac 68:13:e2:1f:7f:e0 start-time 13:55 3 april stop-time 14:05 3 april this date and time have already expired current time: 2026-04-03 14:53:23 GMT+08, scheduled time: 2026-04-03 13:55:00 GMT+08
Просмотр статуса немедленных и отложенных заданий на обновление
Для просмотра статуса немедленных и отложенных заданий на обновлений ПО точек доступа, необходимо использовать команду: show wlc ap firmware-update status
wlc# show wlc ap firmware-update status Task-id Status Start-time Stop-time Object ------- --------- --------------------------- --------------------------- ------------------------------- 1 Finished 2026-04-06 11:12:46 GMT+07 -- MAC AP: 68:13:e2:1f:7f:e0 2 Finished 2026-04-06 12:16:00 GMT+08 2026-04-06 12:26:00 GMT+08 Ap-location: default-location
Подробное описание статусов немедленных и отложенных заданий на обновление ПО точек доступа
| Возможные статусы заданий на обновление ПО точек доступа | Описание |
|---|---|
| Scheduled | Задание на обновление запланировано и еще не выполнялось |
| Running | Задание на обновление выполняется |
| Finished | Задание на обновление завершилось успешно |
| Partial | Задание на обновление завершилось частично. Обновлена хотя бы одна ТД (Например при обновлении локации, в которой находится 64 точек доступа, обновились 60 точек доступа) |
| Failed |
|
Удаление немедленных и отложенных заданий на обновление
Для удаления немедленных и отложенных заданий на обновление ПО точек доступа, необходимо использовать команду clear wlc ap firmware-update { all | status { finished | failed } | task-id <TASK-ID> }, где
all - удаление всех заданий на обновления ПО, независимо от их статуса;
status - указание конкретного задания на обновления с определенным статусом:
- finished - удаление всех заданий на обновление ПО, которые завершились успешно;
- failed - удаление всех заданий на обновление ПО, которые завершились некорректно.
<TASK-ID> - уникальный task-id задания на обновление ПО, который необходимо удалить.
#удаление всех заданий на обновление ПО, независимо от их статуса. wlc#clear wlc ap firmware-update status all #удаление заданий на обновление ПО, которые завершились успешно (статус Finished) wlc# clear wlc ap firmware-update status finished #удаление заданий на обновление ПО, которые завершились некорректно (статус Failed) wlc# clear wlc ap firmware-update status failed #удаление конкретного задания на обновление ПО с уникальным task-id 10 wlc# clear wlc ap firmware-update status task-id 10
Ежедневные (цикличные) обновления ПО всех точек доступа в определенный временной интервал
В конфигурации WLC для того, чтобы избежать прерывание сервиса во время обновления, предусмотрен менеджер обновлений update-manager, который позволяет установить временной интервал, в течение которого может быть запущено обновление. Настройка состоит из четырех параметров:
- start-time – начало интервала времени, в который производится обновление. Значение по умолчанию: 03:00;
- end-time – окончание интервала времени, в который производится обновление. Значение по умолчанию: 04:00;
- scheduled – включение менеджера обновлений по расписанию. Значение по умолчанию: no scheduled (выключен);
- allow-update-with-clients – включение возможности обновления точек доступа, к которым на момент обновления подключены клиенты. Значение по умолчанию: no allow-update-with-clients (запрещено обновлять точки доступа с клиентами).
При включенном менеджере, обновление по расписанию будет выполняться только для точек доступа, которые уже находятся под управлением контроллера.
Пример настройки
# Настройка менеджера обновления по расписанию. Интервал для обновлений: 00:00 - 01:00.
# Запрещено обновлять точки с клиентами (настройка не требуется, включено по умолчанию).
wlc# configure
wlc(config)# wlc
wlc(config-wlc)# update-manager
wlc(config-wlc-update-mgr)# start-time 00:00
wlc(config-wlc-update-mgr)# end-time 01:00
wlc(config-wlc-update-mgr)# scheduled
# Применение и сохранение конфигурации
wlc(config-wlc-update-mgr)# do commit
wlc(config-wlc-update-mgr)# do confirm
# Просмотр конфигурации
wlc# show run wlc update-manager
update-manager
scheduled
start-time 00:00
end-time 01:00
exit
wlc#
При такой настройке обновление точек доступа, которые уже находятся под управлением контроллера на актуальную загруженную версию произойдет в интервале времени 00:00–01:00.
Минимальные требуемые версии ПО точек доступа
Минимальные требуемые версии ПО точек доступа, для работы под управлением контроллера WLC версий 1.36.4 указаны в таблице ниже:
| Модель точки доступа | Минимальная версия ПО |
|---|---|
| WEP-1L | 2.8.0 |
| WEP-2L | 2.8.0 |
| WEP-3L | 2.7.0 |
| WEP-200L | 2.8.0 |
| WEP-30L | 2.8.0 |
| WEP-30L-Z | 2.8.0 |
| WEP-3ax | 1.15.0 |
| WEP-50L | 3.1.0 |
| WEP-550K | 1.2.2 |
| WOP-2L | 2.8.0 |
| WOP-20L | 2.8.0 |
| WOP-30L | 2.8.0 |
| WOP-30LS | 2.8.0 |
| WOP-30LI | 2.8.0 |
WEP-2ac | 1.25.6 |
WEP-2ac Smart | 1.25.6 |
WOP-2ac | 1.25.6 |
WOP-2ac rev.B | 1.25.6 |
WOP-2ac rev.C | 1.25.6 |
WOP-3L-EX | 2.7.0 |