Deploy with TPVM Configuration Persistence

This topic describes the steps to install and start the TPVM using the deploy config command and persist other TPVM configurations in the SLX-OS running-config. These persisted configurations are useful during TPVM upgrade operation. Also, for any SLX switch RMA, the persisted configurations can be used to restore the TPVM to its previous configurations.

This section provides a large number of examples to illustrate the above actions.

TPVM Image Location

The TPVM Debian image file (e.g. tpvm-4.2.5-1.amd64.deb ) can be found in the /tftpboot/SWBD2900 folder of the SLX device. To deploy, install this file.

Note

Note

Only one image file can be stored in the above mentioned location.

Example

This example describes a simple TPVM deploy action with built-in defaults.

SLX # config terminal
SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # deploy
SLX (config-tpvm-TPVM) # end
Note

Note

  • Note that the deploy command will take some time to complete execution. If executed through Netconf/RPC, deploy is non-blocking to the client and will run in the background at the SLX switch. The followingRaslog entries are generated for the various stages of deployment progression.
    • DCMD-1451 - Generated for start
    • DCMD-1452 - Generated for success
    • DCMD-1453 - Generated for fail or abort
  • Default values for various TPVM configurations are:
    • hostname - tpvm
    • timezone - Etc/GMT
    • management - dhcp
    • password for default user account: extreme - password
    • dns - User defined
    • ntp - no setting
    • ldap - no setting
    • trusted-peer - not set

Example

This example shows a TPVM being deployed with a preconfigured password and Management Interface IP address. 

SLX # config terminal
SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # password newpassword
SLX (config-tpvm-TPVM) # interface management ip 10.25.24.21/24
SLX (config-tpvm-TPVM) # deploy

Example

This example shows a TPVM being deployed with a preconfigured password and Management Interface IP address. These configurations are then changed post successful installation of the TPVM. 

SLX # config terminal
SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # password newpassword
SLX (config-tpvm-TPVM) # interface management ip 10.25.24.21/24
SLX (config-tpvm-TPVM) # deploy
SLX (config-tpvm-TPVM) # end
SLX # tpvm stop
SLX # config terminal
SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # password newpasswordagain
SLX (config-tpvm-TPVM) # interface management ip 10.25.24.221/24
SLX (config-tpvm-TPVM) # end
SLX # tpvm start

Example

In this example, a few TPVM configuration values are assigned. Since these configuration steps are performed before the TPVM is installed, these settings will be stored in the running configuration of the SLX device and will be applied to the TPVM instance once the TPVM is installed.

In instances where a TPVM is already running, these configurations will be stored (persisted) in the running configuration only if they are applied successfully. 

SLX # config terminal
SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # password newpassword
SLX (config-tpvm-TPVM) # interface management ip 10.25.24.21/24
SLX (config-tpvm-TPVM) # auto-boot
SLX (config-tpvm-TPVM) # hostname newhostname
SLX (config-tpvm-TPVM) # timezone Europe/Stockholm
SLX (config-tpvm-TPVM) # end

Later, when the TPVM is installed, it is started with the above configuration when the deploy command is executed. 

SLX # config terminal
SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # deploy

Example

This example describes deploying a TPVM with various configuration. Once the TPVM is installed, additional settings are configured to the TPVM instance. 

SLX # config terminal
SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # password newpassword
SLX (config-tpvm-TPVM) # interface management ip 10.25.24.21/24
SLX (config-tpvm-TPVM) # auto-boot
SLX (config-tpvm-TPVM) # hostname newhostname
SLX (config-tpvm-TPVM) # timezone Europe/Stockholm
SLX (config-tpvm-TPVM) # deploy
SLX (config-tpvm-TPVM) # end
SLX # config terminal

SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # hostname oldhostname
SLX (config-tpvm-TPVM) # no timezone

Example

This example describes the steps to configure a pasword for the root account for the TPVM instance. This example uses the password command and passes an encrypted string to it. 

SLX (config-tpvm-TPVM) # password $6$M@T]Ip^<$.kavoRt.uINQo
                ghhcpDYd4elQg3BWWuJDdVSmGtZcM/Ry6IRUYKkKtJ80PgTXKFEVnzWx4oTSPvHPRtvqXtGf/

Example

An installed TPVM can be uninstalled and its configurations retained for the future. This example explains the commands to achieve the above.

SLX # config terminal
SLX (config)# tpvm TPVM
SLX (config-tpvm-TPVM) # no deploy
SLX (config-tpvm-TPVM) # end

Example

An installed TPVM can be purged by using the no format of the tpvm TPVM command. This command stops, uninstals, and purges the stored TPVM configurations in one step. 

SLX # config terminal
SLX (config)# no tpvm TPVM
SLX (config) # end

Example

Persisted configurations can be reset by using the no format of their respective command. This example show the use of the no format of the hostname command to reset the hostname assigned to the TPVM. 

SLX (config-tpvm-TPVM) # no hostname
9036960-01 Rev AA