upgrade

Upgrades a device's software image

Supported in the following platforms:

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: AP7502, AP7522, AP7532, AP7562, AP7602, AP7612, AP7622, AP7632, AP7662, AP8163, AP8432, AP8533, RFS4010, NX5500, NX7500, NX9500, NX9600, VX9000.

      Upgrades all devices of the type specified here. For example, if AP7602 is the device-type specified, all AP7602 within the specified RF Domain are upgraded.

Example

nx9500-6C8809#show boot
--------------------------------------------------------------------------------
     IMAGE            BUILD DATE             INSTALL DATE          VERSION
--------------------------------------------------------------------------------
  Primary       08/12/2019 02:35:38     08/16/2019 15:20:46     5.9.6.0-006D
  Secondary     08/22/2019 00:54:30     08/22/2019 12:37:40     5.9.6.0-011D
--------------------------------------------------------------------------------
Current Boot       : Secondary
Next Boot          : Secondary
Software Fallback  : Enabled
VM support         : Not present
nx9500-6C8809#
nx9500-6C8809#upgrade ftp://symbol:symbol@134.141.219.176/NX9500-5.9.7.0-001D.img
Running from partition /dev/sda8
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.7.0-001D
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       09/12/2019 02:35:38     09/16/2019 15:20:46     5.9.7.0-001D
  Secondary     08/22/2019 00:54:30     08/22/2019 12:37:40     5.9.6.0-011D
--------------------------------------------------------------------------------
Current Boot       : Secondary
Next Boot          : Primary
Software Fallback  : Enabled
VM support         : Not present
nx9500-6C8809#
The following example shows the upgrade status:
ap7532-DF9A4C#show upgrade-status
Last Image Upgrade Status : Successful
Last Image Upgrade Time   : 2019-08-06 13:10:02
ap7532-DF9A4C#

ap7532-DF9A4C#show upgrade-status detail
Last Image Upgrade Status : Successful
Last Image Upgrade Time   : 2019-08-06 13:10:02
-----------------------------------------------
Running from partition /dev/mtdblock6
var2 is 3 percent full
/tmp is 6 percent full
Free Memory 65964 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.6.0-003D
Writing Kernel to /dev/mtd5
Checking if boot sector needs to be upgraded
Boot Sector version 10, image file bootsector ver 10, no change required
Writing BootOS to /dev/mtd3
Successful

ap7532-DF9A4C#
Note

Note

After upgrading, the device has to be reloaded to boot using the new image.
ap7532-DF9A4C#reload
The system will be rebooted, do you want to continue? (y/n): y
ap7532-DF9A4C#

ap7532-DF9A4C#show boot
--------------------------------------------------------------------------------
     IMAGE            BUILD DATE             INSTALL DATE          VERSION
--------------------------------------------------------------------------------
  Primary       05/25/2019 06:43:28     06/03/2019 15:25:22     5.9.5.0-004D
  Secondary     07/31/2019 17:14:41     08/06/2019 13:10:02     5.9.6.0-003D
--------------------------------------------------------------------------------
Current Boot       : Secondary
Next Boot          : Secondary
Software Fallback  : Enabled
ap7532-DF9A4C#

Related Commands

no (priv-exec-mode) Removes a patch installed on a specified device
9036316-02 REV AB