LOADBALANCE Command

AC LOADBALANCE allows you to manage load balancing for a cluster. This includes:

  • Enabling or disabling load balancing for a cluster member. When you enable load balancing for a cluster member the member is put online. When you disable load balancing for a cluster member the member is taken offline.

  • Setting NLB weights for a cluster member.

  • Draining connections.

  • Obtaining load-balancing status information.

Usage

AC LOADBALANCE  /ONLINE
                [/MEMBER:member_name]
                [/USER:username /PASSWORD:password]

AC LOADBALANCE  /ONLINE
                /MEMBERONLY
                
AC LOADBALANCE  /OFFLINE
                [/MEMBER:member_name]
                [/USER:username /PASSWORD:password]
                [/DRAIN:time]

AC LOADBALANCE  /OFFLINE  
                /MEMBERONLY
                [/DRAIN:time]
    
AC LOADBALANCE  /SETNLBWEIGHT:weight
                [/MEMBER:member_name]
                [/USER:username /PASSWORD:password]

AC LOADBALANCE  /STATUS [:All]
                [/MEMBER:member_name]
                [/USER:username /PASSWORD:password]

Parameters

Parameter

Description

/ONLINE

Enables load balancing for the specified cluster member. This does not affect the member's state if it is already in the enabled state. This functionality is available for NLB and CLB clusters only, by default.

/MEMBER:member_name

Specifies the cluster member on which to apply the specified action. If omitted, the local member is assumed.

/USER:username

Specifies the user name to use for authentication, which can be supplied as "domain\username".

/PASSWORD:password

Specifies the password to use for authentication.

/MEMBERONLY

Sets the server:

  • Online from a suspended state.

  • Offline to a suspended state.

Bb687322.note(en-us,TechNet.10).gif Note   When this parameter is used, the LOADBALANCE command must be executed locally. Specifying the /MEMBER parameter in addition to the /MEMBERONLY parameter will result in an error.

/OFFLINE

Disables loadbalancing for the specified cluster member. This does not affect the member's state if it is already in the disabled state. Connections will not be drained from the member unless the /DRAIN parameter is specified. This functionality is available for NLB and CLB clusters only, by default.

/DRAIN:time

Drains the specified cluster member of connections. The value given indicates, in minutes, the timeout value for draining connections. If you do not specify time, the default time specified in the cluster properties is used. If you specify zero, no draining will occur (the same effect as if /OFFLINE was specified without /DRAIN).

/SETNLBWEIGHT:weight

Sets the relative weight of an NLB cluster member. Valid values are from 0 through 100 (note that these values do not represent percentages). This functionality is available for NLB clusters only.

/STATUS

Provides load-balancing status information for the specified cluster member. If you specify [:All], status is provided for all cluster members. This functionality is available for NLB and CLB clusters only, by default.

Bb687322.note(en-us,TechNet.10).gif Note   If you are using a third party loadbalancing solution, see:

  • Knowledge Base article 281437: "How to Enable Online/Offline Setting with 3rd Party Load Balancers"

  • Chapter 13, "Third Party Load Balancer Support" in the Microsoft Application Center 2000 Resource Kit

Samples

The following example illustrates the process of setting the NLB weight of machine1 to 60.

AC LOADBALANCE /SETNLBWEIGHT:60 /MEMBER:machine1

The following example shows how you can retrieve status information for all cluster members from a remote computer. Additionally, the example shows how to provide a user name for authentication and request a prompt to enter a password:

AC LOADBALANCE /STATUS:All /MEMBER:machine1 /user:user1 /password:*

Did you find this information useful? Please send your suggestions and comments about the documentation to acdocs@microsoft.com.