Windows 2000 Command Reference Main PageThe basic cluster group syntax is:
cluster [[/cluster:]cluster name] group group name /option
The cluster name is optional. If no option is specified, the default option is /status.
If the name of your cluster is also a cluster command or its abbreviation, such as cluster or group, use /cluster: to explicitly specify the cluster name. For a list of all the cluster commands, see Related Topics.
With /moveto, /online, and /offline, the option /wait[:timeout in seconds] specifies how long Cluster.exe waits before canceling the command if it does not successfully complete. If a time-out is not specified, Cluster.exe waits indefinitely or until the group state changes.
The following table describes the available cluster group options:
| Option | Use to... |
|---|---|
| /status | Display the status of a group (Online, Offline, or Partially Online). The group name is optional. If you do not provide a group name, status for all groups is displayed. |
| /create | Create a new group. |
| /delete | Delete a group. |
| /rename: new group name | Rename a group. |
| /move[to] [:node name] [/wait [:timeout in seconds]] | Move a group to another node |
| /online [:node name] [/wait [:timeout in seconds]] | Bring a group online. |
| /offline[:node name] [/wait [:timeout in seconds]] | Take a group offline. |
| /properties [property list] | View or set the group common properties. The group name is optional. Properties for all groups are displayed if group name is not provided. For more information on property lists, see Property lists |
| /privproperties [property list] | View or set the group private properties. The group name is optional. Private properties for all groups are displayed if you do not provide a group name. For more information on property lists, see Property lists |
| /listowners | Display a list of preferred owners |
| /setowners:node name[,node name...] | Specify a preferred owner. |
| /? or /help | Display cluster group syntax. |
For example, to move a group called Disk Group 1 on the OpsClus1 cluster from OpsNode1 to OpsNode2, type the following at the Windows 2000 command prompt:
cluster opsclust group "disk group 1" /moveto:opsnode2
The following table describes the common cluster group property names, their uses, and valid settings:
| Common property names | Use |
|---|---|
| Name | Name of the cluster group object. |
| Description | Describes a group. |
| PersistentState | Describes the last known persistent state of a group (1, (true) means online; 0 (false) means offline). |
| FailoverThreshold | Specifies the number of times the Cluster service attempts to fail over a group before it concludes that the group cannot be brought online anywhere in the cluster. |
| FailoverPeriod | Specifies the interval (in hours) over which the Cluster service attempts to fail over a group. |
| AutoFailbackType | Set to ClusterGroupPreventFailback (0) to prevent failback Set to ClusterGroupAllowFailback (1) to allow failback. |
| FailbackWindowStart | Specifies the start time (on a 24-clock) for failback of a group to its preferred node. These values must be between 0 (midnight) and 23 (11:00 p.m.) in local time. For immediate failback, set to -1. |
| FailbackWindowEnd | Specifies the end time (on a 24-hour clock) for failback of a group to its preferred node. These values must be between 0 (midnight) and 23 (11:00 p.m.) in local time. For immediate failback, set to -1. |
By default, there are no private properties for cluster group. Software vendors can add private properties to extend cluster functionality.