Print this pagePrint this page

Email this topicEmail this topic

View PDFView PDF

Download EPUBDownload EPUB

device-upgrade

Note

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/e, AP560i/h
  • Service Platforms — NX5500, NX7500, NX9500, NX9600, VX9000

Syntax

device-upgrade [<MAC/HOSTNAME>|all|ap505|ap510|ap560|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 [ap505|ap510|ap560|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|ap505|ap510|ap560|nx5500|nx7500|nx9500|
nx9600|vx9000|on rf-domain [<RF-DOMAIN-NAME>|all]]

device-upgrade load-image [ap505|ap510|ap560|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|ap505|ap510|ap560|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|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, 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|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 [ap505|ap510|ap560|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, AP560, AP560, 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|ap505|ap510|ap560|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, AP560, 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#
Published July 2019prev | next

Email this topicEmail this topic

Print this pagePrint this page