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