22.4 Adding Resource Name Search Values

To help identify the active node in a Windows failover cluster, PlateSpin Migrate must differentiate the name of the shared Cluster IP Address resource from the names of other IP address resources on the cluster. The shared Cluster IP Address resource resides on the cluster’s active node.

The global parameter MicrosoftClusterIPAddressNames on the PlateSpin Server Configuration page contains a list of search values to use in discovery for a Windows cluster workload. When you add a Windows cluster workload, you must specify the IP address of the cluster’s currently active node. PlateSpin Migrate searches the names of the cluster’s IP address resources on that node to find one that starts with the specified characters of any value in the list. Thus, each search value must contain enough characters to differentiate the shared Cluster IP Address resource on a specific cluster, but it can be short enough to apply to discovery in other Windows clusters.

For example, a search value of Clust IP Address or Clust IP matches the resource names Clust IP Address for 10.10.10.201 and Clust IP Address for 10.10.10.101.

The default name for the shared Cluster IP Address resource is Cluster IP Address in English, or the equivalent if the cluster node is configured in another language. The default search values in the MicrosoftClusterIPAddressNames list include the resource name Cluster IP Address in English and examples of Microsoft translations of that name in other languages. Ensure that you use the Microsoft translation of the phrase for the language configured on your cluster.

Because the resource name of the shared Cluster IP Address resource is user-configurable, you must add other search values to the list, as needed. If you change the resource name, you must add a related search value to the MicrosoftClusterIPAddressNames list. For example, if you specify a resource name of Win2012-CLUS10-IP-ADDRESS, you should add that value to the list. If you have multiple clusters using the same naming convention, an entry of Win2012-CLUS matches any resource name that starts with that sequence of characters.

To add search values in the MicrosoftClusterIPAddressNames list:

  1. Log in as Administrator to the PlateSpin Migrate Web Interface, then open the PlateSpin Server Configuration page at:

    https://Your_PlateSpin_Server/PlateSpinConfiguration/

    Replace Your_PlateSpin_Server with the DNS host name or IP address of your PlateSpin Migrate Server.

  2. Search for MicrosoftClusterIPAddressNames, then click Edit.

  3. In the Value field, add one or more search values to the list.

  4. Click Save.