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

Старая версия 36

changes.mady.by.user Брагов Леонид Александрович

Сохранено

по сравнению с

Новая версия 37

changes.mady.by.user Брагов Леонид Александрович

Сохранено

Ключ

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

Оглавление

Управление ПО точек доступа

Загрузка ПО

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

...

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


Просмотр файлов ПО

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

...

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

Удаление ПО

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

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

Якорь
немедлокация
немедлокация
Немедленное на обновление конкретной локации

Для немедленного обновления ПО точек доступа в рамках конкретной локации, используйте команду: update wlc ap firmware location <LOCATION> , где

...

Блок кода
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> где,

...

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

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

...

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

...

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

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

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

...