Description

This article describes how to view and manage Snapshots for a Cloud Server and includes those that may have failed.

For more information on Cloud Server Snapshots, see Introduction to Cloud Server Snapshots

For instructions on how to manage Snapshot Replication, see How to Manage Snapshot Replication on a Cloud Server

Prerequisites:

  1. Cloud Server Snapshots must be enabled for the Server
  2. The Data Center cannot be in Snapshot Service Maintenance. See How do I Identify Hardware Specifications and Capabilities Available in a Data Center Location
  3. The user must be either Primary Administrator or have the Server role assigned
  4. You cannot modify the Snapshot Description of a failed or unsuccessful Snapshot.

Prerequisites to switch Snapshot Service Plans:

  1. You cannot set the Snapshot Service Plan to the same plan that it is already assigned. For example, if the Snapshot Service Plan is set to Essentials, you cannot change it to Essentials, as it is already assigned that Service Plan.
  2. You cannot switch from Advanced Snapshot Plan to Essentials Snapshot Plan if Snapshot Replication has been enabled

Prerequisites to Delete a Snapshot:

  1. Must have at least one Manual snapshot
    • You cannot delete system-generated snapshots. 
  2. The snapshot you want to delete must be in a normal state
  3. You cannot delete a Snapshot if the Snapshot is the only completed Snapshot.
  4. You cannot delete a Snapshot if there is a server currently in Snapshot Preview mode that was generated from the manual snapshot
  5. Note that failed Manual Snapshots expire and are automatically purged from the system after their Expiry Time

Content / Solution:

How to View a Snapshot

  1. From the Home page, select the Data Center where the Server you want to view Snapshots from is located:


  2. The Data Center Dashboard will be displayed. Select the Network Domain where the Server you want to view Snapshots from is located:


  3. The Network Domain dashboard will be displayed. Click on the Server for which you want to view Snapshots:

    Note: The  icon indicates that a Server is enabled for Snapshot Replication. For more information on Snapshot Replication, see Introduction to Cloud Server Snapshots 
    Note: Hovering your mouse over the Snapshot Icon in the Services column will display a popup with information about the Snapshot enabled Server:

     

  4. The Server dashboard will be displayed. Click on the Snapshots tab:

    Note: hover your mouse over the  information icon to view more details about the Snapshot Plan

    Note:
     This grid may contain many Snapshots. The system will automatically purge any Snapshot that is expired.

    Note: A green 'Current Action' bar indicates that an action is still in progress.
    If an action has failed, you will see a red exclamation mark  before the Snapshot Icon in the Id column, and the Current Action column will display "FAILED SNAPSHOT".
    Failed Snapshots will be automatically purged from the system after 31 days.

  5.  You will see a grid that lists all the Snapshots currently associated with the Server. The grid has two tabs (Local and Replicated) as well as several columns:

    • Snapshot Plan - Indicates the plan level associated with the Snapshot Service. For more details, see Introduction to Cloud Server Snapshots

    • Snapshot Window - Indicates the time period in which the System snapshots will be taken. For more details, see Introduction to Cloud Server Snapshots
    • Replication - Indicates the location where any Replicated Snapshots are stored. For more details, see Introduction to Cloud Server Snapshots
    • Pre-Snapshot Script - If enabled, Pre-Snapshot Scripts are displayed here
    • Post-Snapshot Script - If enabled, Post-Snapshot Scripts are displayed here
    • Local - Displays all of the Snapshots that are stored in the same Data Center as the Server
    • Replicated - Displays all of the Snapshots that are stored in the Replication Target Data Center
      • Note: It may take several hours for a Snapshot to be replicated to the Target Data Center. 
    • ID - This is the ID of the Snapshot. 
      • Hovering your mouse over the  Snapshot Icon will display the Snapshot ID (with "Copy to Clipboard" button) and the current Status of the Snapshot (Normal, Failed, etc...)
      • Clicking on the Snapshot ID will open a dialog with further information about the Snapshot. See step 6 below.
      • A red exclamation mark  before the Snapshot Icon in the Id column indicates a Failed Snapshot
    • Start Time - Displays the date and time that the Snapshot was initialized:
      • Will not contain a value until the Snapshot process begins.

      • If for some reason a System Snapshot fails then the Start Time displayed will be its weekly scheduled window.

    • Expiry Time - Displays the date and time on which the Snapshot will expire and be purged from the system. 
      • Note: A red exclamation mark  in the Expiry Time column indicates that a Snapshot will expire soon
      • Note: When a Snapshot is created, the Expiry time for all Snapshots (Essentials and Advanced) is set to 31 days from the time it was created. For Advanced plans only, when the system determines which of the daily Snapshots will be kept as a weekly snapshot, the Expiry time for that Advanced Snapshot will change to 365 days from the creation date. See Introduction to Cloud Server Snapshots for more details.
    • Snapshot Description - Displays an optional Description that can be added to the Snapshot
    • Current Action - Displays information regarding the progress of current operations, if any.
      • A green 'Current Action' bar indicates that an action is still in progress. 
      • If the action has failed, you will see a red exclamation mark  before the Snapshot Icon in the Id column, and the Current Action column will display "FAILED SNAPSHOT". 
        • Failed Snapshots will be automatically purged from the system after 31 days.
    • Index - Displays the Index State of the Snapshot. When performing a File/Folder restore from a snapshot, the Index State must be "Valid". See How to Restore a File or Directory from a Cloud Server Snapshot to the Cloud Server
    • Archive Status - Displays whether the Snapshot is available locally, or if it has been moved to Archived storage. For more information on Snapshot Archiving, see Introduction to Cloud Server Snapshots
    • Type - Indicates whether the Snapshot was generated automatically (SYSTEM) or manually (MANUAL)
    • Manage "gear" icon - Contains a drop-down menu with the following actions:
      • Deploy Server from Snapshot (System and Manual)
      • Delete Snapshot (Manual only)
    • You can filter the ID and Snapshot Type columns by clicking on the  filter icon 

      Important Information

      Manual Snapshots can be deleted by the User. System Snapshots cannot be deleted by the user. Failed Snapshots (Manual or System) cannot be deleted by the User.
      Snapshots are automatically purged from the system after they expire (including Failed Snapshots). For more information on Snapshot plans and retention, see Introduction to Cloud Server Snapshots

      Failed Snapshots

      When a Snapshot fails, CloudControl does not have any meaningful information as to why the failure may have occurred, only that the action has failed.

      Manual Snapshots: If a Manual Snapshot fails, the failure will be noted in the Administrator Log, however, CloudControl is not aware of why a Manual Snapshot fails.

      However, one potential reason that a Manual Snapshot can fail is if the following conditions are met:

      1. A Cloud Server is enabled (via API) for Pre/Post vSphere Snapshot Scripts
      2. Error Handling on the Pre-Snapshot Script is set for "abort"

      Error Handling set to "abort" means that if a Pre-Snapshot script fails to execute, the System should not take a Snapshot. In order to change this behavior, you can update the Error Handling parameter to "continue" regardless of whether a Pre-Snapshot script successfully completes or not.

      System Generated Snapshots: CloudControl tracks when System Snapshots are expected to be completed based on the designated daily Snapshot Window. If a System Snapshot does not appear within 12 hours of the scheduled Snapshot Window, CloudControl will assume that the System Snapshot has failed and a FAILED System Snapshot record will appear in the Snapshot dashboard with a Start Time set at the time when the when the System Snapshot was expected to be taken.

      In some cases we have seen that a System Snapshot took more than 12 hours to complete. If this happens the System will show the successful Snapshot but the FAILED Snapshot record will still remain for 31 days until it expires.

  6. Click on the ID of a Snapshot to open the Snapshot Details dialog, which will show a "top-down" view of the Snapshot, including pertinent information of how a Server deployed from the Snapshot would look, once deployed:

Snapshot Details:

  • Parent Server - The name of the Server from which the Snapshot was created

  • Snapshot ID - Unique ID of the individual Snapshot. 

    • Note: you can click on the  icon to copy the ID to your clipboard

  • OS Name - Name of the Operating System 

Details

  • Snapshot Start - End Time - Identifies the Time and Date that the Snapshot was taken (as described above) as well as the End Time when the system considers the Snapshot completed.

    • Note: End time is only provided for Manual Snapshots

  • Snapshot Type - Identifies where the Snapshot is System generated or Manual.

  • Snapshot State - Identifies the State of the Snapshot (Normal, Error, etc...).

  • Consistency Level

    • CRASH_CONSISTENT - Returned when either VMware Tools isn't installed on the server, isn't running, or is an out-of-date version.

      • Note: Consistency Level will always be CRASH_CONSISTENT for Servers with Open VM Tools installed.
    • FILE_SYSTEM_CONSISTENT - Returned if the current version of VMware Tools is running and either:

      1. Application consistency is NOT supported by the OS natively

      2. For Windows OS, the Rubrik Backup Service is not installed and registered.

    • VSS_CONSISTENT - Returned if the current version of VMware Tools is running and either:

      1. Application consistency IS supported by the OS natively

      2. For Windows OS, the Rubrik Backup Service is installed and registered

        1. The system will attempt to register the Backup Service on all Windows Servers prior to each Manual Snapshot.

    • INCONSISTENT - Returned when no valid VMware Tools are found. 

  • Archive Status - Displays whether the Snapshot is archived, available locally, or if it is currently being downloaded. For more information on Snapshot Archiving, see Introduction to Cloud Server Snapshots

Snapshot Configuration:

    1. CPU Count - Displays the number of CPU(s) allotted to the Parent Server

    2. CPU Speed - Displays the CPU Speed of the Parent Server 

    3. Cores Per Socket - Displays the Cores per Socket of the Parent Server

    4. RAM - Displays the RAM of the Parent Server

    5. Total Storage - Displays the total Storage of the Parent Server

Advanced Virtualization Settings:

  • Nested Hardware Virtualization - Can be True or False

  • CPU Latency  - Can be Normal or High

  • NUMA Autosize - Can be True or False

  • Enable Host Info to VM Tools - Can be True or False

OS Customization:

  • OS Customization Type - Displays whether the Parent Server was deployed with or without Guest OS Customization
  • Virtual Hardware Version - Displays the Hardware Version of the Parent Server

Network Information:

  • Network Domain - Displays the Network Domain that the Parent Server is associated with
  • VLAN - Displays the VLAN that the Parent Server is associated with
  • Private IPv4 - Displays the Private IPv4 of the Parent Server
  • IPv6 - Displays the IPv6 of the Parent Server

Storage:

  • Identifies the Storage arrangement of the Parent Server.

  • Note: You can 'drill down' into the storage section to review the allocated storage:

Data Center:

  • Identifies the Data Center and Cluster where the Parent Server was located when the Snapshot was taken

Important Note

A "Normal" Server created from a Snapshot Preview Server will inherit all of these characteristics/details.

How to Modify the Snapshot Description

  1. Locate the successful Snapshot on which you want to modify the description. Click on the Manage gear and select Modify Snapshot Description from the drop-down menu:


  2. The Modify Snapshot Description dialog will be displayed. Enter the desired description, and then click Confirm:

    Note: The description must be 255 characters or less

  3. The system will display a success message:


  4. The description will be added to the Snapshot:

How to Switch between Snapshot Service Plans

  1. Navigate to the Snapshot tab of the Server whose Snapshot Service Plan you would like to modify, then click on the Actions button in the Snapshot tab, and select Modify Snapshot Service Plan from the drop-down menu:


  2. The Modify Snapshot Service Plan dialog will be displayed:

    Note: Hover your mouse over the  information icon to view a tooltip with a link to documentation regarding Snapshot Plans:


  3. Select the desired Snapshot Service Plan from the drop-down menu, then click Save:

    Note: If Snapshot Replication is enabled, you cannot switch plans to a plan that does not support Replication

  4.  Select the desired Snapshot window:

    Important Note: The Snapshot Windows are listed in UTC time. Once a window is selected, the UI will display the local (Region) time in the dialog.
    Important Note: If you select a Snapshot Window that overlaps with maintenance, the snapshot might not occur. 

  5. Once you have selected the desired Snapshot Window, click Confirm:

    Note: We recommend you carefully review the Region Time of the Snapshot Window to ensure Snapshots occur during an appropriate time

  6. The system will display a success message:


  7. The Snapshot Service Plan will be updated:

Downgrading Snapshot Service Plan

If you choose to downgrade from a Snapshot Plan which has more Snapshot retention to a plan with less Snapshot retention, you will lose some snapshots.


How to Delete a Snapshot

  1. Locate the Manual Snapshot that you want to delete. Click on the Manage gear next to the desired Snapshot and select Delete Snapshot from the drop-down menu:

    Note: Only Manual Snapshots can be deleted. System Snapshots are purged from the system after they expire.

  2. The Delete Snapshot dialog will be displayed. Click Delete:


  3. The system will display a success message:


  4. The Snapshot will be deleted: