The installed instance of TPVM can be upgraded fully or incrementally when upgrading/downgrading TPVM. When upgrading/downgrading TPVM, it was required that TPVM be re-installed completely and its configuration was later restored from configuration persisted during the upgrade process. The general full upgrade process was to download the TPVM file to the SLX device. Once the download is successful, the existing TPVM instance was stopped and a snapshot taken. Post this, the TPVM was uninstalled. The new version of TPVM was then installed and its configuration restored from stored configuration.
From SLXOS version 20.4.1 onwards, support for incremental upgrade is available. When incrementally upgrading TPVM, the TPVM image is downloaded, along with the OS packages, updated scripts, and XML files. The existing TPVM installation is stopped, and the OS packages are updated first, followed by replacement of existing scripts and XML files. The last upgrade step is to upgrade the TPVM itself.
Note
The default installation mode for SLXOS version 20.4.1 is full upgrade. You must explicitly use the incremental keyword with the tpvm upgrade command to perform incremental upgrade. All SLXOS versions before 20.4.1 supported full install only.
Snapshot of the TPVM instance is not taken when performing incremental update.
A minimum of 1Gb space must be available for TPVM upgrade.
The existing installation of TPVM must be running for incremental upgrade to work.
The minimum required TPVM version is 4.5.0 and the minimum SLXOS version is 20.4.1. If these constraints are not met, you must perform full installation of TPVM.
When TPVM upgrade fails, the following actions are performed to restore the previous installation:
The old Scripts and XML files are restored from backup.
The TPVM instance is restored from the snapshot (if available and only for full installations). For incremental upgrade, the updated OS files are replaced with the older copies.
Log entries are created with the failure reasons.
This example shows the command to perform an incremental upgrade of TPVM.
SLX# tpvm upgrade incremental directory /proj/tpvm_upgrade/ filename tpvm_inc_upg-4.5.0-0.amd64.deb host 10.10.10.1 user fav password testpassword protocol scp use-vrf mgmt-vrf
This example shows the command to perform a full installation of TPVM.
SLX# tpvm upgrade directory /proj/tpvm_upgrade/ filename tpvm-4.5.0-0.amd64.deb host 10.10.10.1 user fav password testpassword protocol scp use-vrf mgmt-vrf