ap update schedule-task

Function

The ap update schedule-task command configures a scheduled AP upgrade task.

The undo ap update schedule-task command deletes a scheduled AP upgrade task.

By default, no scheduled AP upgrade task is configured.

Format

ap update schedule-task task-id task-id start-time start-time start-date stop-time stop-time stop-date ap-type type-id [ ap-group group-name | { { ap-name ap-name } &<1-10> } | { { ap-id ap-id } &<1-10> } ]

ap update schedule-task task-id task-id start-time start-time start-date stop-time stop-time stop-date ap-group group-name

undo ap update schedule-task { all | task-id task-id }

Parameters

Parameter	Description	Value
task-id task-id	Specifies the ID of a scheduled AP upgrade task.	The value is an integer that ranges from 0 to 31.
start-time start-time	Specifies the start time of the scheduled AP upgrade task.	The value is in HH:MM format, ranging from 00:00 to 23:59.
start-date	Specifies the start date of the scheduled AP upgrade task.	The value is in YYYY/MM/DD format, ranging from 2000-01-01 to 2050-12-31.
stop-time stop-time	Specifies the end time of the scheduled AP upgrade task.	The value is in HH:MM format, ranging from 00:00 to 23:59.
stop-date	Specifies the end date of the scheduled AP upgrade task.	The value is in YYYY/MM/DD format, ranging from 2000-01-01 to 2050-12-31. stop-time stop-date must be later than start-time start-date.
ap-type type-id	Specifies an AP type ID.	The value is an integer. To view all AP types, run the display ap-type all command.
ap-group group-name	Specifies an AP group name.	The AP group must exist. The value is a string of 1 to 35 characters, which can be Chinese characters or Chinese + English characters. It cannot contain question marks (?) or slashes (/), and cannot start or end with spaces or double quotation marks (" "). If the AP group name contains spaces, the input name must start and end with a quotation mark ("), for example, "huawei name1". The quotation marks at the beginning and end of the AP group name occupy two characters in total. NOTE: You can only use a command editor of the UTF-8 encoding format to edit Chinese characters.
ap-name ap-name	Specifies an AP name.	The AP name must exist.
ap-id ap-id	Specifies an AP ID.	The AP ID must exist.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can configure a scheduled AP upgrade task to upgrade APs in a specified time period, such as off-peak hours.

If you specify ap-group group-name in the command, the configured task will upgrade only APs in the specified AP group. Similarly, if you specify ap-type type-id, ap-name ap-name, or ap-id ap-id, the configured task will upgrade only the specified APs.

The scheduled task configuration will not be automatically deleted after a scheduled upgrade task is completed. To delete the task, run the undo ap update schedule-task { all | task-id task-id } command.

Prerequisites

The AP upgrade file has been specified using the ap update update-filename command.

Configuration Impact

After scheduled upgrade tasks are configured, automatic upgrade cannot be performed if not all tasks are in the DONE, OVERTIME, or DEAD state. To perform automatic upgrade, you need to delete the scheduled upgrade tasks not in DONE, OVERTIME, or DEAD state. To check the status of scheduled AP upgrade tasks, run the display ap update schedule-task command.

Precautions

For scheduled AP upgrade tasks with the same start time, the task with a smaller task-id task-id is executed preferentially.
During the scheduled AP upgrade, if the time for task B is reached before task A is completed, task B waits until task A is completed. Subsequent scheduled AP upgrade tasks wait in sequence until the previous task is completed.
When the time specified by stop-time stop-time stop-date is reached, ongoing upgrade tasks continue until the upgrade is completed and those tasks waiting in queues stop.
After APs in a scheduled upgrade task are all upgraded, the APs automatically restart. The APs that fail the upgrade do not restart.
After a scheduled AP upgrade task is configured, if the AP group or all APs are deleted, the task fails to be executed, which is not recorded as upgrade failure information.
If an AP is performing the automatic upgrade when you configure a scheduled AP upgrade task, the upgrade continues until the upgrade is completed. APs that have not started the automatic upgrade will not execute the automatic upgrade.
If the system time is changed after you configure a scheduled AP upgrade task, the following impacts may be caused:
- If the system time is changed before the scheduled AP upgrade task starts, the start time and end time of the scheduled AP upgrade task are subject to the system time after the change. For example, the current system time is 1:00, and the start time and end time of the scheduled AP upgrade task are 3:00 and 4:00 respectively. When the system time is changed to 2:00 at 1:05, the start time and end time of the scheduled AP upgrade task are still 3:00 and 4:00 respectively.
- If the system time is changed after the scheduled AP upgrade task starts, the start time and end time of the scheduled AP upgrade task are subject to the system time before the change.

Example

# Configure APs with ap-type as 54 to perform the scheduled upgrade from 01:00 to 04:00 on May 20, 2018.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update schedule-task task-id 1 start-time 1:00 2018/5/20 stop-time 4:00 2018/5/20 ap-type 54