CLUSTER Command

Article
08/31/2009

AC CLUSTER provides the ability to manage a cluster. This includes:

Creating a cluster.
Disbanding a cluster.
Changing the cluster controller.
Adding or removing a cluster member.
Listing cluster members.
Listing the network adapters on a given computer.
Cleaning a computer of all Application Center cluster settings.

Usage

Bb687324.note(en-us,TechNet.10).gif Note Different usages are shown for the /CREATE, /ADD, and /REMOVE options. Following each option are instructions on how to use the option.

AC CLUSTER   /CREATE
             [/CONTROLLER:controller_name]
             [/USER:username /PASSWORD:password]
             /NAME:cluster_name
             [/DESCRIPTION:cluster_desc]
             /TYPE:web | complusrouting
             /LOADBALANCING:nlb
             /CLUSTERIP:cluster_ip
             /CLUSTERIPSUBNETMASK:ip_subnetmask
             [/DEDICATEDIP:dedicated_ip
             /DEDICATEDIPSUBNETMASK:ded_subnetmask]
             [/AFFINITY:single | class_C | none]
             /LBNIC:nic_id
             /MANAGEMENTNIC:nic_id

Use the preceding set of options for a Web or COM+ routing cluster with NLB with a clean install.

AC CLUSTER   /CREATE
             [/CONTROLLER:controller_name]
             [/USER:username /PASSWORD:password]
             /NAME:cluster_name
             [/DESCRIPTION:cluster_desc]
             /TYPE:web | complusrouting
             /LOADBALANCING:nlb
             /KEEPNLBSETTINGS
             /MANAGEMENTNIC:nic_id

Use the preceding set of options for a Web or COM+ routing cluster with NLB when upgrading NLB.

AC CLUSTER   /CREATE 
             [/CONTROLLER:controller_name]
             [/USER:username /PASSWORD:password]
             /NAME:cluster_name
             [/DESCRIPTION:cluster_desc]
             /TYPE:web | complusrouting
             /LOADBALANCING:other
             [/LBNIC:nic_id]
             /MANAGEMENTNIC:nic_id

Use the preceding set of options for a Web or COM+ routing cluster when using a load-balancing method other than NLB.

AC CLUSTER   /CREATE 
             [/CONTROLLER:controller_name]
             [/USER:username /PASSWORD:password]
             /NAME:cluster_name
             [/DESCRIPTION:cluster_desc]
             /TYPE:web | complusrouting
             /LOADBALANCING:none
             /MANAGEMENTNIC:nic_id

Use the preceding set of options for a Web or COM+ routing cluster with no load balancing.

AC CLUSTER   /CREATE 
             [/CONTROLLER:controller_name]
             [/USER:username /PASSWORD:password]
             /NAME:cluster_name
             [/DESCRIPTION:cluster_desc]
             /TYPE:complusapp
             /LOADBALANCING:clb
             /MANAGEMENTNIC:nic_id

Use the preceding set of options for a COM+ application cluster when using CLB.

AC CLUSTER   /CREATE 
             [/CONTROLLER:controller_name]
             [/USER:username /PASSWORD:password]
             /NAME:cluster_name
             [/DESCRIPTION:cluster_desc]
             /TYPE:complusapp
             /LOADBALANCING:nlb
             /CLUSTERIP:cluster_ip
             /CLUSTERIPSUBNETMASK:ip_subnetmask
             [/DEDICATEDIP:dedicated_ip 
             /DEDICATEDIPSUBNETMASK:ded_subnetmask]
             /LBNIC:nic_id
             /MANAGEMENTNIC:nic_id

Use the preceding set of options for a COM+ application cluster with NLB and a clean install.

AC CLUSTER   /DELETE
             /CONTROLLER:controller_name
             [/USER:username /PASSWORD:password]
     
AC CLUSTER   /ADD
             /CONTROLLER:controller_name
             [/MEMBER:member_name] 
             /USER:username /PASSWORD:password | *
             [/DEDICATEDIP:dedicated_ip
             /DEDICATEDIPSUBNETMASK:ded_subnetmask]
             [/NOSYNCONADD]
             [/DISABLELOADBALANCING]
             [/LBNIC:nic_id]
             /MANAGEMENTNIC:nic_id

Use the preceding set of options only when adding a new member to a cluster that is using NLB.

AC CLUSTER   /ADD
             /CONTROLLER:controller
             [/MEMBER:member_name] 
             /USER:username /PASSWORD:password | *
             [/NOSYNCONADD]
             [/DISABLELOADBALANCING]
             [/LBNIC:nic_id]
             /MANAGEMENTNIC:nic_id

Use the preceding set of options only when adding a new member to a cluster that is using CLB or a load-balancing method other than NLB.

AC CLUSTER   /ADD
             /CONTROLLER:controller_name
             [/MEMBER:member_name]
             /USER:username /PASSWORD:password | *
             [/NOSYNCONADD]
             [/DISABLELOADBALANCING]
             /MANAGEMENTNIC:nic_id

The preceding set of options apply only when adding a new member to a cluster with no load balancing.

AC CLUSTER   /REMOVE
             [/MEMBER:member_name]
             /USER:username /PASSWORD:password | *

AC CLUSTER   /REMOVE
             /MEMBER:member_name
             /CONTROLLER:controller_name
             /USER:username /PASSWORD:password | *

Use the preceding set of options to remove a cluster member that does not have Application Center installed or to remove a cluster member that cannot be reached.

           
AC CLUSTER   /SETCONTROLLER
             [/MEMBER:member_name]
             [/USER:username /PASSWORD:password | *] 
             [/FORCE]

AC CLUSTER   /CLEAN
             [/KEEPIPS]
        
AC CLUSTER   /LISTMEMBERS
             [/MEMBER:member_name]
             [/USER:username /PASSWORD:password | *]

AC CLUSTER   /LISTNICS
             [/COMPUTER:computer_name]
             [/USER:username /PASSWORD:password | *]

Parameters

Parameter	Description
/CREATE	Create a new cluster
/CONTROLLER:controller_name	Specifies the computer to be used as the cluster controller.
/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.
/NAME:cluster_name	Specifies a friendly name for the cluster that will be created.
/DESCRIPTION:cluster_desc	Provides a text description of the cluster.
/TYPE:web \| complusapp \| complusrouting	Specifies one of three cluster types to create: web: a Web cluster. complusrouting: a COM+ routing cluster. complusapp: a COM+ application cluster.
/LOADBALANCING:NLB \| clb \| other \| none	Specifies which type of load balancing to use for the cluster: nlb: Network Load Balancing. clb: Component Load Balancing, which is valid for a COM+ application cluster only. other: third-party load balancing. none: no load balancing supported.
/CLUSTERIP:cluster_ip	Specifies the cluster (shared or virtual) IP address. This parameter is valid only for NLB clusters.
/CLUSTERIPSUBNETMASK:ip_subnetmask	Specifies the subnet mask of the cluster IP address.
/DEDICATEDIP:dedicated_ip	Specifies the dedicated IP address of the cluster controller. This parameter is valid only for NLB clusters.
/DEDICATEDSUBNETMASK:ded_subnetmask	Specifies the dedicated subnet mask of the cluster controller. This parameter is valid only for NLB clusters.
/AFFINITY:single \| class_c \| none	Specifies the NLB affinity of the cluster. This parameter is valid only for NLB clusters.
/KEEPNLBSETTINGS	Indicates that an NLB upgrade should be performed and to maintain existing NLB settings. This is valid only if the load balancing type is NLB, the cluster type is not complusapp, and NLB is already being used on the computer on which the cluster is being created.
/MANAGEMENTNIC:nic_id	Specifies the instance number of the management network adapter to use on the computer. This identifier can be obtained by executing the command AC CLUSTER /LISTNICS.
/LBNIC:nic_id	Specifies the instance number of the load balancing network adapter to use on the computer. This identifier can be obtained by using /LISTNICS.
/DELETE	Disband a cluster.
/ADD	Adds the given computer to the cluster. Once the computer is added to the cluster it will be synchronized with the cluster controller unless /NOSYNCONADD is specified. Note that a different set of options applies depending on whether you are adding a member to an NLB cluster or a non-NLB cluster.
/MEMBER:member_name	Specifies a cluster member. If omitted, the local computer is assumed.
/NOSYNCONADD	Specifies that once a member is added to a cluster, it should not be synchronized with the controller.
/DISABLELOADBALANCING	Specifies that the newly added member should not be set online once it is added to the cluster.
/REMOVE	Specifies that a member should be removed from the cluster it currently belongs to. Note Two sets of syntax are shown for use with /REMOVE. Use the second set to remove a cluster member that does not have Application Center installed. You can also use the second set of syntax to remove a member that cannot be reached; in that case, the message "Some settings in the member could not be removed" may be displayed. Use AC CLUSTER /CLEAN to remove these settings from the removed member.
/FORCE	Specifies that a controller change should be forced even if the existing controller is not available. This flag must be used in conjunction with /SETCONTROLLER.
/SETCONTROLLER	Specifies that the member identified by /MEMBER should be promoted to cluster controller for the cluster to which it currently belongs.
/CLEAN	Specifies that all cluster information should be removed from the local computer. Use this option on computers that are no longer part of a cluster. If the computer on which you want to use /CLEAN is part of cluster, first use AC CLUSTER /REMOVE to remove the member from the cluster. You can also use this command to remove a cluster member while the controller is unavailable. The parameter is available locally only and cannot be executed remotely. This parameter requires execution confirmation.
/KEEPIPS	Indicates that when cleaning a computer the cluster IP addresses should not be removed. You can only use this parameter with NLB clusters. Use this parameter only on the cluster controller (when it is the last member in the cluster) or it may result in IP address conflicts.
/LISTMEMBERS	Displays a list of all cluster members in the cluster containing the specified member. When you execute the AC CLUSTER command with /LISTMEMBERS, you receive the following output: Server name. Online status, which can be online, offline, or UNKNOWN. Drain status, which can be draining, blank (if the server is not draining), or UNKNOWN. Alive status, which can be alive, dead, or UNKNOWN. Synchronization status, which can be replicating, blank (if synchronization is not taking place on the computer), or UNKNOWN. Member status, which can be controller, blank (if the computer is a member rather than a controller), or UNKNOWN. Column headings are not shown in the output. If there are any ambiguities (because of blank or UNKNOWN values), use the order specified in the preceding list to ascertain which status values correspond to which properties.
/LISTNICS	Displays a list of all network adapters on the computer that can be used for load balancing or management traffic. Note The following sample output identifies, in bold type, the location of the network adapter id: Network adapters on <machine> 0: [00000000] <description> 1: [00000001] <description>
/COMPUTER:computer_name	Specifies a computer name to use for listing network adapter information. If this parameter is omitted, the local computer is used.

Samples

The following example illustrates the process of setting machine1 as the new controller of an existing cluster.

AC CLUSTER /SETCONTROLLER /MEMBER:machine1

For more information about cluster creation, see Cluster Creation Process.
For more information about performing basic administrative tasks on Application Center clusters, see Cluster Management Fundamentals.
For more information about command-line basics, see Using the Command-Line Tool.

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

CLUSTER Command

Usage

Parameters

Samples

Related Topics

Additional resources