Snapshots

Definition
A Snapshot is a single TrilioVault backup of a workload including all data and metadata. It contains the information of all VM's that are protected by the workload.
List of Snapshots
Using Horizon
1.Login to Horizon
2.Navigate to the Backups
3.Navigate to Workloads
4.Identify the workload to show the details on
5.Click the workload name to enter the Workload overview
6.Navigate to the Snapshots tab
The List of Snapshots for the chosen Workload contains the following additional information:
Creation Time
Name of the Snapshot
Description of the Snapshot
Total amount of Restores from this Snapshot
Total amount of succeeded Restores
Total amount of failed Restores
Snapshot Type
Snapshot Size
Snapshot Status
Using CLI
 workloadmgr snapshot-list [--workload_id <workload_id>]
                           [--tvault_node <host>]
                           [--date_from <date_from>]
                           [--date_to <date_to>]
                           [--all {True,False}]
--workload_id <workload_id> ➡
 Filter results by workload_id 
--tvault_node <host> ➡
 List all the snapshot operations scheduled on a tvault node(Default=None) 
--date_from <date_from>➡
 From date in format 'YYYY-MM-DDTHH:MM:SS' eg 2016-10-10T00:00:00, If don't specify time then it takes 00:00 by default 
--date_to <date_to>➡
To date in format 'YYYY-MM-DDTHH:MM:SS'(defult is current day), Specify HH:MM:SS to get snapshots within same day inclusive/exclusive results for date_from and date_to 
--all {True,False} ➡
 List all snapshots of all the projects(valid for admin user only)
Creating a Snapshot
Snapshots are automatically created by the TrilioVault scheduler.
If necessary or in case of deactivated scheduler is it possible to create a Snapshot on demand.
Using Horizon
There are 2 possibilities to create a snapshot on demand.
Possibility 1: From the Workloads overview
1.Login to Horizon
2.Navigate to Backups
3.Navigate to Workloads
4.Identify the workload that shall create a Snapshot
5.Click "Create Snapshot"
6.Provide a name and description for the Snapshot
7.Decide between Full and Incremental Snapshot
8.Click "Create"
Possibility 2: From the Workload Snapshot list
1.Login to Horizon
2.Navigate to Backups
3.Navigate to Workloads
4.Identify the workload that shall create a Snapshot
5.Click the workload name to enter the Workload overview
6.Navigate to the Snapshots tab
7.Click "Create Snapshot"
8.Provide a name and description for the Snapshot
9.Decide between Full and Incremental Snapshot
10.Click "Create"
Using CLI
workloadmgr workload-snapshot [--full] [--display-name <display-name>]
                              [--display-description <display-description>]
                              <workload_id>
<workload_id>➡
ID of the workload to snapshot.
--full➡
 Specify if a full snapshot is required. 
--display-name <display-name>➡
Optional snapshot name. (Default=None) 
--display-description <display-description>➡
Optional snapshot description. (Default=None)
Snapshot overview
Each Snapshot contains a lot of information about the backup. These information can be seen in the Snapshot overview.
Using Horizon
To reach the Snapshot Overview follow these steps:
1.Login to Horizon
2.Navigate to Backups
3.Navigate to Workloads
4.Identify the workload that contains the Snapshot to show
5.Click the workload name to enter the Workload overview
6.Navigate to the Snapshots tab
7.Identify the searched Snapshot in the Snapshot list
8.Click the Snapshot Name
Details Tab
The Snapshot Details Tab shows the most important information about the Snapshot.
Snapshot Name / Description
Snapshot Type
Time Taken
Size
Which VMs are part of the Snapshot
for each VM in the Snapshot
Instance Info - Name & Status
Security Group(s) - Name & Type
Flavor - vCPUs, Disk & RAM
Networks - IP, Networkname & Mac Address
Attached Volumes - Name, Type, size (GB), Mount Point & Restore Size
Misc - Original ID of the VM
Restores Tab
The Snapshot Restores Tab shows the list of Restores that have been started from the chosen Snapshot.
It is possible to start Restores from here.
Please refer to the Restores User Guide to learn more about Restores.
Misc. Tab
The Snapshot Miscellaneous Tab provides the remaining metadata information about the Snapshot.
Creation Time
Last Update time
Snapshot ID
Workload ID of the Workload containing the Snapshot
Using CLI
workloadmgr snapshot-show [--output <output>] <snapshot_id>
<snapshot_id>➡
ID of the snapshot to be shown
--output <output>➡
Option to get additional snapshot details, Specify --output metadata for snapshot metadata, Specify --output networks for snapshot vms networks, Specify --output disks for snapshot vms disks
Delete Snapshots
Once a Snapshot is no longer needed, it can be safely deleted from a Workload.
The retention policy will automatically delete the oldest Snapshots according to the configure policy.
You have to delete all Snapshots to be able to delete a Workload.
Deleting a TrilioVault Snapshot will not delete any Openstack Cinder Snapshots. Those need to be deleted separately if desired.
Using Horizon
There are 2 possibilities to delete a Snapshot.
Possibility 1: Single Snapshot deletion through the submenu
To delete a single Snapshot through the submenu follow these steps:
1.Login to Horizon
2.Navigate to Backups
3.Navigate to Workloads
4.Identify the workload that contains the Snapshot to delete
5.Click the workload name to enter the Workload overview
6.Navigate to the Snapshots tab
7.Identify the searched Snapshot in the Snapshot list
8.Click the small arrow in the line of the Snapshot next to "One Click Restore" to open the submenu
9.Click "Delete Snapshot"
10.Confirm by clicking "Delete"
Possibility 2: Multiple Snapshot deletion through checkbox in Snapshot overview
To delete one or more Snapshots through the Snapshot overview do the following:
1.Login to Horizon
2.Navigate to Backups
3.Navigate to Workloads
4.Identify the workload that contains the Snapshot to show
5.Click the workload name to enter the Workload overview
6.Navigate to the Snapshots tab
7.Identify the searched Snapshots in the Snapshot list
8.Check the checkbox for each Snapshot that shall be deleted
9.Click "Delete Snapshots"
10.Confirm by clicking "Delete"
Using CLI
workloadmgr snapshot-delete <snapshot_id>
<snapshot_id>➡
ID of the snapshot to be deleted
Snapshot Cancel
Ongoing Snapshots can be canceled.
Canceled Snapshots will be treated like errored Snapshots
Using Horizon
1.Login to Horizon
2.Navigate to Backups
3.Navigate to Workloads
4.Identify the workload that contains the Snapshot to cancel
5.Click the workload name to enter the Workload overview
6.Navigate to the Snapshots tab
7.Identify the searched Snapshot in the Snapshot list
8.Click "Cancel" on the same line as the identified Snapshot
9.Confirm by clicking "Cancel"
Using CLI
workloadmgr snapshot-cancel <snapshot_id>
<snapshot_id>➡
ID of the snapshot to be canceled