Upgrading the Netvisor ONE Software

---

Software upgrades are a routine maintenance procedure that must be completed every so often.  However, there are some variables to consider before you start the upgrade procedures.  

Before you start the upgrade process, obtain the required upgrade software.  You can download the software manually and copy it to a switch before beginning the upgrade procedures.

Software and fabric upgrades are comprised of two distinct phases: the installation (upgrade) of the new software and a switch reboot to activate the new software

To start a software upgrade:

• View the current version of Netvisor ONE on the switch by using command:

CLI network-admin@switch > software-show

version: 5.1.1-5010115300

• Identify the software package. Depending on the version of Netvisor ONE running on your switch, you should use appropriate software upgrade package.

Select the appropriate upgrade bundle based from the following upgrade matrix table:

• Copy the upgrade package to the switch:

1. Enable Secure File Transfare Protocol (SFTP) on the switch:

CLI (network-admin@switch1)>admin-sftp-modify enable

sftp password:

confirm sftp password:

CLI (network-admin@switch1)>

2. Upload the Software package to the switch:

root@server-os-9:~/# sftp sftp@switch1

The authenticity of host 'switch1 (10.0.0.02)' can't be established.

RSA key fingerprint is SHA256:SI8VQZgJCppbrF4sRcby36Fx7rz3Hh5EJllPPyScLZU.

Are you sure you want to continue connecting (yes/no)? yes

Warning: Permanently added 'switch1, 10.0.0.02 (RSA) to the list of known hosts.

* Welcome to Pluribus Networks Inc. Netvisor(R). This is a monitored system. *

* ACCESS RESTRICTED TO AUTHORIZED USERS ONLY *

* By using the Netvisor(R) CLI,you agree to the terms of the Pluribus Networks *

* End User License Agreement (EULA). The EULA can be accessed via *

* http://www.pluribusnetworks.com/eula or by using the command "eula-show" *

Password:

Connected to switch1

sftp> cd import

sftp> put nvOS-5.2.1-5020115690-onvl.pkg

Uploading nvOS-5.2.1-5020115690-onvl.pkg

nvOS-5.2.1-5020115690-onvl.pkg

nvOS-5.2.1-5020115690-onvl.pkg 100% 1870MB 7.5MB/s 04:00

• Start the upgrade process by using the software-upgrade command with package parameter, which allows you to specify the name of the upgrade file. Nevisor does not support fabric upgrade for Netvisor 5.1.1. Each switch in fabric must be upgraded individually.

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

Scheduled background update. Use software-upgrade-status-show to check. Switch will

reboot itself. DO NOT reboot manually.

---

Caution: Do not reboot or power off any switch during the upgrade procedure.  When software upgrade is complete, switch reboots automatically.

---

• Monitor the upgrade process using the software-upgrade-status-show command:

CLI (network-admin@Leaf1)>software-upgrade-status-show show-interval5

[Jun04.21:30:41] Starting software upgrade ...

[Jun04.21:30:42] Cleaning old package bundles

[Jun04.21:30:42] Checking available disk space...

[Jun04.21:30:42] Avbl free space: 12.69G, Required: 0.62G

[Jun04.21:30:42] Unpacking local package bundle...

[Jun04.21:30:42] Extracting initial bundle.

.

.

.

log

--------------------------------------------------------------------

[Jun04.21:30:41] Starting software upgrade ...

[Jun04.21:30:42] Cleaning old package bundles

[Jun04.21:30:42] Checking available disk space...

[Jun04.21:30:42] Avbl free space: 12.69G, Required: 0.62G

[Jun04.21:30:42] Unpacking local package bundle...

[Jun04.21:30:42] Extracting initial bundle.

[Jun04.21:30:50] Decrypting signed bundle.

[Jun04.21:30:52] Extracting signed bundle.

[Jun04.21:31:00] Extracting packages.

[Jun04.21:31:09] Fetching repository metadata.

[Jun04.21:31:09] Skipping dpkg update in current boot image

[Jun04.21:31:11] Computing package update requirements.

[Jun04.21:31:12] Upgrade agent version: 5.1.1-5010115300

[Jun04.21:31:12] Upgrading software upgrade framework

[Jun04.21:31:16] Fetching repository metadata.

[Jun04.21:31:17] Skipping dpkg update in current boot image

[Jun04.21:31:17] Computing package update requirements.

[Jun04.21:31:17] Upgrade agent version: 5.1.2-5010215459

[Jun04.21:31:17] Upgrading nvOS 5.1.1-5010115300 -> 5.2.1-5020115690

[Jun04.21:32:28] Cleaning up old BEs.

[Jun04.21:32:30] Upgrading nvOS 5.1.1-5010115300 -> 5.2.1-5020115690

[Jun04.21:32:30] Software upgrade completed. Rebooting.

After the switch reboots twice and you see following message in serial console of the switch, you can SSH

to switch as the network-admin:

nvOS system info:

serial number: 1XXXXXXX00059

hostid: 090XXX9d

device id:

[ OK ] Started NetVisor Operating System.

Starting nvOSd Monitor...

[ OK ] Started nvOSd Monitor.

[ OK ] Reached target Multi-User System.

[ OK ] Reached target Graphical Interface.

[ OK ] Started Stop ureadahead data collection 45s after completed startup.

Starting Update UTMP about System Runlevel Changes...

[ OK ] Started Update UTMP about System Runlevel Changes.

* Welcome to Pluribus Networks Inc. Netvisor(R). This is a monitored system. *

* ACCESS RESTRICTED TO AUTHORIZED USERS ONLY *

* By using the Netvisor(R) CLI,you agree to the terms of the Pluribus Networks *

* End User License Agreement (EULA). The EULA can be accessed via *

* http://www.pluribusnetworks.com/eula or by using the command "eula-show" *

switch1 login: network-admin

Password:

Netvisor OS Command Line Interface 5.1

Connected to Switch switch1; nvOS Identifier:0x90XXXX9; Ver: 5.2.1-5020115690

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

version: 5.2.1-5020115690