Using the "WLBS QUERY" Command to Determine the State of an WLBS/NLB Cluster (242242)



The information in this article applies to:

  • Microsoft Windows 2000 Advanced Server
  • Microsoft Windows NT Server, Enterprise Edition 4.0
  • Microsoft Windows NT Server, Enterprise Edition 4.0 SP4
  • Microsoft Windows NT Server, Enterprise Edition 4.0 SP5
  • Microsoft Windows NT Server, Enterprise Edition 4.0 SP6
  • Microsoft Windows NT Server, Enterprise Edition 4.0 SP6a

This article was previously published under Q242242

SUMMARY

The wlbs query command displays the current state of a Windows Load Balancing Service (WLBS)/Network Load Balancing (NLB) cluster. Additionally, it provides host priority information.

MORE INFORMATION

The WLBS/NLB control program (Wlbs.exe) provides several cluster control commands. The correct syntax is:

wlbs command [cluster [:host] [remote options] ]

One of these commands is the query command. This command displays the current state of the cluster. It also provides host priority information. Possible cluster states include:
  • Unknown: The responding host has not started load balancing operations or cannot determine the cluster's state.
  • Converging: The cluster is attempting to converge to a consistent state. Should nodes remain in this state for a prolonged period of time, it usually indicates a problem with cluster configuration parameters. Parameters for each node can be displayed using the wlbs display command (this must be run on each node). Printing the results of this command may assist in determining the problem. Also, checking the system logs on each node may provide clues to a problem with the cluster and/or node.
  • Draining: The cluster has converged, and the responding host is "draining" active connections prior to stopping load balancing operations.
    • Drain: A program that disables new traffic handling for the rule whose port range contains the specified port. All ports specified by the port rule are affected.
    • Drainstop: A tool that disables all new traffic handling on the specified hosts. The hosts then enter the draining mode to complete existing connections. While draining, hosts remain in the cluster and stop their cluster operations when there are no more active connections. You can terminate draining mode by explicitly stopping the cluster mode with the stop command or by restarting new traffic handling with the start command. To drain connections from a specific port, use the drain command.
  • Converged as DEFAULT: The cluster has converged, and the responding host is the current DEFAULT (the highest priority host without a drainstop command in progress. The DEFAULT host handles all traffic for all TCP/UDP ports not specifically defined by port rules.
  • Converged: The cluster has converged and the responding host is not the DEFAULT host.
A wlbs query command run on the DEFAULT host in a two-node cluster generates output similar to:

WLBS Cluster Control Utility V2.3. (c) 1997-99 Microsoft Corporation Host 1 converged as DEFAULT with the following host(s) as part of the cluster:1, 2

A wlbs query command run on another host in a two-node cluster generates output similar to:

WLBS Cluster Control Utility V2.3. (c) 1997-99 Microsoft Corporation Host 2 converged with the following host(s) as part of the cluster:1, 2

Using the wlbs query command can help focus troubleshooting steps on a WLBS/NLB cluster. If the result of a wlbs query command shows all cluster nodes converging, troubleshooting can probably continue in other areas.

REFERENCES

193599 Windows NT Load Balancing Service Cluster Fails to Converge

238219 How NLB Hosts Converge When Connected to a Layer 2 Switch


Modification Type:MajorLast Reviewed:12/3/2003
Keywords:kbClustering kbinfo kbNLB w2000mscs KB242242