device-upgrade

Note
This command and its syntax is common to both the User
Executable and Privilege
Executable configuration modes.
Supported in the following platforms:
- Access Points —
AP505i, AP510i, AP510e, AP560i, AP6522, AP6562, AP7161, AP7502,
AP7522, AP7532, AP7562, AP7602, AP7612, AP7622, AP763, AP7662,
AP8163, AP8543, AP8533.
- Service Platforms
— NX5500, NX7500, NX9500, NX9600, VX9000
Syntax
device-upgrade [<MAC/HOSTNAME>|all|ap510|ap505|ap6522|ap6562|ap7502|ap7522|
ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap8163|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 [ap510|ap505|ap6522|ap6562|ap7502|ap7522|ap7532|ap7562|ap7602|
ap7612|ap7622|ap7632|ap7662|ap8163|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|ap510|ap505|ap6522|ap6562|
ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap8163|ap8432|ap8533|
nx5500|nx7500|nx9500|nx9600|vx9000|on rf-domain [<RF-DOMAIN-NAME>|all]]
device-upgrade load-image [ap510|ap505|ap6522|ap6562|ap7502|ap7522|ap7532|
ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap8163|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|ap510|ap505|ap6522|ap6562|ap7502|ap7522|ap7532|ap7562|
ap7602|ap7612|ap7622|ap7632|ap7662|ap8163|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
|
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
|
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
|
|
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
|
staggered-reboot
|
This keyword is recursive and common to all
of the above.
|
|
device-upgrade [ap510|ap505|ap6522|ap6562|ap7502|ap7522|ap7532|ap7562|ap7602|
ap7612|ap7622|ap7632|ap7662|ap8163|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,
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
|
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
|
staggered-reboot
|
This keyword is recursive and common to all
of the above.
|
|
device-upgrade cancel-upgrade [<MAC/HOSTNAME>|all|ap510|ap505|ap6522|ap6562|
ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap8163|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 and ap505 |
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 [ap510|ap505|ap6522|ap6562|ap7502|ap7522|ap7532|
ap7562|ap7602|ap7612|ap7622|ap7632|ap7662|ap8163|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: AP510, AP505, 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|ap510|ap505|ap6522|ap6562|ap7502|ap7522|ap7532|ap7562|ap7602|ap7612|ap7622|ap7632|
ap7662|ap8163|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: AP510, AP505, 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
------------------------------------------------------------------------------------------------
ap8432-070235 5.9.4.0-015D configured No nx9500-6C8809 0 days 00:22:49 9 days 22:53:56
ap7562-84A224 5.9.4.0-010D configured No nx9500-6C8809 0 days 00:22:47 45 days 14:26:08
ap7532-DF9A4C 5.9.4.0-010D configured No nx9500-6C8809 0 days 00:22:47 22 days 14:17:30
ap505-134038 7.1.0.0-128D version-mismatch No nx9500-6C8809 0 days 00:22:47 1 days 00:40:37
-------------------------------------------------------------------------------------------------
Total number of devices displayed: 4
nx9500-6C8809#
nx9500-6C8809>device-upgrade ap505-134038
--------------------------------------------------------------------------------
CONTROLLER STATUS MESSAGE
--------------------------------------------------------------------------------
B4-C7-99-6C-88-09 Success Queued 1 devices to upgrade
--------------------------------------------------------------------------------
nx9500-6C8809>
nx9500-6C8809#show device-upgrade status
Number of devices currently being upgraded : 1
Number of devices waiting in queue to be upgraded : 0
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
-----------------------------------------------------------------------------------------------------
ap505-134038 downloading immediate immediate 11 0 - nx9500-6C8809
-----------------------------------------------------------------------------------------------------
nx9500-6C8809#