upgrade

Upgrades a device's software image

Supported in the following platforms:

  • Access Points — AP505i, AP510i/e, AP560i/h
  • Service Platforms — NX5500, NX7500, NX9500, NX9600, 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 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: AP505, AP510, AP560, 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.24/NX9500-7.2.0.0-006D.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.2.0.0-006D
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       06/21/2019 04:10:19     06/25/2019 14:01:30     7.2.0.0-006D
  Secondary     05/25/2019 07:14:53     06/03/2019 14:11:03     5.9.5.0-004D
--------------------------------------------------------------------------------
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
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-06-25 14:01:30
-----------------------------------------------
Running from partition /dev/sda8
var2 is 0 percent full
/tmp is 3 percent full
Free Memory 34871840 kB
FWU invoked via Linux shell
Validating image file header
Removing other partition
Mon Jun  3 14:27:05 UTC 2019
debug: cmdline -C /boot/lilo.conf -R 5.9.5.0-004D -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

Tue Jun 18 14:45:09 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.1.2.0-013R version-mismatch No  nx9500-6C8809 0 days 00:07:33 26 days 02:13:49  10.234.160.36
--------------------------------------------------------------------------------------------------------------
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#

Related Commands

no Removes a patch installed on a specified device