Managing Snapshots

A snapshot of the installed TPVM instance can be taken manually or during the upgrade process. A snapshot of the TPVM's Root File System is taken and stored locally on the SLX device. Only one snapshot can be stored locally at any point of time.

A snapshot is taken automatically when the upgrade command is executed. If, for any reason, the upgrade fails, this snapshot can be used to revert the TPVM to its previous working state.

Example

This example shows the steps to stop a running TPVM instance and then take a snapshot of it. You can then use this snapshot to restore your TPVM in case of failure.

You can use one of the following commands to stop and take a snapshot of your TPVM instance.

Keep the following in mind when taking a snapshot of the TPVM instance.

  1. To preserve the state of your TPVM, it is recommended that you take a snapshot of the instance after every configuration change. This will ensure that, should you need to restore from your snapshot, your snapshot is a version of the running TPVM.

  2. The snapshot does not include additional disks configured for use with the TPVM. Only the root file system of the TPVM is backed up. Ensure that you take a backup of your disks manually to preserve the information stored on them.

  3. The tpvm stop commands stops a running TPVM. You must manually restart the TPVM when required.

  4. Only one snapshot is stored on the SLX device at any point of time.

Example

This example shows the use of the snapshot keyword of the upgrade command to take a snapshot of a running TPVM instance before the TPVM is upgraded. The upgrade process will take a snapshot of the running TPVM instance and then use this snapshot in case the upgrade process fails for any reason.

SLX#  tpvm upgrade protocol scp host 10.31.2.101 directory /folder/to/debian  
                filename tpvm-4.2.5-1.amd64.deb  user mylogin password mypasswd  
                snapshot

Example

Use the show tpvm snapshot command to view the current TPVM snapshot information.

SLX# show tpvm snapshot
                
Sample output:
Domain name: TPVM
Domain version: 4.2.4
Snapshot time: Mon Jun 21 19:50:58 GMT 2021
Snapshot size: 4.4G

Example

This examples shows how to delete a snapshot saved on the SLX device.

SLX# tpvm snapshot delete

Example

This example describes the process of reverting your TPVM instance from an existing snapshot.

SLX# tpvm snapshot revert
Note

Note

The TPVM snapshot revet action is similar to the reboot operation. If a TPVM is installed and running, it is stopped and uninstalled. The TPVM is reinstalled from the snapshot and is then re-started. When the new TPVM instance starts, it loads the configuration stored in its root file system. Configurations persisted in the SLX-OS running configuration is not applied.

It is recommended that, if TPVM revert is planned, the configuration for your existing TPVM not be changed before the TPVM is reverted.