Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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

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

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

Блок кода
languagevb
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.

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

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

Блок кода
languagevb
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  

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

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

Блок кода
languagec#
# Столбец 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                      --                                 --                                                                 

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

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

Блок кода
languagec#
# Удаление всех файлов ПО. Команда требует подтверждения
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

Предупреждение

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

Блок кода
languagebash
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 в сервис-активаторе:

...

Примечание

Настройка aps auto-upgrade disable не влияет на:

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

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

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

Информация
  1. Максимальное количество немедленных и отложенных заданий на обновление ПО, которые можно создать равно 255.  При превышении лимита необходимо удалить задания на обновлении ПО с помощью команды: clear wlc ap firmware-update
    Блок кода
    languagec#
    #пример сообщения при превышении лимита в 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 месяц.
    Блок кода
    languagec#
    #пример сообщения при автоматическом удалении задания на обновление ПО с task-id 10
    SA_FW:upgrade task (id: 10). Reached after finish cleaning time. Task cleared
  5. Немедленные и отложенные задания на обновления ПО точек доступа сохраняются в случае нештатных ситуаций:
    1. При перезагрузке контроллера
    2. При смене статуса 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> , где

...

Блок кода
languagec#
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

Немедленное задание на обновление ПО всех точек доступа в рамках конкретной локации

Якорь
немедлокация
немедлокация

...

Блок кода
languagec#
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

...

Блок кода
languagec#
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 ) влияет на время начала интервала обновления для  уже ранее созданных заданий.
    Информация
    titleРекомендация

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

...

Блок кода
languagec#
#Пример отложенного обновления точки доступа с 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> где,

...

Блок кода
# текущая настройка часового пояса на 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

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

Якорь
просмотрстатусаобновления
просмотрстатусаобновления

...

Возможные статусы заданий на обновление ПО точек доступаОписание
ScheduledЗадание на обновление запланировано и еще не выполнялось
RunningЗадание на обновление выполняется
FinishedЗадание на обновление завершилось успешно
PartialЗадание на обновление завершилось частично. Обновлена хотя бы одна ТД (Например при обновлении локации, в которой находится 64 точек доступа, обновились 60 точек доступа)
Failed
  • Задание на обновление завершилось некорректно
  • Не была обновлена ни одна ТД за интервал обновления (границы интервала обновления определяются параметрами start-time и stop-time)
  • Произошла ошибка по неожиданной причине

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

Якорь
удалениеобновлений
удалениеобновлений

...