upgrade

Upgrades a device's software image

Supported on the following devices:

Access Points: AP5010, AP310i/e, AP410i/e, 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
Virtual Platforms: CX9000, VX9000

Syntax

upgrade [<FILE>|<URL>|dhcp-vendor-options]

upgrade [<FILE>|<URL>] {background|on <DEVICE-NAME>|on <RF-DOMAIN-NAME>}

upgrade dhcp-vendor-options {<DEVICE-NAME>|on <RF-DOMAIN-NAME>}

upgrade dhcp-vendor-options {<DEVICE-NAME>} {<DEVICE-NAME>}

upgrade dhcp-vendor-options {on <RF-DOMAIN-NAME>} {containing <SUB-STRING>|exclude-controllers|
exclude-rf-domain-managers|filter <DEVICE-TYPE>}

Parameters

upgrade [<FILE>|<URL>] {background|on <DEVICE-NAME>|on <RF-DOMAIN-NAME>}


<FILE>	Specify the target firmware image location in the following format: cf:/path/file usb1:/path/file usb2:/path/file usb<n>:/path/file
<URL>	Specify the target firmware image location. Use 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
background	Optional. Performs upgrade in the background
on <DEVICE-NAME>	Optional. Upgrades the software image on a specified remote device <DEVICE-NAME> – Specify the name of the AP, wireless controller, or service platform.
on <RF-DOMAIN-NAME>	Optional. Upgrades the software image on all devices within a specified RF Domain <RF-DOMAIN-NAME> – Specify the name of the RF Domain.

upgrade dhcp-vendor-options {<DEVICE-NAME>} {<DEVICE-NAME>}


dhcp-vendor-options	Uses DHCP vendor options to upgrade device(s)
<DEVICE-NAME> {<DEVICE-NAME>}	Optional. Uses DHCP vendor options to upgrade a specified device. Specify the name of the AP, wireless controller, or service platform. <DEVICE-NAME> – Optional. You can optionally specify multiple comma-separated device names/MAC addresses to upgrade.

upgrade dhcp-vendor-options {on <RF-DOMAIN-NAME>} {containing <SUB-STRING>|
exclude-controllers|exclude-rf-domain-managers|filter <DEVICE-TYPE>}


dhcp-vendor-options	Uses DHCP vendor options to upgrade device(s)
on <RF-DOMAIN-NAME> {containing <SUB-STRING>\| exclude-controllers\| exclude-rf-domain-managers\| filter <DEVICE-TYPE>}	Optional. Uses DHCP vendor options to upgrade all devices or specified device(s) within the RF Domain identified by the <RF-DOMAIN-NAME> keyword <RF-DOMAIN-NAME> – Specify the RF Domain name. After specifying the RF Domain, optionally use the filters provided to identify specific device(s) within the RF Domain. If none of the filters are used, all devices within the RF Domain are upgraded. These filters are: containing <SUB-STRING> – Optional. Upgrades all devices, within the specified RF Domain, containing a specified sub-string in their hostname <SUB-STRING> – Specify the sub-string to match. exclude-controllers – Optional. Upgrades all devices, within the specified RF Domain, excluding controllers. Since only a NOC controller is capable of adopting other controllers, use this option when executing the command on a NOC controller. exclude-rf-domain-manager – Optional. Upgrades all devices, within the specified RF Domain, excluding RF Domain managers. Use this option when executing the command on the NOC, Site controller, or RF Domain manager. filter <DEVICE-TYPE> – Optional. Executes the command on all devices, within the specified RF Domain, of a specified type <DEVICE-TYPE> – Specify the device type. The options are: AP505, AP510, NX5500, NX7500, NX9500, NX9600, and VX9000. Upgrades all devices of the type specified here. For example, if AP510 is the device-type specified, all AP510 within the specified RF Domain are upgraded.

Example

ap505-13403B#show boot
--------------------------------------------------------------------------------
     IMAGE            BUILD DATE             INSTALL DATE          VERSION
--------------------------------------------------------------------------------
  Primary       02/25/2019 16:41:26     02/26/2019 14:37:21     7.1.0.0-114D
  Secondary     02/19/2019 19:13:49     02/25/2019 21:11:44     7.1.0.0-075D
--------------------------------------------------------------------------------
Current Boot       : Primary
Next Boot          : Primary
Software Fallback  : Enabled
ap505-13403B#

nx9500-6C8809#upgrade ftp://symbol:symbol@10.233.84.206/LatestBuilds/W593/NX9500-5.9.3.0-007D.img
Running from partition /dev/sda7
Validating image file header
Removing other partition
Making file system
Extracting files (this may take some time).................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
Control C disabled
Version of firmware update file is 5.9.3.0-007D
Removing unneeded files from flash:/crashinfo directory
Removing unneeded files from flash:/var2/log directory
Creating LILO files
Running LILO
Successful
nx9500-6C8809#

nx9500-6C8809#show boot
--------------------------------------------------------------------------------
     IMAGE            BUILD DATE             INSTALL DATE          VERSION
--------------------------------------------------------------------------------
  Primary       08/21/2018 12:02:07     08/23/2018 08:15:10     5.9.3.0-006D
  Secondary     08/29/2018 12:23:18     08/30/2018 08:42:16     5.9.3.0-007D
--------------------------------------------------------------------------------
Current Boot       : Primary
Next Boot          : Secondary
Software Fallback  : Enabled
VM support         : Not present
nx9500-6C8809#

Note

After upgrading, the device has to be reloaded to boot using the new image.

nx9500-6C8809#reload
The system will be rebooted, do you want to continue? (y/n): y
nx9500-6C8809#

The following example shows the upgrade status:

ap8432-070235#show upgrade-status
Last Image Upgrade Status : Successful
Last Image Upgrade Time   : 2018-08-30 02:52:33
ap8432-070235#

ap8432-070235#show upgrade-status detail
Last Image Upgrade Status : Successful
Last Image Upgrade Time   : 2018-08-30 02:52:33
-----------------------------------------------
Running from partition /dev/mtdblock6
var2 is 3 percent full
/tmp is 3 percent full
Free Memory 263192 kB
FWU invoked via Linux shell
Validating image file header
Making file system
Extracting files (this may take some time).
Control C disabled
Version of firmware update file is 5.9.3.0-007D
Writing Kernel to /dev/mtd5
Checking if boot sector needs to be upgraded
Upgrading Boot Sector from 0 to 0
Writing BootOS to /dev/mtd3
Successful

ap8432-070235#

Related Commands


no	Removes a patch installed on a specified device