View Cluster Quorum NodeWeight Settings

  • Article

This topic describes how to view NodeWeight settings for each member node in a Windows Server Failover Clustering (WSFC) cluster. NodeWeight settings are used during quorum voting to support disaster recovery and multi-subnet scenarios for AlwaysOn Availability Groups and SQL Server Failover Cluster Instances.

  • Before you start:  Prerequisites, Security

  • To view quorum NodeWeight settings using: Transact-SQL, PowerShell, cluster.exe

Before You Start

Prerequisites

This feature is supported only in Windows Server 2008 or later versions.

Important

In order to use NodeWeight settings, the following hotfix must be applied to all servers in the WSFC cluster:

KB2494036: A hotfix is available to let you configure a cluster node that does not have quorum votes in Windows Server 2008 and in Windows Server 2008 R2

Tip

If this hotfix is not installed, the examples in this topic will return empty or NULL values for NodeWeight.

Security

The user must be a domain account that is member of the local Administrators group on each node of the WSFC cluster.

Using Transact-SQL

To view NodeWeight settings

  1. Connect to any SQL Server instance in the cluster.

  2. Query the [sys].[dm_hadr_cluster_members] view.

Example (Transact-SQL)

The following example queries a system view to return values for all of the nodes in that instance’s cluster.

SELECT  member_name, member_state_desc, number_of_quorum_votes
 FROM   sys.dm_hadr_cluster_members;

[Top]

Using Powershell

To view NodeWeight settings

  1. Start an elevated Windows PowerShell via Run as Administrator.

  2. Import the FailoverClusters module to enable cluster commandlets.

  3. Use the Get-ClusterNode object to return a collection of cluster node objects.

  4. Output the cluster node properties in a readable format.

Example (Powershell)

The following example output some of the node properties for the cluster called “Cluster001”.

Import-Module FailoverClusters

$cluster = "Cluster001"
$nodes = Get-ClusterNode -Cluster $cluster

$nodes | Format-Table -property NodeName, State, NodeWeight

[Top]

Using Cluster.exe

Note

The cluster.exe utility is deprecated in the Windows Server 2008 R2 release. Please use PowerShell with Failover Clustering for future development. The cluster.exe utility will be removed in the next release of Windows Server. For more information, see Mapping Cluster.exe Commands to Windows PowerShell Cmdlets for Failover Clusters.

To view NodeWeight settings

  1. Start an elevated Command Prompt via Run as Administrator.

  2. Use cluster.exe to return node status and NodeWeight values

Example (Cluster.exe)

The following example outputs some of the node properties for the cluster called “Cluster001”.

cluster.exe Cluster001 node /status /properties

[Top]

See Also

Reference

sys.dm_hadr_cluster_members (Transact-SQL)

Concepts

WSFC Quorum Modes and Voting Configuration (SQL Server)

Configure Cluster Quorum NodeWeight Settings

Other Resources

Failover Cluster Cmdlets in Windows PowerShell Listed by Task Focus