tpvm upgrade

Upgrades the TPVM image. This command downloads the TPVM Debian image file using SCP or SFTP or FTP servers. Any previously installed TPVM instance is upgraded, and TPVM configuration from the SLX configuration database is applied, if available. Upgrades can be full or incremental. By default, full upgrades are performed.

Syntax

tpvm upgrade directory directory-name filename image-filename incremental host hostname password password protocol [ SCP | SFTP | FTP ] snapshot tpvmid tpvm-instance-name use-vrf vrf-name uselocalfile user username

Parameters

directory directory-name
Specifies the remote directory that contains the TPVM image.
file image-filename
The Debian TPVM image file name.
incremental
Use to perform an incremental TPVM upgrade.
host hostname
Specifies the host name or IPv4/IPV6 address of the server from where the TPVM image is to be downloaded.
password password
Specifies the password associated with the user name.
protocol [ SCP | SFTP | FTP ]
Specifies the protocol to be used to download the TPVM image.
snapshot
Takes a snapshot of the current TPVM instance if any, before starting the upgrade process.
tpvmid tpvm-instance-name
The ID of the TPVM that needs to be upgraded. This value is always TPVM and cannot be modified.
use-vrf vrf-name
The VRF that will be used to access the remote server from where TPVM image is to be downloaded.
user username
Specifies the login name for the remote server.
uselocalfile
Indicates that the TPVM upgrade process must use the TPVM Debian file located in the /tftpboot/SWBD2900 directory. Use the snapshot key to indicate that a snapshot must be taken during the upgrade process.

Modes

Normal EXEC mode

Usage Guidelines

tpvm upgrade is an exec CLI.

The new TPVM Debian image file is downloaded to the /tftpboot/SWBD2900 directory. If any previous image file is present, it is moved to the /support/OldTpvm directory, provided enough space is available.

Note

Note

The snapshot feature may delete this subfolder, /support/OldTpvm, to free space disk space when required.

During download of the TPVM image file, if TPVM is running, it is not stopped till the download is complete. On completion, the running TPVM instance (if any) is stopped and then uninstalled. If the snapshot parameter is used while upgrading, then a snapshot of the running TPVM is created.

The download may fail due to networking issues or not having enough free space on the device.

If SLX OS configuration database has TPVM configurations set, specially config deploy, then the upgrade process shall further install the new TPVM Debian image file, start the instance, and also apply other TPVM related persisted configurations from the SLX configuration database.

The default behavior of the tpvm upgrade command is to perform a full upgrade of the TPVM instance. To perform an incremental upgrade, you must use the incremental keyword explicitly. While performing the incremental upgrade, the Ubuntu Packages, TPVM script files, and XML files will be upgraded.

Incremental upgrade fails under the following conditions:

Note

Note

When you downgrade the existing TPVM version to a version that is lower than SLXOS version 20.4.1, then you will have to remove the IPv6 configurations before downgrading. Appropriate warning will be displayed.

Examples

This example shows the command to perform a full upgrade 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

This example shows the command to perform an incremental installation 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

Example

This example upgrades TPVM image.

SLX# tpvm upgrade host ? 
Possible completions: 
    <Hostname or IPv4/IPv6 address> 
    <IP address> <string, min: 1 char, max: 253 chars>
9037402-00 Rev AA