device-upgrade (user and privi exec modes)

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

Note

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

In an hierarchically managed (HM) network, this command enables centralized device upgradation across the network.

The WiNG HM network defines a three-tier structure, consisting of multiple wireless sites managed by a single NOC (Network Operations Center) controller. The NOC controller constitutes the first and the site controllers constitute the second tier of the hierarchy respectively. The site controllers may or may not be grouped to form clusters. The site controllers in turn adopt and manage access points that form the third tier of the hierarchy.

Note

Hierarchical management allows the NOC controller to upgrade controllers and access points that are directly or indirectly adopted to it. However, ensure that the NOC controller is loaded with the correct firmware version.

Use the device-upgrade command to schedule firmware upgrades across adopted devices within the network. Devices are upgraded based on their device names, MAC addresses, or RF Domain.

Note

If the persist-images option is selected, the RF Domain manager retains the old firmware image, or else deletes it. For more information on enabling device upgrade on profiles and devices (including the ‘persist-images‘ option), see device-upgrade.

Note

A NOC controller‘s capacity is equal to, or higher than that of a site controller. The following devices can be deployed at NOC and sites:

NOC controller – NX9500, NX9600, VX9000
Site controller – RFS4010, NX5500, or NX7500

Note

Standalone devices have to be manually upgraded.

Supported in the following platforms:

Access Points — AP7502, AP7522, AP7532, AP7562, AP7602, AP7612, AP7622, AP7632, AP7662, AP8163, AP8432, AP8533
Wireless Controller — RFS4010
Service Platforms — NX5500, NX7500, NX9500, NX9600, VX9000

Syntax

device-upgrade [<MAC/HOSTNAME>|all|ap7502|ap7522|ap7532|ap7602|ap7612|ap7622|ap7632|ap7662|
ap8163|ap8432|ap8533|rfs4000|nx5500|nx75xx|nx9000|nx9600|vx9000|cancel-upgrade|load-image|
rf-domain]

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

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

device-upgrade [ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap81xx|ap8432|
ap8533|rfs4000|nx5500|nx75xx|nx9000|nx9600|vx9000] all {force|no-reboot|reboot-time <TIME>|
upgrade-time <TIME> {no-reboot|reboot-time <TIME>}} {(staggered-reboot)}

device-upgrade cancel-upgrade [<MAC/HOSTNAME>|all|ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|
ap7622|ap7632|ap7662|ap81xx|ap8432|ap8533|rfs4000|nx5500|nx75xx|nx9000|nx9600|vx9000|
on rf-domain [<RF-DOMAIN-NAME>|all]]

device-upgrade load-image [ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap81xx|
ap8432|ap8533|rfs4000|nx5500|nx75xx|nx9000|nx9600|vx9000] {<IMAGE-URL>|on <DEVICE-OR-DOMAIN-NAME>}

device-upgrade rf-domain [<RF-DOMAIN-NAME>|all|containing <WORD>|filter location <WORD>] 
[all|ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap76232|ap7662|ap81xx|ap8432|ap8533|
rfs4000|nx5500|nx75xx|nx9000|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 <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 [ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap81xx|ap8432|
ap8533|rfs4000|nx5500|nx75xx|nx9000|nx9600|vx9000] all {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. 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|ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|
ap7622|ap7632|ap7662|ap81xx|ap8432|ap8533|rfs4000|nx5500|nx75xx|nx9000|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.
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 [ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap81xx|
ap8432|ap8533|rfs4000|nx5500|nx75xx|nx9000|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.

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|ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap81xx|ap8432|ap8533|
rfs4000|nx5500|nx75xx|nx9000|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. 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 for upgradation. 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  5.9.5.0-001D  version-mismatch  No  nx9500-6C8809 0 days 00:49:26  55 days 02:40:43  10.234.160.13
ap7562-84A224  5.9.5.0-001D  version-mismatch  No  nx9500-6C8809 0 days 00:49:26  55 days 02:40:18  10.234.160.6
ap7532-DF9A4C  5.9.5.0-001D  version-mismatch  No  nx9500-6C8809 0 days 00:49:26  55 days 02:40:41  10.234.160.12
---------------------------------------------------------------------------------------------------------------------------------
Total number of devices displayed: 3
nx9500-6C8809#

nx9500-6C8809#device-upgrade rf-domain WiNG5 all
In progress ....
---------------------------------------------------------------------------------------------------------
      CONTROLLER       STATUS                                   MESSAGE
---------------------------------------------------------------------------------------------------------
  B4-C7-99-6C-88-09   Success   WiNG5(device type-count: ap7562-1 ap7532-1 ap8432-1 added for upgrade),
---------------------------------------------------------------------------------------------------------
nx9500-6C8809#

nx9500-6C8809#show device-upgrade status
Number of devices currently being upgraded : 0
Number of devices waiting in queue to be upgraded : 1
Number of devices currently being rebooted : 0
Number of devices waiting in queue to be rebooted : 0
Number of devices failed upgrade : 0
-------------------------------------------------------------------------------------------------------------------
      DEVICE            STATE        UPGRADE TIME REBOOT TIME PROGRESS RETRIES LAST UPDATE ERROR    UPGRADED BY
-------------------------------------------------------------------------------------------------------------------
  ap8432-070235   upgrading-devices   immediate    immediate   0        0       -                 ap8432-070235
  ap7562-84A224   waiting             immediate    immediate   0        0       -                 ap8432-070235
-------------------------------------------------------------------------------------------------------------------
nx9500-6C8809#

Published June 2019prev | next

Email this topic

Print this page Print this page

Leave feedback Feedback