Creating a Smart Client Group to Automatically Detect Physical Nodes for Microsoft Clusters

For Microsoft Clusters, you must create a cluster group client to protect all of the nodes of the cluster. To do so, you can create a smart-client group that will automatically detect the physical nodes of the cluster and add those nodes to the cluster group client.


  • This method of configuring a smart client group considers all of the valid cluster roles that are configured with valid cluster drives and client access points on the client side, in order to create individual GxClusPlugin services for each of the cluster roles.
  • Independent cluster drives that are currently available as storage will not be considered for cluster configuration.
  • If a valid cluster role has multiple cluster drives associated with it, then the first accessible associated cluster drive with a valid drive letter will be considered for the creation of the job results directory for that cluster role.

Before You Begin

  • Review the permissions required to create a smart client group. For more information, see Creating a Smart Client Computer Group.
  • Ensure that the physical nodes of the cluster are reachable from the CommServe host.
  • The Microsoft cluster must be associated with a shared cluster drive and a cluster virtual server.


  1. Create the smart client group and configure it to automatically detect the physical nodes of the cluster:
    1. From the CommCell Browser, right-click Client Computer Groups, and then click New Group.

      The Create New Client Group dialog box appears.

    2. In the Group Name box, type a name for the group, and in the Description box, type a brief description.

      For example, you can name the group Detect Microsoft Cluster Nodes.

    3. Click Automatic Association, and in the Rule Group section, select Client, equal to, and Physical Node of a Cluster.
    4. On the Additional Settings tab, click Add, and in the Add Additional Settings dialog box, provide the following details:
      1. In the Name box, enter bDetectClusters.
      2. In the Value box, enter 1.
      3. Click OK.
    5. Click OK.
  2. Determine whether you want to protect the active nodes of the cluster immediately, and do one of the following:
    • If you want to start running backups of the active node, log on to the active node and restart the Commvault services.

      After the restart, the cluster group client is created and the active node is associated with the new cluster group client.

    • If you do not plan to run backups of the active node immediately, no action is required. The cluster group client is created within 24 hours.

      After the client is created, the active node is associated with the new cluster group client.

  3. In the new, system-created cluster client group, configure the agents to include for data operations:
    1. In the CommCell Browser, expand Client Computers, right-click the system-created cluster client group (with the Client Access Point Name), and then click Properties.

      The Client Group Properties dialog box appears.

    2. Click Advanced.

      The Advanced Client Properties dialog box appears.

    3. On the Cluster Group Configuration tab, click the Agents tab.
    4. From the Available list, select the components based on your requirements, and then click Add. For example:
      • To perform IntelliSnap and block-level backups, select MediaAgent and VSS Hardware Provider.
      • For file system agents, select the File System.
      • For the SQL Server agent, select iDA for MSSQL Server.
    5. Click OK.
    6. In the Create New Client Group dialog box, click OK.

      The smart client group is successfully configured.

  4. Optional: To confirm that the cluster group client was created, look for the following event in the Event Viewer window:

    Cluster group [clustergroup] with hostname [clustergroup.mydomain.com] is automatically configured on node [clusternode] with shared disk path [D:\ClusterDisk2].

  5. To protect the passive nodes of the cluster, associate the passive nodes with the cluster group client manually:
    1. From the CommCell Browser, expand the Client Computers node, right-click the Cluster_Group_Client, and then click Properties.
    2. In the Client Computer Properties dialog box, click Advanced.
    3. On the Cluster Group Configuration tab of the Advanced Client Properties dialog box, select the passive nodes from the Available list, and then click Add > to move them to the Selected list.
    4. Click OK.

What to Do Next

Create a subclient to define the data that you want to backup. After a subclient is created and a storage policy is configured for this cluster group client, you can perform backup and recovery operations. For information about configuring a subclient, see Subclients for the Windows File System Agent.

Last modified: 2/28/2019 7:51:16 PM