device-upgrade

Enables firmware upgrade on an adopted device or a set of adopted devices (access points, wireless controllers, and service platforms)

Note

Note

This command and its syntax is common to both the User Executable and Privilege Executable configuration modes.

Supported in the following platforms:

Syntax

device-upgrade [<MAC/HOSTNAME>|all|ap310|ap360|ap410|ap460|ap505|ap510|ap560|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000|cancel-upgrade|load-image|rf-domain]

device-upgrade <MAC/HOSTNAME> {no-reboot|reboot-time <TIME>|upgrade-time <TIME>

device-upgrade all {force|no-reboot|reboot-time <TIME>|staggered-reboot|upgrade-time <TIME> {no-reboot|reboot-time <TIME>}} {(staggered-reboot)}

device-upgrade [ap310|ap360|ap410|ap460|ap505|ap510|ap560|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000] [all|containing <SUB-STRING>] {force|no-reboot|reboot-time <TIME>|upgrade-time <TIME> {no-reboot|reboot-time <TIME>}}

device-upgrade cancel-upgrade [<MAC/HOSTNAME>|all|ap310|ap360|ap410|ap460|ap505|ap510|ap560|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000|on rf-domain [<RF-DOMAIN-NAME>|all]]

device-upgrade load-image [ap310|ap360|ap410|ap460|ap505|ap510|ap560|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000] {<IMAGE-URL>|on <DEVICE-OR-DOMAIN-NAME>}

device-upgrade rf-domain [<RF-DOMAIN-NAME>|all|containing <WORD>|filter location <WORD>] [all|ap310|ap360|ap410|ap460|ap505|ap510|ap560|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000] {(<MAC/HOSTNAME>|force|from-controller|no-reboot|reboot-time <TIME>|staggered-reboot|upgrade-time <TIME>)}

Parameters

device-upgrade <MAC/HOSTNAME> {no-reboot|reboot-time <TIME>|upgrade-time <TIME> {no-reboot|reboot-time <TIME>}}
<MAC/HOSTNAME> Upgrades firmware on the device identified by the <MAC/HOSTNAME> keyword
  • <MAC/HOSTNAME> – Specify the device's MAC address or hostname.
no-reboot Optional. Disables automatic reboot after a successful upgrade (the device must be manually restarted)
reboot-time <TIME> Optional. Schedules an automatic reboot after a successful upgrade
  • <TIME> – Specify the reboot time in the MM/DD/YYYY-HH:MM or HH:MM format.
upgrade-time <TIME> {no-reboot| reboot-time <TIME>} Optional. Schedules an automatic device firmware upgrade and specifies the time at which the device is to be upgraded
  • <TIME> – Specify the upgrade time in the MM/DD/YYYY-HH:MM or HH:MM format. The following actions can be performed after a scheduled upgrade:
    • no-reboot – Optional. Disables automatic reboot after a successful upgrade (the device must be manually restarted)
    • reboot-time <TIME> – Optional. Schedules an automatic reboot after a successful upgrade. Specify the reboot time in the MM/DD/YYYY-HH:MM or HH:MM format.
 
device-upgrade all {force|no-reboot|reboot-time <TIME>|upgrade-time <TIME> {no-reboot|reboot-time <TIME>}} {(staggered-reboot)}
all Upgrades firmware on all devices
force Optional. Select this option to force upgrade on the selected device(s). When selected, the devices are upgraded even if they have the same firmware as the upgrading access point, wireless controller, or service platform. If forcing a device upgrade, optionally specify any one of the following options: no-reboot, reboot-time, upgrade-time, or staggered-reboot.
no-reboot

Optional. Disables automatic reboot after a successful upgrade (the device must be manually restarted)
reboot-time <TIME> Optional. Schedules an automatic reboot after a successful upgrade
  • <TIME> – Specify the reboot time in the MM/DD/YYYY-HH:MM or HH:MM format.
upgrade-time <TIME> {no-reboot| reboot-time <TIME>} Optional. Schedules an automatic firmware upgrade on all devices, of the specified type, on a specified day and time
  • <TIME> – Specify the upgrade time in the MM/DD/YYYY-HH:MM or HH:MM format. The following actions can be performed after a scheduled upgrade:
    • no-reboot – Optional. Disables automatic reboot after a successful upgrade (the device must be manually restarted)
    • reboot-time <TIME> – Optional. Schedules an automatic reboot after a successful upgrade. Specify the reboot time in the MM/DD/YYYY-HH:MM or HH:MM format.
staggered-reboot This keyword is recursive and common to all of the above.
  • Optional. Enables staggered reboot (one at a time), without network impact
 
device-upgrade [ap505|ap510|ap560|ap410|ap460|ap310|ap360|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000] [all|containing <SUB-STRING] {force|no-reboot|reboot-time <TIME>|upgrade-time <TIME> {no-reboot|reboot-time <TIME>}} {(staggered-reboot)}
device-upgrade <DEVICE-TYPE> all Upgrades firmware on all devices of a specific type. Select the device type. The options are: AP510, AP505, AP560, AP410, AP460, AP310, AP360, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, AP8432, AP8533, NX5500, NX7500, NX9500, NX9600, VX9000.

After selecting the device type, schedule an automatic upgrade and/or an automatic reboot.
force Optional. Select this option to force upgrade on the selected device(s). When selected, the devices are upgraded even if they have the same firmware as the upgrading access point, wireless controller, or service platform. If forcing a device upgrade, optionally specify any one of the following options: no-reboot, reboot-time, upgrade-time, or staggered-reboot.
no-reboot Optional. Disables automatic reboot after a successful upgrade (the device must be manually restarted)
reboot-time <TIME> Optional. Schedules an automatic reboot after a successful upgrade
  • <TIME> – Optional. Specify the reboot time in the MM/DD/YYYY-HH:MM or HH:MM format.
upgrade-time <TIME> {no-reboot| reboot-time <TIME>} Optional. Schedules an automatic firmware upgrade on all devices, of the specified type, on a specified day and time
  • <TIME> – Specify the upgrade time in the MM/DD/YYYY-HH:MM or HH:MM format. The following actions can be performed after a scheduled upgrade:
    • no-reboot – Optional. Disables automatic reboot after a successful upgrade (the device must be manually restarted)
    • reboot-time <TIME> – Optional. Schedules an automatic reboot after a successful upgrade. Specify the reboot time in the MM/DD/YYYY-HH:MM or HH:MM format.
staggered-reboot This keyword is recursive and common to all of the above.
  • Optional. Enables staggered reboot (one at a time), without network impact
 
device-upgrade cancel-upgrade [<MAC/HOSTNAME>|all|ap505|ap510|ap560|ap410|ap460|ap310|ap360|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000|on rf-domain [<RF-DOMAIN-NAME>|all]]
cancel-upgrade Cancels a scheduled firmware upgrade based on the parameters passed. This command provides the following options to cancel scheduled firmware upgrades:
  • Cancels upgrade on specific device(s). The devices are identified by their MAC addresses or hostnames.
  • Cancels upgrade on all devices within the network
  • Cancels upgrade on all devices of a specific type. Specify the device type.
  • Cancels upgrade on specific device(s) or all device(s) within a specific RF Domain or all RF Domains. Specify the RF Domain name.
cancel-upgrade [<MAC/HOSTNAME>| all] Cancels a scheduled firmware upgrade on a specified device or on all devices
  • <MAC/HOSTNAME> – Cancels a scheduled upgrade on the device identified by the <MAC/HOSTNAME> keyword. Specify the device‘s MAC address or hostname.
  • all – Cancels scheduled upgrade on all devices
cancel-upgrade <DEVICE-TYPE> all Cancels scheduled firmware upgrade on all devices of a specific type. Select the device type. The options are: AP510, AP505, AP560, AP410, AP460, AP310, AP360, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, AP8432, AP8533, NX5500, NX7500, NX9500, NX9600, VX9000.
cancel-upgrade on rf-domain [<RF-DOMAIN-NAME>|all] Cancels scheduled firmware upgrade on all devices in a specified RF Domain or all RF Domains
  • <RF-DOMAIN-NAME> – Cancels scheduled device upgrade on all devices in a specified RF Domain. Specify the RF Domain name.
  • all – Cancels scheduled device upgrade on all devices across all RF Domains
 
device-upgrade load-image [ap310|ap360|ap410|ap460|ap505|ap510|ap560|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000] {<IMAGE-URL>|on <DEVICE-OR-DOMAIN-NAME>}
load-image <DEVICE-TYPE> Loads device firmware image from a specified location. Use this command to specify the device type and the location of the corresponding image file.
  • <DEVICE-TYPE> - Specify the device type. The options are: AP310, AP360, AP410, AP460, AP510, AP505, AP560, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, AP8432, AP8533, NX5500, NX7500, NX9500, NX9600, VX9000.

After specifying the device type, provide the location of the required device firmware image.
<IMAGE-URL> Specify the device‘s firmware image location in one of the following formats:

IPv4 URLs:

  • tftp://<hostname|IP>[:port]/path/file
  • ftp://<user>:<passwd>@<hostname|IP>[:port]/path/file
  • sftp://<user>:<passwd>@<hostname|IP>[:port]>/path/file
  • http://<hostname|IP>[:port]/path/file
  • cf:/path/file
  • usb<n>:/path/file

IPv6 URLs:

  • tftp://<hostname|IPv6>[:port]/path/file
  • ftp://<user>:<passwd>@<hostname|IPv6>[:port]/path/file
  • sftp://<user>:<passwd>@<hostname|IPv6>[:port]>/path/file
  • http://<hostname|IPv6>[:port]/path/file
on <DEVICE-OR-DOMAIN-NAME> Specify the name of the device or RF Domain. The image, of the specified device type is loaded from the device specified here. In case of an RF Domain, the image available on the RF Domain manager is loaded.
  • <DEVICE-OR-DOMAIN-NAME> – Specify the name of the AP, wireless controller, service platform, or RF Domain.
 
device-upgrade rf-domain [<RF-DOMAIN-NAME>|all|containing <WORD>|filter location <WORD>] [all|ap310|ap360|ap410|ap460|ap505|ap510|ap560|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|nx5500|nx7500|nx9500|nx9600|vx9000] {(<MAC/HOSTNAME>|force|from-controller|no-reboot|reboot-time <TIME>|staggered-reboot|upgrade-time <TIME>)}
rf-domain [<RF-DOMAIN-NAME>|all| containing <WORD>| filter location <WORD>] Upgrades firmware on devices in a specified RF Domain or all RF Domains. Devices within a RF Domain are upgraded through the RF Domain manager.
  • <RF-DOMAIN-NAME> – Upgrades devices in the RF Domain identified by the <RF-DOMAIN-NAME> keyword.
    • <RF-DOMAIN-NAME> – Specify the RF Domain name.
  • all – Upgrades devices across all RF Domains
  • containing <WORD> – Filters RF Domains by their names. RF Domains with names containing the sub-string identified by the <WORD> keyword are filtered. Devices on the filtered RF Domains are upgraded.
  • filter location <WORD> – Filters devices by their location. All devices with location matching the <WORD> keyword are upgraded.
<DEVICE-TYPE> After specifying the RF Domain, select the device type. The options are: AP410, AP460, AP510, AP505, AP560, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, AP8432, AP8533, NX5500, NX7500, NX9500, NX9600, VX9000.

After specifying the RF Domain and the device type, configure any one of the following actions: force devices to upgrade, or initiate an upgrade through the adopting controller.
<MAC/HOSTNAME> Optional. Use this option to identify specific devices (by their MAC address/Hostnames) that are to be upgraded. Specify the device‘s MAC address or hostname. The device should be within the specified RF Domain and of the specified device type. After identifying the devices to upgrade, configure any one of the following actions: force devices to upgrade, or initiate an upgrade through the adopting controller.
Note: If no MAC address or hostname is specified, all devices of the type selected are upgraded.
force Optional. Select this option to force upgrade for the selected device(s). When selected, the devices are upgraded even if they have the same firmware as the upgrading access point, wireless controller, or service platform. If forcing a device upgrade, optionally specify any one of the following options: no-reboot, reboot-time, upgrade-time, or reboot-time.
from-controller Optional. Upgrades a device through the adopted device. If initiating an upgrade through the adopting controller, optionally specify any one of the following options: no-reboot, reboot-time, upgrade-time, or reboot-time.
no-reboot {staggered-reboot} Optional. Disables automatic reboot after a successful upgrade (the device must be manually restarted)
reboot-time <TIME> {staggered-reboot} Optional. Schedules an automatic reboot after a successful upgrade. Specify the reboot time in the MM/DD/YYYY-HH:MM or HH:MM format.
staggered-reboot This keyword is common to all of the above. Optional. Enables staggered reboot (one at a time) without network impact
upgrade-time <TIME> {no-reboot| reboot-time <TIME>} Optional. Schedules an automatic firmware upgrade
  • <TIME> – Specify the upgrade time in the MM/DD/YYYY-HH:MM or HH:MM format. After a scheduled upgrade, the following actions can be performed.
    • no-reboot – Optional. Disables automatic reboot after a successful upgrade the device must be manually restarted)
    • reboot-time <TIME> – Optional. Schedules an automatic reboot after a successful upgrade. Specify the reboot time in the MM/DD/YYYY-HH:MM or HH:MM format.

Examples

nx9500-6C8809#show adoption status
--------------------------------------------------------------------------------------------------------------
DEVICE-NAME    VERSION     CFG-STAT    MSGS   ADOPTED-BY      LAST-ADOPTION      UPTIME      IPv4-ADDRESS
--------------------------------------------------------------------------------------------------------------
ap8432-070235 7.3.0.0-001D  configured   No  nx9500-6C8809  0 days 00:16:53  0 days 00:18:11   0.0.0.0
ap7562-84A224 7.3.0.0-001D  configured   No  nx9500-6C8809  0 days 00:16:54  0 days 00:18:08   10.234.160.6
ap7532-DF9A4C 7.3.0.0-001D  configured   No  nx9500-6C8809  0 days 00:17:00  0 days 00:18:13   10.234.160.12
ap505-134038  7.3.0.0-001D  configured   No  nx9500-6C8809  0 days 00:27:25  0 days 00:28:50   10.234.160.36
--------------------------------------------------------------------------------------------------------------
nx9500-6C8809#

nx9500-6C8809#device-upgrade all
In progress ....
--------------------------------------------------------------------------------
       CONTROLLER         STATUS                     MESSAGE
--------------------------------------------------------------------------------
  B4-C7-99-6C-88-09     Success     Number of devices added for upgrade: 4
--------------------------------------------------------------------------------
nx9500-6C8809#

nx9500-6C8809#show adoption status
------------------------------------------------------------------------------------------------------------
DEVICE-NAME    VERSION       CFG-STAT   MSGS   ADOPTED-BY    LAST-ADOPTION      UPTIME       IPv4-ADDRESS
------------------------------------------------------------------------------------------------------------
ap8432-070235 7.3.0.0-002D  configured   No  nx9500-6C8809  0 days 04:04:21  0 days 04:05:36  0.0.0.0
ap7562-84A224 7.3.0.0-002D  configured   No  nx9500-6C8809  0 days 04:04:19  0 days 04:05:36  10.234.160.6
ap7532-DF9A4C 7.3.0.0-002D  configured   No  nx9500-6C8809  0 days 04:04:24  0 days 04:05:37  10.234.160.12
ap505-134038  7.3.0.0-002D  configured   No  nx9500-6C8809  0 days 04:04:58  0 days 04:05:32  10.234.160.36
------------------------------------------------------------------------------------------------------------
Total number of devices displayed: 4
nx9500-6C8809#
9036514-01 Rev AA