Managing VM Group Content

For an existing VM group, you can add virtual machines or modify the content selections.

Caution

Because OpenShift applications do not have a UUID or GUID to uniquely identify each application, the Commvault software indexes each application with an ID in the form project_name-application_name.
If you delete an application and later create a new application for the project that uses the same application name, the backup history for the new application is indexed using the ID that was created for the original application. In that scenario, restoring from a backup job for the original application might overwrite data for the new application, resulting in data loss.

Procedure

From the navigation pane, go to Protect > Virtualization.

The Virtual machines page appears.
On the Hypervisors tab, click the hypervisor.

The hypervisor page appears. The VM groups area displays summary information for any existing VM groups.
Click an existing VM group.
Under Content, click Manage.

The Content tab of the VM group content page shows the currently selected content to be backed up (hosts, specific VMs, or source virtual machine storage).
To modify virtual machine credentials for application-aware backups, click in the Actions column of the row for the VM, and then select Edit Credentials.
To remove a virtual machine, click in the Actions column of the row for the VM and select Remove.
To add VM group content, click Add virtual machines.

The Add virtual machines page appears.
Select a browse method for the Browse and select VMs list, and then expand the tree below the list to select hosts, specific VMs, or VM storage locations for the VM group, or to clear previous selections.

You can select one of the following options from the list to control the browse display:
- Alibaba Cloud:
  - By region: Select an instance within a region.
  - By zone: Display zones under each region and select an instance within a zone.
    
    Note
    
    The image that was used to create an instance must be present when you perform a backup operation. If the image is not available when the backup is performed, a browse operation of guest files and folders from that backup fails.
- Amazon Web Services:
  - By instance type: Select an instance of a particular type within a region.
  - By region: Select an instance within a region.
  - By tags: Select an instance with particular tags.
  - By zone: Select an instance within a zone and region.
  - VMs: Select this option to browse and select specific VMs.
- Google Cloud Platform:
  - Project: Select an instance within a project.
  - Region: Select an instance within a region and project.
  - Zone: Select an instance within a zone and project.
- Microsoft Azure Classic:
  - Cloud services: Select cloud services for Azure Classic.
  - Regions: Select an Azure region to include all VMs in that region.
  - Storage Accounts: Select a storage account to include all VMs that reside in the storage account.
  - VMs: Select this option to browse and select specific VMs.
- Microsoft Azure Resource Manager:
  - Regions: Select an Azure region to include all VMs in that region.
  - Resource group: Select a resource group for Azure Resource Manager.
  - Storage Accounts: Select a storage account to include all VMs that reside in the storage account.
  - Tags: Select a tag to include all VMs associated with the selection.
  - VMs: Select this option to browse and select specific VMs.
- Microsoft Azure Stack HCI:
  - Group by host: Select this option to view hosts and the VMs running on each host. Select a host entry to protect all VMs on the host, or expand the tree to select specific VMs.
    
    Virtual machines are shown directly under the host.
  - Storage: Select this option to view storage containing virtual machine data. Select the storage entry to protect all VMs on the storage, or expand the tree to select specific VMs.
  - VMs: Select this option to browse and select specific VMs.
- Microsoft Hyper-V:
  - Group by host: Select this option to view hosts and the VMs running on each host. Select a host entry to protect all VMs on the host, or expand the tree to select specific VMs.
    
    Virtual machines are shown directly under the host.
  - Storage: Select this option to view storage containing virtual machine data. Select the storage entry to protect all VMs on the storage, or expand the tree to select specific VMs.
  - VMs: Select this option to browse and select specific VMs.
- Nutanix AHV:
  - Container: Select a storage container or specific virtual machines.
  - Data protection: Select a host, protection domain, or specific virtual machines.
  - VMs: Select this option to browse and select specific VMs.
- OpenStack:
  - Projects: Select a project, region, instance, or image.
  - Admin: Select images or instances.
- Oracle Cloud Classic:
  - Instances: Select instances to be backed up.
- Oracle Cloud Infrastructure:
  - VMs: Select instances to be backed up.
    
    You can only back up and restore instances in the root compartment and first-level compartments for Oracle Cloud Infrastructure regions. You cannot back up instances in subcompartments or restore instances to subcompartments. As a workaround, either move the instances to the root compartment or a first-level compartment, or install an agent such as a file system agent on the guest instances.
- Oracle VM:
  - Servers and VMs: Select server pools, VM pools, servers, or virtual machines.
  - Repositories: Select storage repositories.
- Red Hat OpenShift:
  - Projects: Select a project to include all applications for the project, or expand a project to select applications.
  - Applications: Select an application.
- Red Hat Virtualization:
  - System: Select this option to view the data centers.
  - Clusters: Select this option to view a specific cluster.
  - Hosts: Select this option to view the RHEV Manager hosts.
  - Storage: Select this option to view storage containing virtual machine data. Select the storage entry to protect all VMs on the storage, or expand the tree to select specific VMs.
  - VMs: Select this option to browse and select specific VMs.
  - Tags: Select a tag to include all VMs associated with the selection.
- vCloud Director: Use the Organizations view to browse a vCenter, organization, VDC, or vApp.
  
  You can select VMs under an entity or select an entity to include all VMs under the entity.
- VMware:
  - Hosts and clusters: Select this option to view hosts and the VMs running on each host. Select a host entry to protect all VMs on the host, or expand the tree to select specific VMs.
    
    The top level of the browse shows all accessible vCenters at the top level, ESX servers under vCenters, and virtual machines under each ESX server.
  - VMs and templates: Select this option to browse and select specific VMs.
  - Datastores and datastore clusters: Select this option to view datastores containing virtual machine data. The top level of the browse shows all accessible hosts at the top level, with datastores under hosts and virtual machines under each datastore. Select a datastore entry to protect all VMs on the storage, or expand the tree to select specific VMs.
  - Tags and categories: Select this option to view categories, tags, and virtual machines that are marked with a tag.
    
    When you select a tag, the selection includes all VMs that are marked with the tag. When you select a category, the selection includes all VMs that are marked with a tag that belongs to the selected category.
Click OK after selecting VMs or other objects.
To discover virtual machines automatically:
1. Click Add rule.
2. From the Select rule for list, choose one of the following:
  - Alibaba Cloud:
    
    Instance name/pattern: In the Name box, type the display name of the instance or a pattern using wildcards (for example, Test* to identify instances for which the instance name begins with "Test").
    
    Zone: In the Name box, type the name of the zone or a pattern using wildcards (for example, us-east* to identify zones for which the zone name begins with "us-east"). When you add a zone, all instances in the zone are included in backups.
  - Amazon Web Services:
    
    Guest DNS hostname: In the Name box, type a hostname or a pattern to identify a hostname or domain (for example, myhost.mycompany.com to identify a specific host or *mycompany.com to identify all hosts on that domain).
    
    Guest OS: In the Name box, type the exact name of the operating system or a pattern to identify an operating system group (for example, Microsoft* to identify any virtual machine that has a version of the Windows operating system).
    
    Instance name/pattern: In the Name box, type the display name of the instance or a pattern using wildcards (for example, Test* to identify instances for which the instance name begins with "Test").
    
    Instance state: Select Running or Stopped.
    
    Zone: In the Name box, type the name of the zone or a pattern using wildcards (for example, us-east* to identify zones for which the zone name begins with "us-east"). When you add a zone, all instances in the zone are included in backups.
  - Google Cloud Platform:
    
    Instance name/pattern: In the Name box, type the display name of the instance or a pattern using wildcards (for example, Test* to identify instances for which the instance name begins with "Test").
    
    Label: In the Key box, choose Equals, Starts with, Contains or Ends With, and then type the key or a pattern using wildcards (for example, 123* to identify keys for which the key name starts with "123"). In the Value box, choose Equals, Starts with, Contains or Ends With, and then type the value or a pattern using wildcards (for example, 123* to identify values for which the value name starts with "123").
    
    Project: In the Name box, type the name of the project or a pattern using wildcards (for example, us-east* to identify projects for which the project name begins with "us-east"). When you add a project, all instances in the project are excluded from backups.
    
    Zone: In the Name box, type the name of the zone or a pattern using wildcards (for example, us-east* to identify zones for which the zone name begins with "us-east"). When you add a zone, all instances in the zone are excluded from backups.
  - Microsoft Azure Classic:
    
    Cloud services: In the Name box, type a cloud service name or a pattern to identify a cloud service.
    
    Power state: From the Name list, select the power on status of virtual machines to be included in the VM group content. You can select On to identify VMs that are powered on, Off to identify VMs that are powered off, or Other to identify VMs with a different power on status, such as Suspended.
    
    Region: Select a region to include all VMs in that region.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
  - Microsoft Azure Resource Manager:
    
    Power state: From the Name list, select the power on status of virtual machines to be included in the VM group content. You can select On to identify VMs that are powered on, Off to identify VMs that are powered off, or Other to identify VMs with a different power on status, such as Suspended.
    
    Region: Select a region to include all VMs in that region.
    
    Resource group: In the Name box, type a resource group name or a pattern to identify a resource group.
    
    Storage Account: Select a storage account to include all VMs that reside in the storage account.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
  - Microsoft Azure Stack HCI:
    
    Guest DNS hostname: In the Name box, type a hostname or a pattern to identify a hostname or domain (for example, myhost.mycompany.com to identify a specific host or *mycompany.com to identify all hosts on that domain).
    
    Guest OS: In the Name box, type the exact name of the operating system or a pattern to identify an operating system group (for example, Microsoft* to identify any virtual machine that has a version of the Windows operating system).
    
    Host: In the Name box, type the host name, the IP address of the host, or a host name pattern using wildcards. When you add a host, all virtual machines on the host are included in the backup.
    
    Notes: In the Name box, type a pattern to identify virtual machines based on notes text contained in annotations for the VM summary (for example, Test* to identify VMs with a note that begins with "Test").
    
    Power state: From the Name list, select the power on status of virtual machines to be included in the VM group content. You can select On to identify VMs that are powered on, Off to identify VMs that are powered off, or Other to identify VMs with a different power on status, such as Suspended.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
  - Microsoft Hyper-V:
    
    Guest DNS hostname: In the Name box, type a hostname or a pattern to identify a hostname or domain (for example, myhost.mycompany.com to identify a specific host or *mycompany.com to identify all hosts on that domain).
    
    Guest OS: In the Name box, type the exact name of the operating system or a pattern to identify an operating system group (for example, Microsoft* to identify any virtual machine that has a version of the Windows operating system).
    
    Host: In the Name box, type the host name, the IP address of the host, or a host name pattern using wildcards. When you add a host, all virtual machines on the host are included in the backup.
    
    Notes: In the Name box, type a pattern to identify virtual machines based on notes text contained in annotations for the VM summary (for example, Test* to identify VMs with a note that begins with "Test").
    
    Power state: From the Name list, select the power on status of virtual machines to be included in the VM group content. You can select On to identify VMs that are powered on, Off to identify VMs that are powered off, or Other to identify VMs with a different power on status, such as Suspended.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
  - Nutanix AHV:
    
    Power state: From the Name list, select the power on status of virtual machines to be included in the VM group content. You can select On to identify VMs that are powered on, Off to identify VMs that are powered off, or Other to identify VMs with a different power on status, such as Suspended.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
  - OpenStack:
    
    Instance name/pattern: In the Name box, type the display name of the instance or a pattern using wildcards (for example, Test* to identify instances for which the instance name begins with "Test").
    
    Power state: From the Name list, select the power on status of instances to be included in the VM group content. You can select On to identify instances that are powered on, Off to identify instances that are powered off, or Other to identify instances with a different power on status, such as Suspended.
  - Oracle Cloud Classic:
    
    Instance name/pattern: In the Name box, type the display name of the instance or a pattern using wildcards (for example, Test* to identify instances for which the instance name begins with "Test").
    
    User: Enter a name or pattern to identify a user, or browse to select a user.
  - Oracle Cloud Infrastructure:
    
    Compartment: In the Name box, type the name of a compartment.
    
    Instance name/pattern: In the Name box, type the display name of the instance or a pattern using wildcards (for example, Test* to identify instances for which the instance name begins with "Test").
  - Oracle VM:
    
    Repository: In the Name box, type the name of a repository.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
    
    Server: In the Name box, type the name of a server.
    
    Server folder: In the Name box, type the name of a server folder.
    
    Server pool: In the Name box, type the name of a server pool.
    
    Server pool folder: In the Name box, type the name of a server pool folder.
    
    Virtual machine folder: In the Name box, type the name of a virtual machine folder.
  - Red Hat OpenShift:
    
    Application name/pattern: In the Name box, type the display name of the application or a pattern using wildcards (for example, Test* to identify applications for which the application name begins with "Test").
  - Red Hat Virtualization:
    
    Guest DNS hostname: In the Name box, type a hostname or a pattern to identify a hostname or domain (for example, myhost.mycompany.com to identify a specific host or *mycompany.com to identify all hosts on that domain).
    
    Guest OS: In the Name box, type the exact name of the operating system or a pattern to identify an operating system group (for example, Microsoft* to identify any virtual machine that has a version of the Windows operating system).
    
    Host: In the Name box, type the host name, the IP address of the host, or a host name pattern using wildcards. When you add a host, all virtual machines on the host are included in the backup.
    
    Power state: From the Name list, select the power on status of virtual machines to be included in the VM group content. You can select On to identify VMs that are powered on, Off to identify VMs that are powered off, or Other to identify VMs with a different power on status, such as Suspended.
    
    Tag: In the Name box, type the name of a tag.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
  - vCloud Director:
    
    Organization: Enter the name of an organization.
    
    Storage Policy: Enter the name of a storage policy to select virtual machines that use the specified storage policy.
    
    vApp: Enter the name of a vApp.
    
    VDC: Enter the name of a vDC.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
  - VMware:
    
    Custom attribute: Enter a pattern to identify virtual machines based on custom attributes in vCenter annotations for the VM summary. You can enter search values for the names and values of custom attributes. For example:
    
    Entering Name Contains *resize* identifes VMs where the name of a custom attribute contains the word "resize").
    
    Entering Value Contains *128* identifies VMs where the value of a custom attribute contains the number "128").
    
    Datastore: In the Name box, type a datastore name or pattern.
    
    Guest DNS hostname: In the Name box, type a hostname or a pattern to identify a hostname or domain (for example, myhost.mycompany.com to identify a specific host or *mycompany.com to identify all hosts on that domain).
    
    Guest OS: In the Name box, type the exact name of the operating system or a pattern to identify an operating system group (for example, Microsoft* to identify any virtual machine that has a version of the Windows operating system).
    
    Host: In the Name box, type the host name, the IP address of the host, or a host name pattern using wildcards. When you add a host, all virtual machines on the host are included in the backup.
    
    Notes: In the Name box, type a pattern to identify virtual machines based on notes text contained in annotations for the VM summary (for example, Test* to identify VMs with a note that begins with "Test").
    
    Power state: From the Name list, select the power on status of virtual machines to be included in the VM group content. You can select On to identify VMs that are powered on, Off to identify VMs that are powered off, or Other to identify VMs with a different power on status, such as Suspended.
    
    Tag: Enter a tag to identify all virtual machines under VMware entities that are marked with that tag.
    
    Tag category: Enter a tag category to identify all virtual machines under VMware entities that are marked with that category.
    
    Template: From the Name list, select True to include templates or False to not include templates.
    
    Virtual machine name/pattern: In the Name box, type the display name of the virtual machine or a pattern using wildcards (for example, Test* to identify VMs for which the VM name begins with "Test").
3. From the Which matches with list, select Equals, Contains, Starts with, or Ends with.
4. In the Name box, provide a value as required for the type of rule.
5. Click OK.
To edit a rule, click in the Actions column of the row for the VM and select Edit rule.
Click Preview to see a list of the virtual machines that will be backed up and the hosts for the VMs.
Click OK to save the changes to VM group content.