Advanced Configuration - Virtual Server Agent for Microsoft Hyper-V

Table of Contents

Understanding the CommCell Console

The Virtual Server Agent uses three main components to perform backup and restore operations from the CommCell Console.
  • Virtualization Client - A logical entity that provides a single point of administration for Hyper-V servers hosting virtual machines to be backed up.
  • Subclient - A logical entity that identifies a set of virtual machines to be backed up.
  • Backup Set - A group of subclients defining data to be backed up by the agent.

Protecting Migrated Virtual Machines

The backups for a Hyper-V cluster can be configured so that the data in the cluster is seamlessly backed up, and incremental backup cycles are maintained, even if virtual machines migrate from one host to another (live migration). For example, if the next scheduled backup after a live migration is an incremental backup, the incremental backup is performed for the migrated virtual machine, not a full backup.

Create a Virtualization Client

You must install the Virtual Server Agent on all Hyper-V servers in a cluster.

To create a client for a cluster:

  1. From the CommCell Console, right-click Client Computers and click New Client | Virtualization | Microsoft Hyper-V.
  2. Enter the Client Name.

    You can enter the Hyper-V cluster name or any other name to identify the group of Hyper-V nodes. Do not use the host name of an existing client.

  3. Enter the credentials required to access the Hyper-V cluster. These credentials must be valid for all nodes in the cluster.
  4. Click Add to identify the nodes of the Hyper-V client. 
  5. From the Exclude list, select all Hyper-V hosts as the nodes of the Hyper-V client.

    The list displays all computers that have the Virtual Server Agent installed.

    When you select all hosts in the failover cluster as nodes in the Hyper-V client, a virtual machine can be migrated to any host in the failover cluster and will still be included automatically in the next backup job. All virtual machines on all nodes will be protected, regardless of the hosts that they are actively running on.

  6. Click Include and click OK.
  7. Review the Client /Client Groups list.
    • Hyper-V nodes are selected to perform backup operations based on their sequence in the Client /Client Groups list (nodes are selected from the top of the list first).
    • You can change the position of a node by selecting the node and clicking the up or down arrow.
    • The first node serves as a coordinator proxy.
    • You can specify up to 16 proxies for each Hyper-V instance.
  8. Click OK.

Add or Remove Hosts for an Existing Client

To add or remove hosts from the cluster:

  1. From the CommCell Console, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V.
  2. Right-click Hyper-V and select Properties.
  3. Click the Nodes tab.
  4. To add hosts:
    1. Click Add.
    2. Select a node from the Exclude list and click Include.

      You can also select more than one node from the Exclude list. This list displays all Hyper-V servers that have the Virtual Server Agent installed.

    3. Click OK.
  5. Review the Client /Client Groups list.
  6. To remove any node from the list, select the client name for the node and click Remove.

    When you remove a node from the Microsoft Hyper-V client, any virtual machines from that Hyper-V server will not be included in the backup. If you have set up the  Microsoft Hyper-V client for a failover cluster, do not remove any hosts from the list of nodes.

  7. Click OK.

Enabling Shared VSS Shadow Copy

By default, each Hyper-V node with the Virtual Server Agent (VSA) installed engages Volume Shadow Copy Service (VSS) to create a shadow of the cluster shared volume (CSV) for the virtual machines owned by the node. You can enable other VSA proxy nodes that access the CSV to use a shared VSS shadow copy on the coordinator for streaming backups, eliminating the need to use resources for duplicate copies for each node. This feature is not supported for SnapProtect.

To enable this feature, configure the additional setting bCreateSharedShadow on the VSA proxy that acts as the coordinator.

  1. From the CommCell Browser, go to Client Computers.
  2. Right-click the VSA proxy client and select Properties.
  3. On the Client Computer Properties dialog, click Advanced.
  4. Click the Additional Settings tab.
  5. Click Add.
  6. Enter the following values:
    • Name: Type bCreateSharedShadow.
    • Category: Select or type Virtual Server.
    • Type: Select or type Integer.
    • Value: Select or type 1.
    • Verify that the Enable option is selected.
  7. Click OK to add the additional setting entry.
  8. Click OK to save the changes to the client properties.

Automatically Adding Unprotected Virtual Machines to the Default Subclient

By default, all the virtual machines from a Hyper-V Cluster are automatically included in the default subclient of any backupset.  This behavior is designed to ensure all virtual machines are backed up. However, following virtual machines will be excluded from the default subclient:

  • Virtual machines which are included in a user defined subclient.  This will avoid the duplicate backup of any virtual machine.
  • Virtual machines on the Hyper-V server where Virtual Server iDataAgent is not installed.
  • Virtual machines excluded by filters defined for the default subclient.

We recommend that in a Hyper-V instance, do not modify these settings for all default subclients. At least one default subclient must have the capability to serve as a catch-all entity for Hyper-V data. If you disable this feature for all the default subclients, some data in the Hyper-V Cluster may not get backed up.

If you do not want all virtual machines to automatically be included in the default subclient, you can do so as described in the following sections.

  1. From the CommCell Browser, navigate to Client Computers > virtualization_client  > Virtual Server > Hyper-V > backup_set.
  2. Right-click the default subclient and then select Properties.
  3. Click the Content tab. The Contents of subclient list displays All unprotected VMs as the content Type.

    That entry indicates that all virtual machines from the Hyper-V cluster, if they are not included in any other subclient in the given backup set, will be added automatically to the default subclient.

  4. Use the Add or Browse button to add one or more entries to back up specific VMs or sets of VMs. You can select specific virtual machines or add rules to identify virtual machines by categories such as virtual machine, host, or volume.
  5. To remove the default coverage for all virtual machines not covered by other subclients, select All unprotected VMs from the list and click Delete.
  6. Click OK.

If you remove all the entries from the Contents of subclient list, the All unprotected VMs will appear again in the list.

If all virtual machines are backed up by other subclients, a backup job for the default subclient fails.

  • To enable backup jobs for the default subclient to complete successfully when no virtual machines are discovered for the default subclient, configure the AllowEmptyDefaultSubclient additional setting on the Virtual Server Agent proxy and set the value to true.
  • To enable backup jobs for non-default subclients to complete successfully when no virtual machines are discovered for non-default subclients, configure the AllowEmptySubclient additional setting on the Virtual Server Agent proxy and set the value to true.

Selecting Virtual Machines for Backup

You can browse and manually select virtual machines or any other Hyper-V objects for backup. You can easily navigate to the required object using the Browse option and select it as a content of a subclient. You can select objects, such as hosts, virtual machines, volumes, and cluster shared volumes. When you select a Hyper-V object, all its child objects are automatically selected for backup. For example: If you select a host, all the virtual machines on the host are automatically selected for backup.

You can include Unicode characters for virtual machine path names.

The Browse dialog box provide following views for an Hyper-V cluster:

View

Description

Hosts View

 This view will be useful when you want to select hosts and clusters for backup. This is the default view.

VMs View

This view will be useful in the following scenario:
  • You want to backup multiple virtual machines and they exist on different hosts.
  • You want to backup a specific virtual machine and you know the host where the virtual machine  exist.

Storage View

This view will be useful when you want to backup all the virtual machines from a cluster shared volume or a local volume.

Hosts View

Follow the steps give below to browse the Hosts, Clusters and their child objects and then select the required objects.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Browse. The Hosts view is displayed by default.
  5. Expand any object to view the child objects.
  6. Select any object to include the object and its child objects are automatically included into the subclient.

    For example: If you select the "LAND", all the virtual machines on the "LAND" server are automatically selected.

  7. Click OK.

The selected object appears in the Content of the subclient list. The Type column displays the object type, e.g. Host, Virtual Machine etc.

VMs View

You can view all virtual machines in the Hyper-V Cluster and then select the required machines.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Browse.
  5. Select VMs. The list of all virtual machines on the Hyper-v cluster is displayed.
  6. Select a virtual machine to include it in the subclient.

    For example: You can select a virtual machine "Wave P6" to include it in the subclient.

  7. Click OK.

The selected virtual machine appears in the Content of the subclient list. 

When you select a virtual machine as a content of the subclient  and change its display name later, the virtual machine will be included in the subclient as long as its GUID remains the same.

For example, if select a virtual machine with display name "Wave P6" as a content of a "Test_Subclient" and after performing few backups, you change the display name of the virtual machine to  "Wave U2" then the next backup of the "Test_Subclient" will backup the virtual machine "Wave U2 " because the GUID of the virtual machine hasn't changed.

Storage View

You can view all cluster shared volumes (CSVs) and local disks in the Hyper-V server and then select a datastore.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Browse.
  5. Select Storage from the available list.
  6. Expand any Hyper-V Server node to view all the local volumes on the server or expand the Cluster Shared Volume node.
  7. Select any server, volume or cluster shared volume and all its child objects are automatically added into the subclient content.

    For example: When you select a Hyper-V Server "LAND", all the local volumes are automatically selected. All the virtual machines in the local volumes are added as a content.

  8. Click OK.

Note: If a CSV does not have any virtual machines defined, the CSV is not displayed in storage view.

Wildcards

You can use wildcards to define patterns for content and filters for a subclient or backupset. You can use wildcards when defining a rule for a VM Name Pattern, Guest OS, Guest DNS Hostname, Host, or when defining disk filters.

The following table describes how to use wildcards when defining the subclient content or filters:

If a subclient's content consists of wildcard characters and no eligible virtual machines are found for backup, the backup operation completes successfully even though no VMs are backed up.

Letters used in wildcard expressions are matched regardless of case; for example, 'a' matches both 'a' and 'A'.

Wildcards

Description

Examples

* Any number of characters

This wildcard is used to match all objects where the object name contains a specific pattern.

For a VM name pattern, *test* matches any virtual machine whose name contains the string 'test' (at the beginning, end, or middle of the name).
? Any one character

This wildcard is used to match any object for which a single character in the object name is variable.

DC? matches any object that starts with DC followed by a single additional character (such as DC1, DC2, DCa. or DCX).
[ ] Set or range of characters

Not supported for host names.

[a-m]* matches any object whose name begins with the letters 'a' through 'm'.
[ ! ] The negation of a set or range of characters

This wildcard matches objects for which the name does not include the specified set or range of characters.

Not supported for host names.

For example, [!AEIOU]* would match all object names that start with a letter other than A, E, I, O, or U.

[!A-C]* would match all names that do not start with the letters 'A' through 'C'.

Automatic Discovery of Virtual Machines for Backup

The Automatic Discovery feature enables you to discover virtual machines based on the specified criteria. This is feature is useful in environments where virtual machines are added, removed, or relocated on a frequent basis. You can set criteria to automatically include virtual machines into a subclient.

If an automatic discovery rule for a subclient identifies an entity that cannot be found, a backup job for the subclient fails. For example, if a rule points to a host that has been retired, that is treated as a failure during discovery, and the backup job fails.

To enable backup jobs to continue when an entity is not found, add the bAllowMissedContent additional setting on the Virtual Server Agent proxy and set the value to true.

For steps to add an additional setting, see Add or Modify an Additional Setting.

The following sections explain how to define rules for automatic selection of virtual machines:

Based on a VM Name Pattern

You can define a rule to select virtual machines based on their display name pattern.

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select VM Name/Pattern from the available list.
  6. Enter the initial few characters in the name of virtual machines which you want to backup.

    For example: If you want to backup all the virtual machines which has the word "cnet" in their names, enter "*cnet*".

  7. Click OK.

    The Content of subclient list displays the specified VM Name/Pattern. \

  8. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

Virtual Machines from a Specific Host

You can define a rule to include all the machines from a host into a subclient.

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client>  | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Host from the available list.
  6. Enter the name of the host.

    You can also click ... to open the Browse dialog box and select the required host.

    For example: You want to backup all the virtual machines from the host "SEA", select the "SEA" host.

  7. Click OK.

    The Content of subclient list displays the name of the selected Host.

  8. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

Virtual Machines from a Specific Volume

You can define a rule to include all the machines from a volume into a subclient.

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Browse from the rules list and select Storage in the Browse dialog box.
  6. Select the required volume in the Browse dialog box and click OK.

    For example: To back up all virtual machines from volume D, select volume D:.

  7. Click OK.

    The Content of subclient list displays the name of the selected Host.

  8. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

Virtual Machines from a Cluster Shared Volume

You can define a rule to include all machines from a cluster shared volume into a subclient.

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Browse from the rules list and select Storage in the Browse dialog box.
  6. Select the required volume from the cluster shared volumes in the Browse dialog box and click OK.

    For example: To back up all virtual machines from Volume1, select Volume1.

  7. Click OK.

    The Content of subclient list displays the name of the selected Host.

  8. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

Virtual Machines with a Specific Operating System Group

If the Hyper-V cluster has virtual machines with different operating systems, you can define a rule to back up all machines that have an operating system (OS) from a specific OS group.  Before defining the rule, ensure that the following prerequisites are satisfied:

  • The virtual machine must be powered on at the time of the backup.
  • The Hyper-V integration services must be installed and updated on the virtual machine.

Follow the steps given below to define a rule:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Guest OS from the rules list.
  6. Enter the name of the exact name of the operating system or use wildcards to define the OS group.

    For example: "Microsoft*" for all Microsoft Windows operating systems.

    For more information about exact name of the operating system, refer FAQ.

  7. Click OK.

    The Content of subclient list displays the Guest OS as the content Type.

  8. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

Virtual Machines with a Specific DNS Hostname

You can define a rule to back up all machines that have a specific DNS hostname. Before defining the rule, ensure that the following prerequisites are satisfied:

  • The virtual machine must be powered on at the time of the backup.
  • The Hyper-V integration services must be installed and updated on the virtual machine.

Follow the steps given below to define a rule:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Guest DNS Hostname from the rules list.
  6. Select Equal to include virtual machines with a DNS hostname into the subclient.
  7. Enter the hostname. If you do not know the exact hostname, you can specify the pattern of hostnames using wildcard characters.

    For example: If you want to backup all the virtual machine from "testlab" domain, you can enter *test*.

  8. Click OK.

    The Content of subclient list displays Guest DNS Hostname as the content Type.

  9. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

Combining Rules to Select Virtual Machines

You can combine multiple rules to define a Rule Group. You can use the following options to combine the rules into a rule group:

Match All of the Following Rules

This option is selected by default when you are defining a Rule Group. The AND condition is applied to the rules.

For example: The Rule Group contains following two rules:

Rule 1- Include all the virtual machines from Host A into the subclient.

Rule 2- Include all the virtual machines from Volume C into the subclient.

In this case, only those virtual machines will be included in the subclient, which are on Host A AND which exist on Volume C.

You can select this option to define a Rule Group as follows:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client>| Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Host from the rules list and enter "Host A".
  6. Click + to add one more rule.
  7. Select Browse from the rules list and select Storage in the Browse dialog box.
  8. Select Volume C in the in the Browse dialog box and click OK.
  9. Ensure that Match all of the following rules option is selected.
  10. Click OK.

    The rule appears as Custom Rule in the Content of subclient list. If you move the pointer over the rule from the list, the description of the rule will appear.

  11. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

Only those virtual machines will be included in the subclient, which are on Host A AND which exist on Volume C.

Match Any of the Following Rules:

When you select this option, the OR condition is applied to the rules.

For example: The Rule Group contains following two rules:

Rule 1- Include all the virtual machines from Host A into the subclient.

Rule 2- Include all the virtual machines from Volume C into the subclient.

In this case, only those virtual machines will be included in the subclient, which are on Host A or which exist on Volume C.

You can select this option to define a Rule Group as follows:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Host from the rules list and enter "Host A".
  6. Click + to add one more rule.
  7. Select Browse from the rules list and select Storage in the Browse dialog box.
  8. Select Volume C in the in the Browse dialog box and click OK.
  9. Select Match any of the following rules option.
  10. Click OK.

    The rule appears as Custom Rule in the Content of subclient list. If you move the pointer over the rule from the list, the description of the rule will appear.

  11. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

Only those virtual machines will be included in the subclient, which are on Host A OR which exist on Volume C.

Does Not Equal

You can use this operator only when you are defining more than one rule. Use this option to EXCLUDE any object from the subclient.

For example: The Rule Group contains following two rules:

Rule 1- Include all the virtual machines from Host A into the subclient.

Rule 2- Do not include all the virtual machines from Volume C into the subclient.

You can use this option to define a Rule Group as follows:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Host from the rules list and enter "Host A".
  6. Click + to add one more rule.
  7. Select Browse from the rules list and select Storage in the Browse dialog box.
  8. Select Volume C in the in the Browse dialog box and click OK.
  9. Select Does Not Equal in the second rule.
  10. Ensure that Match all of the following rules option is selected.

    You cannot select Match any of the following rules option when you have defined a rule with Does Not Equal operator.

    The rule appears as Custom Rule in the Content of subclient list. If you move the pointer over the rule from the list, the description of the rule will appear.

  11. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

The virtual machines on Host A will be included in the subclient. The virtual machines which are on Volume C will be excluded from the subclient.

Combining Contents in a Subclient

By default, the OR condition is applied to all content types in the Contents of subclient list. For example, A subclient has following two rules as the Contents of subclient. Each content type is selected independently.

Rule 1- Include all the virtual machines from "LAND" into the subclient.

Rule 2- Include all the virtual machines from the "Volume C" into the subclient.

In this case, all the virtual machines which are on LAND OR which exist in the Volume C, will be included in the subclient.

Follow the steps give below to independently select multiple types of content:

You can use this option to define a Rule Group as follows:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Add.
  5. Select Host from the rules list and enter "LAND".
  6. Click + to add one more rule.
  7. Select Browse from the rules list and select Storage in the Browse dialog box.
  8. Select Volume C in the in the Browse dialog box and click OK.
  9. Click OK.

    The Contents of subclient displays two Custom Rules. If you move the pointer over the rules from the list, the description of each rule will appear. 

  10. Click Preview to view the list of discovered virtual machines. These virtual machines will get backed up when you perform the backup of the subclient.

All virtual machines that are on host LAND or exist in Volume C will be included in the subclient.

Backup Set Filtering

Filters can be configured in backup set properties to exclude virtual machines or virtual machine disks from backups for all subclients under the backup set.  The same types of filtering that are available for subclients are also available for backup sets.

For each subclient under a backup set, the filtering specified for the backup set is combined with the filtering for the subclient to determine which content is excluded from backups. Any filtering defined in a backup set is also visible in the subclients under the backup set.

If a virtual machine is explicitly added to the content of a subclient, the virtual machine will be discovered by its GUID. If the display name changes later, the machine is still included in the subclient as long as its GUID remains the same. Any virtual machines identified in a subclient and discovered by their GUIDs will not be filtered from backups.

For subclients that are upgraded from SnapProtect Version 9 and have virtual machines or disks marked using the Do Not Backup option, those items are automatically added to the filters for subclients and backup sets.  

You can use wildcard characters when adding a pattern to define a rule for a VM Name Pattern, Guest OS, Guest DNS Hostname, Host, Datastore, or virtual machine disk.

You can create the following types of filters:

  • Virtual Machine Filters:
    • With a Specific Display Name
    • From a Specific Host
    • Based on a Name Pattern
    • With a Specific Operating System Group
    • From a Specific DNS Hostname
  • Disk Filters:
    • With a Specific Device Node
    • Based on a Disk Name Pattern

Defining Filters for a Backup Set

  1. From the CommCell Browser, navigate to Client Computers | <VirtualizationClient> | Virtual Server | Hyper-V.
  2. Right-click the backup set and select Properties.
  3. Click the Filters tab.
  4. Add filters for virtual machines:
    1. In the VM Filters area, you can browse to exclude a specific virtual machine, or virtual machines from a host, disk, volume, or cluster:
      • Specific VM - Click Browse, select Hosts from the drop-down list on the Browse dialog, expand the browse tree, and select a VM.
      • Host - Click Browse, select Hosts from the drop-down list on the Browse dialog, and select a host. (You can also click Add and create a filter using the Host option.)
      • Disk or Volume - Click Browse, select Storage from the drop-down list on the Browse dialog, and select a disk or volume.
    2. Click OK to add the filter.
    3. In the VM Filters area, click Add to add other types of filters. On the Add VM Filter dialog, select the filter type from the drop-down list and enter the appropriate information in the box on the right:
      • Host - Enter the host name as it appears in Hyper-V Manager. When you filter a host, all child objects for the host (such as datastores and resource pools) are automatically excluded from backups.
      • VM Name/Pattern - Enter a pattern (for example, Test* to exclude VMs for which the VM name begins with "Test").
      • Guest OS - Enter the exact name of the operating system or a pattern to identify an operating system group (for example, Microsoft* to filter any virtual machine that has a version of the Windows operating system). See Can I filter virtual machines with a specific operating system?

        • The virtual machine must be powered on at the time of the backup.
        • Hyper-V integration services must be installed and updated on the virtual machine.

      • Guest DNS Hostname - Enter a pattern to identify a hostname or domain (for example, myhost.mycompany.com to exclude a specific host or *mycompany.com to exclude all hosts on that domain). 

        • The virtual machine must be powered on at the time of the backup.
        • Hyper-V integration services must be installed and updated on the virtual machine.

    4. Click OK to add the filter.
  5. Add filters for virtual machine disks:
    1. In the VM Disk Filters area, click Add.
    2. On the Add Disk Filter dialog, select an option and provide a value:
      • Virtual Device Node - Select a device node from the drop-down list.
      • Virtual Disk Name Pattern - Enter a pattern for the names of disks to filter (for example, VMName.vhd or VMName.vhdx). 
    3. Click OK to add the filter.

    Note: For SnapProtect backups, disk filters are only applied when performing backup copy operations, and are not performed for Snap copies.

  6. Click OK to save the backup set properties.

To verify the list of virtual machines that are selected for backup, you can use the Preview button on the subclient properties Content tab. The Preview display includes an Add to Filters button that you can use to add specific virtual machines to filters.

Filtering Virtual Machines from a Backup

You can filter specific virtual machines from a backup of by defining filters.  You can set following criteria:

Virtual Machines with a Specific Display Name

You can set criteria to exclude the virtual machine with a specific display name. For example, if you have a subclient to backup all the VMs from a Hyper-V server, but you do not want to backup virtual machines with name "vm",  then you can define filter to exclude the virtual machine.

 Follow the steps given below to define the filter:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Filters tab.
  1. In the VM Filters area, click Browse and select a the virtual machine. For example: "Wave C6". 

    Click OK on the Browse dialog box.

    The VM Filters area displays the name of the filtered Virtual Machine.

  2. Click OK.

Virtual Machines from a Specific Host

You can set criteria to exclude all the virtual machines from a specific host. For example, if you have a subclient to backup all the virtual machines from a Hyper-V cluster, but you do not want to backup virtual machines from  Host "LAND", then you can define filter to exclude virtual machines from the Host "LAND".

Follow the steps given below to define the filter:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Filters tab.
  4. In the VM Filters area, click Browse and select a host. 

    Click OK on the Browse dialog box.

    OR

    In the VM Filters area, click Add. In the available list,  select Host and enter the exact host name as displayed in the Hyper-V Manager.

    Click OK on the Add Filter dialog box.

    The VM Filters area displays the host name of the filtered Host.

  5. Click OK.

Virtual Machines from a Specific Volume

You can set criteria to exclude all the virtual machines from a specific disk or volume. For example, if you have a subclient to backup all the virtual machines from a cluster, but you do not want to backup virtual machines which has disks on the volume 1, then you can define filter to exclude volume 1.

Follow the steps given below to define the filter:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Filters tab.
  4. In the VM Filters area, click Browse
  5. Select Storage from the available drop down list in the Browse dialog box. The dialog box will display all the disks and cluster shared volumes in the Hyper-V cluster.
  6. Select a disk or a volume.
  7. Click OK on the Browse dialog box.
  8. Click OK.

Based on a Virtual Machine Name Pattern

You can set criteria to exclude all the virtual machines based on a virtual machine name pattern. For example, if you have a subclient to backup all the virtual machines from a host, but you do not want to backup all virtual machines which has name starting with "Wave". In this scenario you can define filter to exclude all the virtual machines which has name starting with "Wave".

Follow the steps given below to define the filter:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Filters tab.
  4. In the VM Filters area, click Add
  5. Enter the few characters in the name of the virtual machines which you want to exclude. For example: Wave*
  6. Click OK on the Add Filter dialog box.

    The VM Filters area displays the VM Name/Pattern.

  7. Click OK.

Virtual Machines with a Specific Operating System Group

You can set criteria to exclude all virtual machines that have operating system from a specific OS Group. For example, if you do not want to backup virtual machines which has any version of Windows operating system, you can define filter to exclude all the virtual machines with Windows operating system.

Before defining the filtering criteria, ensure that following prerequisites are satisfied:

  • The virtual machine must be powered on at the time of the backup.
  • The Hyper-V integration services must be installed and updated on the virtual machine.

Follow the steps given below to define the filter:

  1. From the CommCell Browser, navigate to Client Computers | <Microsoft Hyper-V Client> | Virtual Server | Hyper-V | defaultBackupSet.
  2. Right-click the subclient and select Properties.
  3. Click the Filters tab.
  4. In the VM Filters area, click Add
  5.  In the available list,  select Guest OS and enter the exact name of the operating system or use wildcards to specify the OS group. For example, If you want to filter all the virtual machines which has any version of Windows operating system, enter Microsoft*.

    For more information about exact name of the operating system, refer FAQ.

  6. Click OK on the Add Filter dialog box.

    The VM Filters area displays name of the filtered Guest OS.

  7. Click OK.

Virtual Machines with a Specific DNS Hostname

You can set criteria to exclude all the virtual machines with a specific hostname. For example, you can define a filter to exclude all virtual machines that have hostnames ending with mycompany.com.

Before defining the filtering criteria, ensure that following prerequisites are satisfied:

  • The virtual machine must be powered on at the time of the backup.
  • The Hyper-V integration services must be installed and updated on the virtual machine.

Follow the steps given below to define the filter:

  1. From the CommCell Browser, navigate to Client Computers | virtualization_client | Virtual Server | Hyper-V | backup_set.
  2. Right-click the subclient and select Properties.
  3. Click the Filters tab.
  4. In the VM Filters area, click Add
  5.  In the available list,  select Guest DNS Hostname and enter a hostname. For example: mycompany.com.
  6. Click OK on the Add Filter dialog box.

    The VM Filters area displays name of the filtered Guest DNS Hostname.

  7. Click OK.

Filtering Virtual Machine Disks from a Backup

You can filter Hyper-V virtual machine disks to exclude the disks during streaming backups and SnapProtect backup copy operations.

Note: For SnapProtect backups, disk filters are only applied when performing backup copy operations, and are not performed for Snap copies.

Filtering can be performed in the following ways:

  • Using disk pattern names, including wildcard characters
  • Based on a virtual device node that consists of the controller number followed by the hard disk device number (only supported for IDE disks).

To add disk filtering to an existing subclient:

  1. From the CommCell Browser, navigate to Client Computers | <VirtualizationClient> | Virtual Server | Hyper-V | <BackupSet>.
  2. Right-click the subclient and select Properties.
  3. Click the Filters tab.
  4. Under VM Disk Filters, click Add.
  5. On the Add Disk Filter dialog, select one of the following options:
    • VM Disk Name/Pattern - Enter a pattern using wildcard characters. For example, to select virtual machine disks that begin with the characters "vm", enter vm*.
    • Virtual Device Node - Select an IDE disk from the drop-down list.
  6. Click OK.

    The VM Disk Filters area displays the pattern or virtual device nodes that were entered for the disk filter.

 

LAN-Free Backups Using Cluster Shared Volumes as Disk Libraries

Hyper-V nodes can send backup data to directly connected storage, without using the local area network (LAN) to route backup data through another node. This section describes the configuration of LAN-free backup using Hyper-V cluster shared volumes (CSVs) as magnetic libraries, which is the simplest way to configure LAN-free backups.

This approach simplifies library configuration, automatically distributes jobs across all nodes for load balancing, significantly reduces the amount of time required for backups, and minimizes the impact on the network and other resources.

This feature is only concerned with how backup data is routed by VSA nodes to backup media.

To enable all Hyper-V nodes in a cluster to perform LAN-free backups, use the following configuration:

  • Install the Virtual Server Agent (VSA) and MediaAgent on each node in the Hyper-V cluster. For more information, see Deployment - Microsoft Hyper-V.
  • Configure a library to use cluster shared volume (CSV) storage. Identify a MediaAgent for the node that will act as the coordinator for job streams directed to the library, and add a mount path in the form C:\ClusterStorage\Volume<n>, where <n> is the volume number. 
  • Configure sharing for the mount path properties, using the same cluster storage volume for each MediaAgent on the Hyper-V cluster that is selected for sharing.
  • Create a storage policy to be used for LAN-free jobs, identifying the library and MediaAgent. Add the data paths for all nodes to the Primary copy for the storage policy.
  • Add all nodes in the cluster to the Nodes tab for the Hyper-V virtual server instance. 
  • Ensure that all subclients point to the LAN-free storage policy.

When a Hyper-V node initiates a job for a virtual machine, the coordinator VSA determines which MediaAgent is local to the VM. The job stream is moved to the local MediaAgent, which sends data directly to shared storage without routing it through the LAN. Index updates for all nodes are managed at the coordinator VSA.

If the coordinator VSA becomes unavailable, all jobs restart and a new VSA becomes the coordinator. 

When a backup job is running, the Backup Job Details dialog shows which MediaAgent is managing the job stream. That dialog updates dynamically to show when the job stream moves to a new MediaAgent.

Configure LAN-Free Resources

After the Virtual Server iDataAgent and MediaAgent are installed on all nodes in the Hyper-V cluster, perform the following steps to configure the resources required for LAN-free jobs.

  1. Configure the library:
    1. In the CommCell Browser, go to Storage Resources | Libraries.
    2. Right-click Libraries and select Add | Disk Library.
    3. On the Add Disk Library dialog, enter the library name and select a MediaAgent.
    4. Click the ... button for Local Path / Disk Device and browse to select a volume in the C:\ClusterStorage folder.
    5. Click OK.

    A library and mount path are created under Libraries.

  2. Configure sharing for the mount path:
    1. Right-click the mount path under the library you created and select Properties.
    2. Select the Sharing tab and click Share.
    3. Select the MediaAgents for the other nodes in the cluster. For each select the same cluster storage volume (C:\ClusterStorage\Volume<n>).
    4. Click OK to add the shared MediaAgents, and OK again to save the mount path properties.
  3. Configure the storage policy:
    1. Go to Policies | Storage Policies.
    2. Right-click Storage Policies and select New Storage Policy.
    3. On the Create Storage Policy Wizard, select Data Protection and Archiving and click Next.
    4. Enter the storage policy name and click Next.
    5. Select the library you created for LAN-free jobs and click Next.
    6. Select the MediaAgent and click Next.
    7. Accept the defaults for device streams and aging rules and click Next.
    8. Accept the defaults for deduplication and click Next.
    9. Provide the location for the deduplication database and click Next.
    10. Click Finish to create the storage policy.
  4. Add data paths for all nodes to the Primary copy for the storage policy:
    1. In the CommCell Browser, expand the storage policy you created. Right-click the Primary copy and select Properties.
    2. Select the Data Paths tab and click Add to add data path candidates for all other nodes in the cluster.
    3. Click OK to save the data path candidates and OK again to save the Copy Properties.
  5. Add all cluster nodes to each client:
    1. Go to Client Computers | <Client> | Virtual Server | Hyper-V.
    2. Right-click Hyper-V and select Properties.
    3. Click the Nodes tab and click Add to include the other nodes in the cluster.
    4. On the Select Clients / Client Groups dialog, select clients in the Exclude list and click Include to add them as nodes for the virtual server instance.
    5. Click OK to save the client selections and OK again to save the Virtual Server Instance Properties.
    6. Repeat for all clients.
  6. Specify the LAN-free storage policy for all subclients:
    1. Expand the Hyper-V entry to show the backup sets, then right-click a subclient under the backupset and select Properties.
    2. Select the Storage Device tab and choose the storage policy created for LAN-free jobs.
    3. Click OK to save the subclient properties.
    4. Repeat for each subclient that will use LAN-free backups.

Displaying Backed Up Virtual Machines in the CommCell Console

Prerequisites

  • The virtual machine must be powered on at the time of the backup.
  • The Hyper-V integration services must be installed and updated on the virtual machine.

If these prerequisites are not satisfied, the virtual machine will appear as a client computer. However, the hostname and DNS will not appear in the Client Computer Properties dialog box.

If you remotely install any software on a virtual machine and any required information such as the host name is missing from the database, the installation fails. If you interactively install any software on the virtual machine and any information such as the client name or host name is different, the virtual machine is treated as a new client and a duplicate client is created.

To avoid duplicate client entries caused by different client or host names, use the install software option for the client level in the CommCell Console rather than interactively installing software to the virtual machine Guest Operating System.

Show Virtual Machines in Client Computers list

Follow the steps given below to display virtual machines in all the subclients as client computers:

  1. From the Tools menu in the CommCell console, click Control Panel.
  2. Double-click User Preferences.
  3. Click the Client Computer Filter tab.
  4. Select the Show Virtual Server Discovered Clients check box.
  5. Click OK.

All the virtual machines, backed up by any subclient, will appear in CommCell Browser.

Expand the Client Computers node to view the virtual machines.

Show Virtual Machines in the Client Computer Groups List

A new client group will be created for each host. All the virtual machines from the host will added to the client group. Follow the steps given below to display virtual machines in Client Groups list in the CommCell Console:

  1. From the Tools menu in the CommCell console, click Control Panel.
  2. Double-click User Preferences.
  3. Click the Client Computer Group Filter tab.
  4. Select the Show Virtual Server Discovered Clients check box.
  5. Click OK.

All the virtual machines, backed up by any subclient, will appear in CommCell Browser.

Expand the Client Computer Groups node to view the virtual machines. A new client group is created for each host.

Expand the node for each group to view the virtual machines on that host.

Configuring Backups for Virtual Machines Hosted on SMB Shares

You can back up and restore virtual machines residing on Server Message Block (SMB) 3.0 shares.

The VSA Proxy for Cluster Shared Volumes feature does not support backup of virtual machines hosted on SMB.

For SnapProtect backups, a crash consistent backup is always performed for an SMB share. For streaming backups, you can configure the subclient to perform an application consistent backup or a crash consistent backup (in the Subclient Properties dialog box, on the Backup Options tab).

Prerequisites

The following requirements must be met before backing up any virtual machine from the SMB shares. If there are multiple nodes, fulfill these requirements for every node of the scale-out file cluster.

  • The Application server and file server must be running on Windows Server 2012 or later.
  • The File Server VSS Agent Service server role must be enabled on the file servers.
  • Application servers and file servers must be connected to an Active Directory domain residing in the same Active Directory forest.
  • The user account for the virtualization client must be part of the following administrator groups on the Hyper-V host:
    • Local Administrators group
    • Hyper-V Administrators group

    For a Hyper-V cluster, the user account must have full Cluster Permissions (Read and Full Control).

SnapProtect requirements:

  • SnapProtect backups of virtual machines on SMB shares are only supported for SMB 3.0 and NetApp version 8.2 or later.
  • For SnapProtect, the MediaAgent must be running on Windows Server 2012 R2 or later.
  • The NetApp Vserver where the virtual machine resides must be added on the storage array.

Granting Permissions for the SMB Share

The Hyper-V server machine account and the virtualization user name must be granted full permissions to the SMB share by performing the following steps:

  1. Right-click the SMB share folder and point to Properties.
  2. On the Sharing tab, click Advanced Sharing.
  3. In the Advanced Sharing dialog box:
    1. Select Share this folder.
    2. If necessary, click Add to add a new share.
    3. Click Permissions.
  4. In the Permissions dialog box, select the user account for the virtualization client, and then click OK.
  5. Click OK to save the advanced sharing properties.
  6. On the Security tab, select the user account for the virtualization client and give that account full permissions.
  7. Click OK.

Selecting Virtual Machines on the SMB Share for Backup

You can view all cluster shared volumes and file server hosting the share

  1. From the CommCell Browser, navigate to Client Computers > virtualization_client > Virtual Server > Hyper-V > backup_set.
  2. Right-click the subclient and select Properties.
  3. Click the Content tab.
  4. Click Browse.
  5. In the Browse dialog box, select the Storage view from the list at the top left.
  6. Expand any Hyper-V Server node to view all of the local volumes on that server, or expand the Cluster Shared Volume node.
  7. Select any file server, volume, or cluster shared volume; all child objects of the selected object are automatically added into the subclient content.
  8. Click OK.

Configuring Backups Using Hardware VSS Provider from Storage Vendor

You can perform backups using the hardware VSS Provider offered by the storage vendor. Using a hardware VSS Provider can improve the performance of backup operations; for Hyper-V clusters, it reduces the amount of time that cluster shared volumes are caught in redirected-access mode.

Perform the following steps to configure the VSSProvider additional setting to use the vendor's hardware VSS provider:

  1. From the CommCell Browser, go to to Client Computers.
  2. Right-click a client computer, and then click Properties.
  3. On the General tab of the Client Computer Properties dialog box, click Advanced.
  4. Click the Additional Settings tab.
  5. Click Add.
  6. On the Add Additional Settings dialog box, provide the following information:
    • Name: Type VSSProvider.
    • Category: Select VirtualServer (the default value).
    • Type: Select STRING (the default value).
    • Value: Enter the hardware VSS Provider ID of the vendor.

      To find the ID, run the following command on your client computer:

      vssadmin list providers

      An example of a provider ID (for NetApp) is ddd3d232-a96f-4ac5-8f7b-250fd91fd102.

    • Ensure that the Enable option is selected.
    • Click OK to add the additional setting.
  7. Click OK twice to save the client properties.

Your backup operations will use the hardware VSS Provider instead of the software VSS Provider from Microsoft.

Crash Consistent Backups

If a backup of a virtual machine only needs to capture stored data, a crash consistent backup can be performed very quickly while the virtual machine remains online. This option can be used for non-Windows virtual machines, legacy Windows virtual machines, and Windows virtual machines that do not require application consistent backups. A crash consistent backup can also be used when backups fail because of Volume Shadow Copy Service (VSS) errors; running a crash consistent backup ensures that virtual machines are backed up, even when VSS cannot be engaged successfully.

The crash consistent backup method has the advantage of completing quickly without interrupting the virtual machine; but it is not appropriate for virtual machines that need an application consistent backup. Crash consistent backups use Hyper-V snapshot and checkpoint capabilities to create the backup.

By default, backups are application consistent and include pending transactions. Application consistent backups may require taking a virtual machine offline temporarily, because it is difficult to capture pending transactions while the virtual machine is running. This is usually the case with virtual machines hosting high transaction applications, such as applications that rely on frequent database updates. Application consistent backups require Hyper-V Integration Services and VSS on the virtual machine.

Note: You must use the application consistent backup option to back up shared VHDX files.  Although you must specify the application consistent backup option, shared VHDX disk files can only be backed up in a crash consistent format (a Microsoft limitation).

In cases where a crash consistent backup is sufficient, you can set the backup options for a subclient to enable crash consistent backups.

Windows Server 2008 R2 does not support online merging of virtual machine snapshots. If crash consistent backups are used for backups performed by a Virtual Server Agent installed on a Windows Server 2008 R2 host, .avhd files will be left after the backup completes, and a power cycle of the virtual machine will be required to force the .avhd files to be merged back into the parent .vhd file.

Enabling Crash Consistent Backups

  1. From the CommCell Console, navigate to Client Computers | <Client> | Virtual Server | Hyper-V | <BackupSet>.
  2. Under the backup set, right-click a subclient and select Properties.
  3. Click the Backup Options tab.
  4. Select the Perform crash consistent backup option to use that option for all virtual machines under the subclient.
  5. Click OK.

Modifying an Agent, Instance, or Subclient

Certain properties of Agents, Instances, and Subclients can be modified to accommodate changes to your configuration, data, or desired backup behavior.

You cannot modify the properties of an instance or subclient when a job is in progress for that specific instance or subclient. If a job is in progress, either wait for the job to complete or kill the job from the Job Controller.

The following table describes the properties that can be configured from these levels.

Option Description Related Topics
Change Storage Policies You can modify the storage policies in any of the following situations:
  • To include a different media for the backup operation.
  • To use a storage policy with a different retention criteria.

You can change the storage policies from the subclient level.

  1. From the CommCell Browser, right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Select the Storage policy from the drop-down menu.
  5. Click OK.
Refer to Storage Policies.
Rename a Backup Set or Subclient

You can rename a subclient:

  1. From the CommCell Browser, right-click the subclient.
  2. Click Properties.
  3. Type the new name in the  Subclient name field.
  4. Click OK.
 
Data Transfer Options You can configure the available resources for transferring data secured by data protection operations from the subclient level. This includes the following:
  • Enable or disable Data Compression either on the client or on the MediaAgent.
  • Configure the transfer of data in the network using the options for Network Bandwidth Throttling and Network Agents.

You can configure the data transfer options.

  1. From the CommCell Browser, right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Click Data Transfer Option tab.
  5. Choose the appropriate software compression option for this subclient.
  6. Select Throttle Network Bandwidth and set the required bandwidth.
  7. Click OK.
Refer to Data Compression and Network Bandwidth Throttling.
View Data Paths You can view the data paths associated with the primary storage policy copy of the selected storage policy or incremental storage policy. You can also modify the data paths including their priority from the subclient level.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Select Storage Policy from the drop-down menu.
  5. Click Data Paths.
 
Number of Data Readers Use this option to specify the number of simultaneous backup data streams allowed for this subclient.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties
  3. Type the Number of Data Readers.
  4. Click OK.
Refer to Streams.
Configure a Subclient for Pre and Post Processing of Data Protection You can add, modify or view Pre/Post processes for the subclient. These are batch files or shell scripts that you can run before or after certain job phases.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Pre/Post Process.
  4. Click one of the following phases and type the full path of the batch file that you want to execute during that phase.
    • PreBackup Process
    • PostBackup Process

    Alternatively, click Browse to locate the batch file (applicable only for paths that do not contain any spaces).

  5. Select Run Post Scan Process for all attempts to run a post scan process for all attempts.
  6. Select Run Post Backup Process for all attempts to run a post backup process for all attempts.
  7. Click Change to specify the user account which has permissions to run these batch files.
  8. In the User Account dialog box, select one of the following:
    • Use Local System Account - Select this option if you want to use the Local System Account to execute the batch files and click OK.
    • Impersonate User  - Select this option if you want to use a specific user account to execute the batch files. Enter the user name and password for the user account and click OK.
  9. Click OK.

The batch files or scripts will be executed on the first available node from the list of nodes. You can view the list of proxy computers on the Nodes tab of the Virtual Server Instance Properties dialog box.

Refer to Pre/Post Processes.
Configure Activity Control You can enable backup and restore operations from the agent and subclient level. However, you can enable restore operations only from the agent level.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Activity Control, select or clear option(s) as desired.
  4. Click OK.
Refer to Activity Control.
Configure User Security You can configure user security from the agent or subclient level.

You can perform the following functions:

  • Identify the user groups to which this CommCell object is associated.
  • Associate this object with a user group.
  • Disassociate this object from a user group.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Security.
  4. Select the appropriate user groups to which you want to associate to the CommCell object from the Available Groups pane, and then move the user group to the Associated Groups pane.
  5. Click OK.
Refer to User Administration and Security.
View Software Version and Installed Updates The Version tab, at the Agent level displays the software version and post-release service packs and updates installed for the component.
  1. From the CommCell browser, right-click the agent.
  2. Click Properties.
  3. Click Version.
  4. Click OK.
 
CommCell Configuration Report The CommCell Configuration Report provides the properties of the CommServe, MediaAgents, clients, agents, subclients, and storage policies within the CommCell based on the selected filter criteria.
  1. From the CommCell browser, click Reports icon.
  2. Select CommCell Configuration.
  3. Click Run.
Refer to CommCell Configuration.

Deleting an Instance, Backup Set, or Subclient

The following sections describe the steps involved in deleting an instance, backup set, or subclient.

When you delete an instance or backupset, the associated data is logically deleted and you can no longer access the corresponding data from CommCell Console for recovery purposes.

Refer to the troubleshooting article on Recovering Data Associated with Deleted Clients and Storage Policies for information on how to recover data if you accidentally delete an entity.

Deleting an Instance

Consider the following before deleting an instance:

  • When you delete a specific instance all job schedules and job histories that pertain to any of the levels within the deleted instance are deleted.
  • You cannot delete an instance if it is being backed up. Attempts to delete an instance under such conditions cause the deletion to fail. If a backup is in progress, either wait for the backup to complete or kill the backup job using the Job Controller. Once the backup is no longer in progress, you can delete the instance level.
  • You cannot delete an instance if there is only one instance present for an agent. To delete the final instance, you must remove the agent software from the client computer.
  1. From the CommCell Browser, right-click the instance that you want to delete, click All Tasks and then click Delete.
  2. Click Yes to confirm the deletion. (Clicking No cancels the deletion and retains the node.)
  3. Type the requested phrase in the Enter Confirmation Text dialog box and click OK. This should delete the instance.

Deleting a Backup Set

Consider the following before deleting a backup set:

  • You cannot delete a default backup set.
  • Schedules associated with the backup set are also automatically deleted.
  1. From the CommCell Browser, right-click the user-defined backup set  that you want to delete, and then click Delete from the shortcut menu.
  2. A confirmation message is displayed, asking if you want to delete the backup set.

    Click No to cancel the deletion and retain the backup set, or click Yes to continue the deletion.

Deleting a Subclient

Consider the following before deleting a subclient:

  • You cannot delete a default subclient.
  • Schedules associated with the subclient are also automatically deleted.
  1. From the CommCell Browser, navigate to Client Computers | <Client> | <Agent> | <Backup Set>.
  2. Right-click the <subclient> that you want to delete, and then click Delete.
  3. A confirmation message is displayed, asking if you want to delete the subclient.

    Click No to cancel the deletion and retain the subclient, or click Yes to continue the deletion.

Configuring Data Protection Alerts for Virtual Machines

You can perform the steps provided in Generating Alerts to configure a data protection alert for virtual machines. You can configure alerts to provide notification and details about specific virtual machines when jobs are started, suspended, resumed, killed, completed, or failed. The alert notification can include tokens for the virtual machine name, host, status, and protection failure reason.

When adding the alert, use the following options for the Add Alert Wizard:

  • On the General Information page, select Job Management for the Category and Data Protection for the Type.
  • On the Entities Selection page, select the Virtual Server clients to be included for the alert or client groups that include those Virtual Server clients.
  • Select options as needed on the Threshold and Notification Criteria Selection page.
  • On the Notification Type(s) Selection page, you can customize the email notification message by selecting an insertion point in the email message form, selecting a token from the drop-down list, and clicking Add Token. To help monitor protections operations for virtual machines, you can include the following tokens:
    • <PROTECTED OBJECTS>
    • <VIRTUAL MACHINE NAME>
    • <VIRTUAL MACHINE HOST NAME>
    • <VM STATUS>
    • <VM FAILURE REASON>
  • On the User(s) and User Group(s) Selection page, add users to receive notifications for the alert.

The notifications generated for the alert include information about all discovered virtual machines for the selected virtualization clients. You can set the Show Virtual Machines option in User Preferences to view discovered virtual machines.

For any subclients that have backups disabled (on the Activity Control tab of the subclient properties), discovered VMs are not included in alerts.