device-upgrade

Note

Note

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

Supported on the following devices:

Syntax

device-upgrade [<MAC/HOSTNAME>|all|ap3000|ap3000x|ap310|ap360|ap410|ap460|ap505|ap510|ap560|ap7522|ap7532|ap7562|ap7612|ap7632|ap7662|ap8432|ap8533|cx9000׀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 [ap3000|ap3000x|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|ap3000|ap3000x|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 [ap3000|ap3000x|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 operational-mode [all׀ap3000|ap3000-1|ap302w|ap305c׀ap305c-1׀ap305cx|ap410c|ap410c-1׀ap460c׀ap5010|containing|rf-domain] xiq-cloud
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|ap3000|ap3000x|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, AP5010, AP410, AP460, AP3000/X, AP310, AP360, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, AP8432, AP8533, NX5500, NX7500, NX9500, NX9600, CX9000, 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|ap3000|ap3000x|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, AP5010, AP410, AP460, AP3000/X, AP310, AP360, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, AP8432, AP8533, NX5500, NX7500, NX9500, NX9600, CX9000, 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 [ap3000|ap3000x|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: AP3000/X, AP310, AP360, AP410, AP460, AP510, AP505, AP560, AP5010, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, AP8432, AP8533, NX5500, NX7500, NX9500, NX9600, CX9000, 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, virtual platform, or RF Domain.
 
device-upgrade operational-mode [all׀ap3000|ap3000-1|ap302w|ap305c׀ap305c-1׀ap305cx|ap410c|ap410c-1׀ap460c׀ap5010|containing|rf-domain] xiq-cloud
device-upgrade operational-mode all xiq-cloud
device-upgrade operational-mode <DEVICE-TYPE> [all׀containing <HOSTNAME-SUBSTRING>] xiq-cloud
device-upgrade operational-mode containing <HOSTNAME-SUBSTRING> xiq-cloud
device-upgrade operational-mode rf-domain [<RF-DOMAIN-NAME>׀all׀containing <RF-DOMAIN-NAME-SUBSTRING>׀filter location <LOCATION> [all׀ap3000|ap3000-1|ap302w|ap305c׀ap305c-1׀ap305cx| ap410c|ap410c-1׀ap460c׀ap5010] xiq-cloud
operational-mode xiq-cloud

Resets the operational mode of eligible ExtremeWireless WiNG locally-managed Universal APs to xiq-cloud (factory settings). From the factory, Universal APs are configured for management by ExtremeCloud IQ and always engage with ExtremeCloud IQ for onboarding.

Use this command to faciltate migration of eligible Universal APs from on-premise management using ExtremeWireless WiNG to cloud management using ExtremeCloud IQ.

This command provides the following options:

  • Reset all eligible Universal APs currently adopted by the controller to factory settings.
  • Reset specified family of eligible Universal APs to factory settings.
  • Reset eligible Universal APs with a specified sub-string in the hostname to factory settings.
  • Reset eligible Universal APs in a specified RF Domain (site) to factory settings.

Eligible Universal APs—designated as <DEVICE-TYPE> in syntax below—include these models: AP3000, AP3000-1, AP302W, AP305C, AP305C-1AP305CX, AP410C, AP410C-1, AP460C, AP5010
operational-mode all xiq-cloud Optional. Resets the operational mode of all eligible controller-adopted Universal APs to xiq-cloud.
operational-mode <DEVICE-TYPE> [all׀containing <HOSTNAME-SUBSTRING>] xiq-cloud Optional. Resets (to xiq-cloud) the operational mode of all eligible controller-adopted Universal APs matching the specified device type or device type containing the specified host name and sub-string.
  • <DEVICE-TYPE> — specifies an eligible Universal AP
  • all — resets the operational mode of all Universal APs of the specified <DEVICE-TYPE>
  • containing — resets the operational mode of the specified <DEVICE-TYPE> containing the specified <HOSTNAME-SUBSTRING>
  • xiq-cloud — the operational-mode
operational-mode containing <HOSTNAME-SUBSTRING> xiq-cloud Optional. Resets (to xiq-cloud) the operational mode of all eligible controller-adopted Universal APs with the specified host name and sub-string.
operational-mode rf-domain [<RF-DOMAIN-NAME>׀all׀containing <RF-DOMAIN-NAME-SUBSTRING>׀filter location <LOCATION> [all׀<DEVICE-TYPE>] xiq-cloud Optional. Resets (to xiq-cloud) the operational mode of all eligible controller-adopted Universal APs that are in all controller-managed RF Domains, or in the specified RF Domain, or in all RF Domains at a specified location.
  • <RF-DOMAIN-NAME> — resets the operational mode of all eligible Universal APs in the specified RF Domain
  • all — resets the operational mode of all eligible Universal APs in all controller-managed RF Domains
  • containing — resets the operational mode of all eligible Universal APs within RF Domains whose name contains the sub-string identified by the <RF-DOMAIN-NAME-SUBSTRING>
  • filter location — resets the operational mode of all eligible Universal APs or the specified <DEVICE-TYPE> within all RF Domains or the specified RF Domain at the specified <LOCATION>
  • xiq-cloud — the operational-mode
 
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, AP3000/X, AP5010, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, AP8432, AP8533, NX5500, NX7500, NX9500, NX9600, CX9000, 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#
9037762-04 Rev AA