tpvm upgrade

Upgrades the TPVM image. This command downloads the TPVM debian image file vide SCP, SFTPand FTP servers, and may upgrade any previously installed TPVM instance, and then applies the TPVM configuration from the SLX configuration database, if available.

Syntax

tpvm upgrade protocol [ SCP | SFTP | FTP ] user username password password host hostname directory dirname file filename snapshot uselocalfile snapshot tpvm <tpvm-instance-name>

Parameters

upgrade
Upgrades the TPVM instance.
protocol [ SCP | SFTP | FTP ]
Specifies the download protocol.
host hostname
Specifies the host name or ipv4 address of the server from where the TPVM image is downloaded.
user username
Specifies the login name for the remote server.
password password
Specifies the password associated with the user name.
directory dirname
Specifies the remote directory that contains the TPVM image.
file filename
The TPVM debian file name.
snapshot
Takes a snapshot of the current TPVM instance if any, before starting the upgrade process.
uselocalfile snapshot tpvm <tpvm-instance-name>
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. The tpvm key value <tpvm-instance-name> will always be TPVM.

Modes

Privileged EXEC mode

tpvm upgrade is an exec CLI.

The new TPVM debian image file is downloaded in the /tftpboot/SWBD2900 directory. If any previous image file was there, it is moved to the /support/OldTpvm directory, if enough space is there.
Note

Note

The snapshot feature may delete this subfolder /support/OldTpvm in order to free space, if required.

During download of the file, if any TPVM is running, it is not disturbed till successful download completion. After that the previously running TPVM (if any) is stopped and uninstalled. If the snapshot parameter is passed in the CLI, then its snapshot is created too. the download may fail due to networking or not enough free space like issues.

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