Modifying and Upgrading Software



A switch can contact an upgrade server, either directly or through a proxy, to download and upgrade to a newer version of Netvisor ONE. You can modify the upgrade process for the switch and add a proxy host.


To complete a software upgrade:


  • Obtain the required upgrade software.  You can download the software manually and copy it to a switch before beginning the upgrade procedures.

Pluribus Networks recommends upgrading the software and fabric using offline packages, that is, download the required software package to your system or copy to a USB flash drive and then use the package offline to upgrade the software and the fabric.

  • Software and fabric upgrades two phases: the installation (upgrade) of the new software and a switch reboot to activate the new software.
  • It is critical to understand the effects of an upgrade before beginning the process.  For example, the reboot behavior after an upgrade can be completed manually or it can be controlled automatically with command options.


Informational Note:This upgrade procedure applies to only one switch. To upgrade switches on the fabric, see Implementing a Fabric Upgrade section.


Software Tracks


Pluribus Networks manages different software releases using software tracks. By default, the software track-release is the standard track, but other tracks, such as Beta or Hotfixes, may be available for download.


1) To view the current version of Netvisor ONE on the switch, use the following command:


CLI network-admin@switch > software-show


version: 5.0.0-5000014538

 

2) If the upgrade status indicates the availability of a newer version of Netvisor ONE, request an update from the server:


CLI (network-admin@Leaf1)>software-upgrade


upgrade successful. rebooting...


Check the status while the switch is upgrading, use the software-upgrade-status-show command.


3) Check the status of the switch after upgrading, reconnect to the switch, and enter the following command:


CLI (network-admin@Leaf1)> software-show


version:              5.1.1-5010115297

track:                5.1-release

upgrade-status:       up-to-date

auto-upgrade:         disable

use-proxy:            no

 


Note: Allow plenty of time for the switch to download and install the new version of software. Do not interrupt the operation while the upgrade is in progress. When the upgrade is complete, the switch reboots and loads the latest version of the software. If you encounter any problems with the new version of the software, a previous version can be selected as the boot software.



Note: Upgrading without an Internet connection - If the switch does not have direct access to the Internet but can use a proxy server, enter the software-modify use-proxy command to configure the proxy and then check for software upgrade availability.  If there is no access to the Internet from the switch, contact Pluribus Technical Support for instructions on upgrading a switch offline.



To upgrade the current Netvisor ONE to a later release, use the software-upgrade command.


CLI (network-admin@Leaf1) > software-upgrade package nvOS-5.1.1-5010115280-onvl.pkg


The parameter package allows you to specify the name of the upgrade file.


Caution: Do not reboot or power off any switch during the upgrade procedure.  The reboot process may be completed automatically or manually as part of the upgrade procedure but do not reboot or power off a switch while the upgrade is in process.


After the upgrade, to view the software version, use the software-show command.


CLI (network-admin@Leaf1)>software-show


version:              5.1.1-5010115297

track:                5.1-release