Configuring a Scheduled AP Upgrade Task

Context

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

Similar to in-service upgrades, scheduled upgrades do not affect services. APs can properly work during the upgrade file download. Different from in-service upgrades, scheduled upgrade tasks can be pre-configured so that APs are upgraded at the specified time, without the need to manually configure commands.

Prerequisites

The AP version file has been uploaded to the AC, SFTP server, or FTP server.

Procedure

Run system-view
The system view is displayed.
Run wlan
The WLAN view is displayed.
Run the following commands as required:
- AC mode
  
  Run ap update mode ac-mode
  
  The AP upgrade mode is set to AC mode.
  
  The default upgrade mode is ac-mode.
  
  If the source AP version is V200R008 or earlier, the APs cannot be upgraded in AC mode.
- FTP mode
  1. Run ap update mode ftp-mode
    
    The AP upgrade mode is set to FTP mode.
    
    The default upgrade mode is ac-mode.
  2. Run ap update ftp-server ip-address server-ip-address ftp-username ftp-username ftp-password cipher ftp-password
    
    Basic FTP information is configured.
    
    By default, no IP address, user name, or password is configured for the FTP server.
  3. Run ap update ftp-server max-connect-number max-connect-number
    
    The maximum number of APs to be upgraded simultaneously is configured.
    
    By default, a maximum of 50 APs can be upgraded simultaneously in FTP mode.
    An external FTP server can be used, which is recommended. The AC can also function as the FTP server.
    When an external FTP server is used, the maximum number of APs that can be upgraded simultaneously is the configured max-connect-number.
    If an AC is used as the FTP server, a maximum of five APs can be upgraded simultaneously even if the specified number is larger than five.
    
    When the AC functions as the FTP server, run the ap update ftp-server max-connect-number max-connect-number command to set the maximum number of APs that can be upgraded simultaneously. The value of max-connect-number is an integer ranging from 1 to 5. During the upgrade, a maximum of 1 to 5 APs can be upgraded at a time until all APs are upgraded.
    
    If the configured number of APs to be upgraded simultaneously is larger than five, an error message will be displayed after the first five APs are upgraded. The remaining APs cannot be automatically upgraded. You have to repeat the command until all APs are upgraded.
    
    If there are n login VTY users, the maximum number of APs that can be upgraded simultaneously is subtracted by n - 1.
- SFTP mode
  1. Run ap update mode sftp-mode
    
    The AP upgrade mode is set to SFTP mode.
    
    The default upgrade mode is ac-mode.
  2. Run ap update sftp-server ip-address server-ip-address sftp-username sftp-username sftp-password cipher sftp-password
    
    Basic SFTP information is configured.
    
    By default, no IP address, user name, or password is configured for the SFTP server.
  3. Run ap update sftp-server max-connect-number max-connect-number
    
    The maximum number of APs to be upgraded simultaneously is configured.
    
    By default, a maximum of 50 APs can be upgraded simultaneously in SFTP mode.
    An external SFTP server can be used, which is recommended. The AC can also function as the SFTP server.
    When an external SFTP server is used, the maximum number of APs that can be upgraded simultaneously is the configured max-connect-number.
    If an AC is used as the SFTP server, a maximum of five APs can be upgraded simultaneously even if the specified number is larger than five.
    
    When the AC functions as the SFTP server, run the ap update sftp-server max-connect-number max-connect-number command to set the maximum number of APs that can be upgraded simultaneously. The value of max-connect-number is an integer ranging from 1 to 5. During the upgrade, a maximum of 1 to 5 APs can be upgraded at a time until all APs are upgraded.
    
    If max-connect-number is set larger than 5, an error message will be displayed after the first five APs are upgraded. The remaining APs cannot be automatically upgraded. You have to repeat the command until all APs are upgraded.
    
    If there are n login VTY users, the maximum number of APs that can be upgraded simultaneously is subtracted by n - 1.
Run ap update update-filename filename ap-type type-id [ ap-group ap-group-name ]
An upgrade file is configured for APs of a specified type.
Configure a scheduled AP upgrade task.
Run the 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> } ] or ap update schedule-task task-id task-id start-time start-time start-date stop-time stop-time stop-date ap-group group-name command to configure a scheduled AP upgrade task.
- 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.