CISCO Network Function Virtualization Infrastructure Software User Guide

Upgrade Cisco NFVIS

Network Function Virtualization Infrastructure Software

The Cisco NFVIS enabled hardware comes preinstalled with Cisco NFVIS version. Follow the steps below to upgrade it to the latest version of the release.
The Cisco Enterprise NFVIS upgrade image is available as a .iso and .nfvispkg file. Currently, downgrade is not supported. All RPM packages in the Cisco Enterprise NFVIS upgrade image are signed to ensure cryptographic integrity and authenticity. In addition, all RPM packages are verified during Cisco Enterprise NFVIS upgrade.
Ensure that you copy the image to the Cisco NFVIS server before starting the upgrade process. Always specify the exact path of the image when registering the image. Use the scp command to copy the upgrade image from a remote server to your Cisco Enterprise NFVIS server. When using the scp command, you must copy the image to the “/data/intdatastore/uploads” folder on the Cisco Enterprise NFVIS server.
Note

• In Cisco NFVIS release 4.2.1 and earlier releases, you can upgrade Cisco NFVIS from one release to the very next release using the .nfvispkg file. For example, you can upgrade your NFVIS from Cisco NFVIS release 3.5.2 to Cisco NFVIS release 3.6.1.
• Starting from Cisco NFVIS release 4.4.1, you can upgrade NFVIS using .iso file.
• To know if a downloaded file is safe to install, it is essential to compare the file’s checksum before using it. Verifying the checksum helps ensure that the file was not corrupted during network transmission, or modified by a malicious third party before you downloaded it. For more information see, Virtual Machine Security.

Upgrade Matrix for Upgrading Cisco NFVIS

Note

• Use the following table to upgrade from your current version of Cisco NFVIS software to the latest supported upgrade versions only. If you upgrade to an unsupported version, the system might crash.
• Upgrading using .iso file is recommended if the supported upgrade image type is both .iso and .nfvispkg.

Table 1: Upgrade Matrix for Upgrading Cisco NFVIS from Cisco NFVIS Release 4.6.1 and later

4.10.1
4.9.3| 4.10.1| iso
4.9.4
4.11.1
4.9.2| 4.11.1| iso
4.10.1
4.9.4
4.9.3
4.9.1| 4.11.1| iso
4.10.1
4.9.4
4.9.3
4.9.2
4.8.1| 4.9.4| iso
4.9.3
4.9.2
4.9.1
4.7.1| 4.9.4| iso
4.9.3
4.9.2
4.9.1
4.8.1| iso, nfvispkg
4.6.3| 4.9.4| iso
4.9.3
4.9.2
4.9.1
4.8.1
4.7.1| nfvispkg
4.6.2| 4.9.1 or 4.9.2 or 4.9.3 or 4.9.4| iso
4.8.1
4.7.1
4.6.3
4.6.1| 4.9.1 or 4.9.2 or 4.9.3 or 4.9.4| iso
4.8.1
4.7.1| iso, nfvispkg
4.6.3| iso
4.6.2

Table 2: Upgrade Matrix for Upgrading Cisco NFVIS from Cisco NFVIS Release 4.5.1 and earlier

Running Version| Supported Upgrade Version| Supported Upgrade Image Type(s)
---|---|---
4.5.1| 4.7.1| iso, nfvispkg
4.6.3| iso
4.6.2| iso, nfvispkg
4.6.1| iso, nfvispkg
4.4.2| 4.6.3| iso
4.6.2| iso
4.6.1| iso
4.5.1| iso, nfvispkg
4.4.1| 4.6.3| iso
4.6.2| iso
4.6.1| iso
4.5.1| iso, nfvispkg
4.4.2| iso, nfvispkg
4.2.1| 4.4.2| nfvispkg
4.4.1| nfvispkg
4.1.2| 4.2.1| nfvispkg
4.1.1| 4.2.1| nfvispkg
4.1.2| nfvispkg
3.12.3| 4.1.1| nfvispkg
3.11.3| 3.12.3| nfvispkg
3.10.3| 3.11.3| nfvispkg
3.9.2| 3.10.3| nfvispkg
3.8.1| 3.9.2| nfvispkg

Restrictions for Cisco NFVIS ISO File Upgrade

• Cisco NFVIS supports .iso upgrade only from version N to versions N+1, N+2 and N+3 starting from Cisco NFVIS release 4.6.x (except Cisco NFVIS releases 4.7.x and 4.8.x). NFVIS does not support .iso upgrade from version N to version N+4 and above.
• Image downgrade using .iso file is not supported.

Note
In case of an error while upgrading from version N to N+1 or N+2, Cisco NFVIS rolls back to the image version N.

Upgrade Cisco NFVIS 4.8.1 and Later Using ISO File

The following example shows how to use the scp command to copy the upgrade image:

• To copy the upgrade image, use the scp command from Cisco NFVIS CLI:

nfvis# scp
[email protected]:/NFS/2022-01-23/13/nfvis/iso/Cisco_NFVIS-4.8.0-13-20220123_020232.isointdatastore:Cisco_NFVIS-4.8.0-13-20220123_020232.iso

• To copy the upgrade image, use the scp command from remote linux:

config terminal system settings ip-receive-acl 0.0.0.0/0 service scpd action accept commit scp -P22222 Cisco_NFVIS-4.8.0-13-20220123_020232.iso [email protected]:/data/intdatastore/uploads/Cisco_NFVIS-4.8.0-13-20220123_020232.iso

Alternatively, you can upload the image to the Cisco Enterprise NFVIS server using the System Upgrade option from the Cisco Enterprise NFVIS portal.
Note

When the NFVIS upgrade is in progress, ensure that the system is not powered off. If the system is powered off during the NFVIS upgrade process, the system may become inoperable and you may need to reinstall the system.

The upgrade process comprises of two tasks:

1. Register the image using the system upgrade image-name command.
2. Upgrade the image using the system upgrade apply-image command.

Register an Image

To register an image, use the following command:
config terminal system upgrade image-name Cisco_NFVIS-4.8.0-13-20220123_020232.iso location /data/intdatastore/uploads/Cisco_NFVIS-4.8.0-13-20220123_020232. is commit
Note
You must verify the image registration status before upgrading the image using the system upgrade apply-image command. The package status must be valid for the registered image.

To verify the image registration status, use the following command: nfvis# show system upgrade

Cisco_NFVIS-4.8.0-13-20220123_020232.iso/data/upgrade/register/Cisco_NFVIS-4.8.0-13-20220123_020232.iso 4.8.0-13 Valid 2022-01-24T02:40:29.236057-00:00
nfvis# show system upgrade reg-info

Cisco_NFVIS-4.8.0-13-20220123_020232.iso/data/upgrade/register/Cisco_NFVIS-4.8.0-13-20220123_020232.iso 4.8.0-13 Valid 2022-01-24T02:40:29.236057-00:00

Upgrade the Registered Image

To upgrade the registered image, use the following command:
config terminal system upgrade apply-image Cisco_NFVIS-4.8.0-13-20220123_020232.iso scheduled-time 5 commit
To verify the upgrade status, use the show system upgrade apply-image command in the privileged EXEC mode.
nfvis# show system upgrade

Cisco_NFVIS-4.8.0-13-20220123_020232.iso SCHEDULED – –

Cisco_NFVIS-4.8.0-13-20220123_020232.iso/data/upgrade/register/Cisco_NFVIS-4.8.0-13-20220123_020232.iso 4.8.0-13 Valid 2022-01-24T02:40:29.236057-00:00

Upgrade APIs and Commands

The following table lists the upgrade APIs and commands:

• /api/config/system/upgrade
• /api/config/system/upgrade/image-name
• /api/config/system/upgrade/reg-info
• /api/config/system/upgrade/apply-image| • system upgrade image-name
• system upgrade apply-image
• show system upgrade reg-info
• show system upgrade apply-image

Upgrade Cisco NFVIS 4.7.1 and Earlier Using a .nvfispkg File

The following example shows how to use the scp command to copy the upgrade image: scp command from NFVIS CLI:
nfvis# scp [email protected]:/NFS/Cisco_NFVIS_BRANCH_Upgrade-351.nfvispkg intdatastore:Cisco_NFVIS_BRANCH_Upgrade-351.nfvispkg

scp command from remote linux: config terminal system settings ip-receive-acl 0.0.0.0/0 service scpd action accept commit
scp -P 22222 nfvis-351.nfvispkg [email protected]:/data/intdatastore/uploads/nfvis-351.nfvispkg
Alternatively, you can upload the image to the Cisco Enterprise NFVIS server using the System Upgrade option from the Cisco Enterprise NFVIS portal.

Note
When the NFVIS upgrade is in progress, ensure that the system is not powered off. If the system is powered off during the NFVIS upgrade process, the system may become inoperable and you may need to reinstall the system.
The upgrade process comprises two tasks:

• Registering the image using the system upgrade image-name command.
• Upgrading the image using the system upgrade apply-image command.

Register an Image
To register an image: config terminal
system upgrade image-name nfvis-351.nfvispkg location /data/intdatastore/uploads/<filename.nfvispkg>commit

Note
You must verify the image registration status before upgrading the image using the system upgrade apply-image command. The package status must be valid for the registered image.

Verify the Image Registration
Use the show system upgrade reg-info command in the privileged EXEC mode to verify the image registration.
nfvis# show system upgrade reg-info

PACKAGE

NAME| LOCATION| VERSION| STATUS UPLOAD DATE

nfvis-351.nfvispkg/data/upgrade/register/nfvis-351.nfvispkg 3.6.1-722 Valid 2017-04-25T10:29:58.052347-00:00

Upgrade the Registered Image
To upgrade the registered image: config terminal system upgrade apply-image nfvis-351.nfvispkg scheduled-time 5 commit
Verify the Upgrade Status
Use the show system upgrade apply-image command in the privileged EXEC mode
nfvis# show system upgrade apply-image

UPGRADE

NAME| STATUS| FROM| UPGRADE TO

nfvis-351.nfvispkg SUCCESS 3.5.0 3.5.1
The only upgrade supported when BIOS secured boot (UEFI mode) is enabled on ENCS 5400 platform is:
NFVIS 3.8.1 + BIOS 2.5(legacy) –> NFVIS 3.9.1 + BIOS 2.6(legacy)
The following upgrade requires re-installation of NFVIS in UEFI mode:
NFVIS 3.8.1 + BIOS 2.5(legacy) –> NFVIS 3.9.1 + BIOS 2.6(UEFI)
NFVIS 3.9.1 + BIOS 2.6(legacy) –> NFVIS 3.9.1 + BIOS 2.6(UEFI)

Upgrade APIs and Commands
The following table lists the upgrade APIs and commands:

• /api/config/system/upgrade
• /api/config/system/upgrade/image-name
• /api/config/system/upgrade/reg-info
• /api/config/system/upgrade/apply-image| • system upgrade image-name
• system upgrade apply-image
• show system upgrade reg-info
• show system upgrade apply-image

Firmware Upgrade

Note
Firmware upgrade is supported only on ENCS 5400 series devices.
This feature was introduced in NFVIS 3.8.1 release as part of NFVIS auto- upgrade and it supports upgrade of selected firmwares on ENCS 5400 series devices. Firmware upgrade is triggered during NFVIS upgrade as part of the post reboot phase. To trigger the firmware upgrade refer to the NFVIS upgrade feature.
Starting from NFVIS 3.9.1 release, an on demand upgrade is supported which provides a separate firmware package (.fwpkg extension) to be registered and applied through NFVIS CLI. You can also upgrade to the latest firmware through a fresh installation of NFVIS.
The following firmwares can be upgraded:

• Cisco Integrated Management Controller (CIMC)
• BIOS
• Intel 710
• FPGA

Starting from NFVIS 3.12.3 release, the firmware upgrade script is changed from executable to module format.
The code is modularized and each firmware can be individually upgraded. The shell commands are called with subprocess instead of os.system() calls. Each firmware upgrade call is monitored with a time limit. If the call is stuck, the process is killed and execution control will return back to the code flow with appropriate message.
The following table shows the sequence of firmware upgrade:

Intel 710
1. NFVIS upgrade
2. Reboot
3. Login
4. Firmware upgrade 710
5. NFVIS power cycle
6. Login| 1. Install
2. Reboot
3. Login
4. Firmware upgrade 710
5. NFVIS power cycle
6. Login| 1. Firmware upgrade 710
2. NFVIS power cycle
3. Login
Intel 710 and BIOS
1. NFVIS upgrade
2. Reboot
3. Login
4. Firmware upgrade 710 and BIOS
5. NFVIS power off/on due to BIOS
6. Login| 1. Install
2. Reboot
3. Login
4. Firmware upgrade 710 and BIOS
5. NFVIS power off/on due to BIOS
6. Login| 1. Firmware upgrade 710 and BIOS
2. NFVIS power off/on due to BIOS
3. Login
Intel 710 and CIMC
1. NFVIS upgrade
2. Reboot
3. Login
4. Firmware upgrade 710 and CIMC
5. CIMC reboot
6. NFVIS power cycle due to 710
7. Login| 1. Install
2. Reboot
3. Login
4. Firmware upgrade 710 and CIMC
5. CIMC reboot
6. NFVIS power cycle due to 710
7. Login| 1. Firmware upgrade 710 and CIMC
2. CIMC reboot
3. NFVIS power cycle due to 710
4. Login
CIMC
1. NFVIS upgrade
2. Reboot
3. Login
4. Firmware upgrade CIMC
5. CIMC reboot
6. Login| 1. Install
2. Reboot
3. Login
4. Firmware upgrade CIMC
5. CIMC reboot
6. Login| 1. Firmware upgrade CIMC
2. CIMC reboot
3. Login
CIMC and BIOS
1. NFVIS upgrade
2. Reboot
3. Login
4. Firmware upgrade CIMC and BIOS
5. NFVIS power off
6. CIMC reboot
7. BIOS flash
8. NFVIS power on
9. Login| 1. Install
2. Reboot
3. Login
4. Firmware upgrade CIMC and BIOS
5. NFVIS power off
6. CIMC reboot
7. BIOS flash
8. NFVIS power on
9. Login| 1. Firmware upgrade CIMC and BIOS
2. NFVIS power off
3. CIMC reboot
4. BIOS flash
5. NFVIS power on
6. Login
BIOS
1. NFVIS upgrade
2. Reboot
3. Login
4. Firmware upgrade BIOS
5. NFVIS power off
6. BIOS flash
7. NFVIS power on
8. Login| 1. Install
2. Reboot
3. Login
4. Firmware upgrade BIOS
5. NFVIS power off
6. BIOS flash
7. NFVIS power on
8. Login| 1. Firmware upgrade BIOS
2. NFVIS power off
3. BIOS flash
4. NFVIS power on
5. Login
Intel 710, CIMC and BIOS
1. NFVIS upgrade
2. Reboot
3. Login
4. Firmware upgrade 710, CIMC and BIOS
5. NFVIS power off
6. CIMC reboot
7. BIOS flash
8. NFVIS power on
9. Login| 1. Install
2. Reboot
3. Login
4. Firmware upgrade 710, CIMC and BIOS
5. NFVIS power off
6. CIMC reboot
7. BIOS flash
8. NFVIS power on
9. Login| 1. Firmware upgrade 710, CIMC and BIOS
2. NFVIS power off
3. CIMC reboot
4. BIOS flash
5. NFVIS power on
6. Login

References

• Cisco Enterprise Network Function Virtualization Infrastructure Software Configuration Guide, Release 4.x - Security Considerations [Cisco Enterprise NFV Infrastructure Software] - Cisco

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>