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 one of 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: AP310, AP360, AP410, AP460, AP505, AP510, AP560, AP7522, AP7532, AP7562, AP7612, AP7632, AP7662, 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

nx9500-6C8809#upgrade ftp://symbol:symbol@134.141.244.21/NX9500-7.3.0.0-002D.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 7.3.0.0-002D
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/21/2019 02:32:33     09/23/2019 10:01:59     7.3.0.0-002D
  Secondary     09/17/2019 16:46:20     09/20/2019 13:06:48     7.3.0.0-001D
--------------------------------------------------------------------------------
Current Boot       : Secondary
Next Boot          : Primary
Software Fallback  : Enabled
VM support         : Not present
nx9500-6C8809#
Note

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
Save current configuration? ([y]es/[n]o/[d]isplay unsaved/[c]ancel reload): y
[OK]
nx9500-6C8809#

nx9500-6C8809#show boot
--------------------------------------------------------------------------------
     IMAGE            BUILD DATE             INSTALL DATE          VERSION
--------------------------------------------------------------------------------
  Primary       09/21/2019 02:32:33     09/23/2019 10:01:59     7.3.0.0-002D
  Secondary     09/17/2019 16:46:20     09/20/2019 13:06:48     7.3.0.0-001D
--------------------------------------------------------------------------------
Current Boot       : Primary
Next Boot          : Primary
Software Fallback  : Enabled
VM support         : Not present
nx9500-6C8809#

The following example shows the upgrade status:

nx9500-6C8809#show upgrade-status detail
Last Image Upgrade Status : Successful
Last Image Upgrade Time   : 2019-09-23 10:01:59
-----------------------------------------------
Running from partition /dev/sda8
var2 is 0 percent full
/tmp is 3 percent full
Free Memory 34890996 kB
FWU invoked via Linux shell
Validating image file header
Removing other partition
Fri Sep 20 13:14:01 UTC 2019
debug: cmdline -C /boot/lilo.conf -R 7.3.0.0-001D -P fix
LILO version 22.6-CCB, Copyright (C) 1992-1998 Werner Almesberger
Development beyond version 21 Copyright (C) 1999-2004 John Coffman
Released 02-Sep-2004, and compiled at TIME on DATE

Mon Sep 23 09:59:29 UTC 2019
debug: cmdline -C /boot/lilo.conf -P fix
LILO version 22.6-CCB, Copyright (C) 1992-1998 Werner Almesberger
Development beyond version 21 Copyright (C) 1999-2004 John Coffman
Released 02-Sep-2004, and compiled at TIME on DATE

Reading boot sector from /dev/sda
--More--
nx9500-6C8809#

nx9500-6C8809#show adoption status
-------------------------------------------------------------------------------------------------------------
DEVICE-NAME    VERSION        CFG-STAT      MSGS  ADOPTED-BY   LAST-ADOPTION     UPTIME        IPv4-ADDRESS
-------------------------------------------------------------------------------------------------------------
ap505-134038 7.3.0.0-001D  version-mismatch No nx9500-6C8809  0 days 00:34:44 2 days 21:18:03  10.234.160.36
-------------------------------------------------------------------------------------------------------------
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 adoption status
---------------------------------------------------------------------------------------------------------
DEVICE-NAME   VERSION      CFG-STAT  MSGS  ADOPTED-BY    LAST-ADOPTION      UPTIME         IPv4-ADDRESS
---------------------------------------------------------------------------------------------------------
ap505-134038 7.3.0.0-002D configured  No  nx9500-6C8809  0 days 00:00:28  0 days 00:02:02  10.234.160.36
---------------------------------------------------------------------------------------------------------
Total number of devices displayed: 4
nx9500-6C8809#

Related Commands

no Removes a patch installed on a specified device
9036514-01 Rev AA