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
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.