Export (0) Print
Expand All
Expand Minimize

CLUSTER Command

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.

Bb687324.note(en-us,TechNet.10).gif 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.

Bb687324.note(en-us,TechNet.10).gif 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

Related Topics

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft