Всегда загружайте актуальную версию ПО точек доступа на контроллер для обновления новых точек при их подключении. Это требуется для корректной работы, т.к. управление контроллером поддерживается не на всех версиях ПО точек доступа. 

Важные моменты:

, то актуальным будет ПО 1.6.0_build_50.tar.gz.

Загрузка ПО точки доступа на контроллер

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

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.

Просмотр всех файлов ПО точек доступа загруженных на контроллер

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

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

Просмотр минимальной требуемой версии ПО конкретных моделей точек доступа  для работы с контроллером, а так же версии и архива ПО, который будет использован в последующих обновлениях

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

  1. Обновления ПО новых точек доступа, которые подключаются с версией ПО ниже минимальной. Такие точки доступа будут обновлены всегда, при условии, что на контроллере присутствует файл с версией ПО равной либо выше минимально допустимой версией для работы с контроллером
    Подробная информация и команда для просмотра информации описаны в пункте: "Просмотр минимальной требуемой версии ПО конкретных моделей точек доступа  для работы с контроллером, а так же версию и архив ПО, который будет использован в последующих обновлениях"
  2. Немедленные задания на обновления ПО точек доступа
  3. Отложенные задания на обновления ПО точек доступа
  4. Ежедневные (цикличные) обновления ПО всех точек доступа



Немедленные и отложенные задания на обновления ПО точек доступа

Общая информация 

  1. Максимальное количество немедленных и отложенных заданий на обновление ПО, которые можно создать равно 255.  При превышении лимита необходимо удалить задания на обновлении ПО с помощью команды: clear wlc ap firmware-update
    #пример сообщения при превышении лимита в 255 заданий на обновление ПО.
SA_FW:number of manual upgrades hit limit: 255. Please clear some tasks
  2. Контроллер выполняет немедленные и отложенные задания на обновление ПО параллельно для 50 точек доступа. 
  3. Контроллер выполняет немедленные и отложенные задания на обновление ПО независимо от подключенных к точкам доступа клиентам. Всегда будет происходит перерыв сервиса на всех точках, которые являются объектом таких обновлений.
  4. Задания на обновление ПО со статусом Finished автоматически удаляются из вывода команды show wlc ap firmware-update status через 1 месяц.
    #пример сообщения при автоматическом удалении задания на обновление ПО с task-id 10
SA_FW:upgrade task (id: 10). Reached after finish cleaning time. Task cleared
  5. Немедленные и отложенные задания на обновления ПО точек доступа сохраняются в случае нештатных ситуаций:
    При перезагрузке контроллера
    При смене статуса VRRP MASTER, когда контроллер работает в схеме с резервированием или в кластере.
  6. Модели точек доступа, для которых отсутствует архив с ПО, исключаются из задания на обновление. Если точка доступа единственная в рамках задания на обновление, то задание завершается некорректно (статус 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

Отложенное задание на обновление ПО точек доступа

  1.  Отложенные обновления выполняются по текущему системному времени контроллера, поэтому изменение системного времени контроллера вручную через команду set date или со стороны NTP ( ntp server ) влияет на время начала интервала обновления для  уже ранее созданных заданий.

    Рекомендуется всегда проверять наличие отложенных заданий на обновление (статус Scheduled) в выводе команды show wlc ap firmware-update status, перед изменением системного времени контроллера вручную или со стороны NTP сервера.

    Если такие задания на обновления присутствуют, необходимо удалить их с помощью команды clear wlc ap firmware-update, изменить системное время и только потом создать их заного.

  2. Минимальный интервал отложенного задания на обновление ТД: 10 минут, максимальный: 24 часа.
  3. Отложенные задания на обновление сохраняют часовой пояс на момент cоздания. Изменение часового пояса в глобальной конфигурации через команду clock timzone или в локации точки доступа через команду timezone не влияет на уже ранее созданные  отложенные задания на обновления.
  4. Отложенные задания на обновление ПО могут завершиться раньше, чем фактическое значение параметра stop-time, если все точки доступа в рамках задания успешно обновлены.
  5. Если точка доступа перешла в статус 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 и точки доступ расположены в разных часовых поясах и требуется выполнять обновления ПО точек доступа с учетом разницы часовых поясов, необходимо:

Пример:

# текущая настройка часового пояса на 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
  • Задание на обновление завершилось некорректно
  • Не была обновлена ни одна ТД за интервал обновления (границы интервала обновления определяются параметрами start-time и stop-time)
  • Произошла ошибка по неожиданной причине


Удаление немедленных и отложенных заданий на обновлений ПО точек доступа

Для удаления немедленных и отложенных заданий на обновление ПО точек доступа, необходимо использовать команду clear wlc ap firmware-update { all | status { finished | failed } | task-id <TASK-ID> } где

all - удаление всех заданий на обновления ПО, независимо от их статуса.

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

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

При включенном менеджере, обновление по расписанию будет выполняться только для точек доступа, которые уже находятся под управлением контроллера.

Пример настройки

# Настройка менеджера обновления по расписанию. Интервал для обновлений: 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

Минимальные требуемые версии ПО точек доступа, для работы под управлением контроллера WLC версий 1.36.4 указаны в таблице ниже:

Модель точки доступаМинимальная версия ПО
WEP-1L2.8.0
WEP-2L2.8.0
WEP-3L2.7.0
WEP-200L2.8.0
WEP-30L2.8.0
WEP-30L-Z2.8.0
WEP-3ax1.15.0
WEP-50L3.1.0
WEP-550K1.2.2
WOP-2L2.8.0
WOP-20L2.8.0
WOP-30L2.8.0
WOP-30LS2.8.0
WOP-30LI2.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