Modify Shared Directory Cluster Resources

Applies To: Windows Server 2008

Modifying shared directory cluster resources

  • Using the Windows interface

  • Using the command prompt

To modify a shared directory cluster resource using the Windows interface

  1. Open Cluster Administrator: click Start, point to Programs, point to Administrative Tools, and then click Cluster Administrator.

  2. In the console tree, double-click the Groups folder.

  3. In the details pane, double-click the group that contains the resource you want to modify, and then click the resource.

  4. On the File menu, click Take Offline.

  5. When the resource is offline, on the File menu, click Properties.

  6. Change the properties you want to modify, and then click OK.

  7. On the File menu, click Bring Online.

Additional references

To modify a shared directory cluster resource using the command prompt

  1. Open the command prompt with elevated privileges

    1. Click the Start button, and click All Programs.

    2. Click Accessories.

    3. Right-click the command prompt, and select Run as administrator.

  2. Type the following:

    **cluster [ClusterName] resource "ResourceName" /offline /wait[:**Timeout]

  3. Then, type:

    **cluster [ClusterName] resource "ResourceName" /**Option

  4. Then, type:

    cluster [ClusterName] resource "ResourceName" /online /wait[:Timeout]

    Argument Description

    ClusterName

    The name of the cluster you want to manage.

    ResourceName

    The name of the cluster resource.

    Timeout

    The number of seconds cluster waits before canceling the command if it does not successfully complete. If /wait is specified without this value, cluster waits five minutes or until the resource state changes.

Note

To view the complete syntax for this command, at a command prompt, type: cluster /?

Additional references

Cluster resource options

The following table describes the available cluster resource options.

Option Description

/status

Displays the status of a cluster resource (Online, Offline, or Failed). The resource name is optional. If you do not provide a resource name, the status of all cluster resources is displayed.

/create /group:group name/type:resource type[/separate]

Creates a new resource in a specified group. Use /separate to specify that the resource should run in a separate Resource Monitor.

/delete

Deletes a resource.

/rename:new resource name

Renames a resource.

/addowner:node name

Adds a node name to the list of possible owners.

/removeowner:node name

Removes a node name from the list of possible owners.

/listowners

Displays a list of possible owners.

/moveto:group

Moves the resource to a different group.

/properties [property list]

Views or sets the resource common properties. The resource name is optional. If you do not provide a resource name, properties for all resources are displayed.

/privproperties [property list]

Views or sets the resource private properties. Resource name is optional. If you do not provide a resource name, private properties for all resources are displayed.

/fail

Initiates resource failure.

/online [/wait[:timeout in seconds]]

Brings the resource online.

/offline [/wait[:timeout in seconds]]

Takes the resource offline.

/listdependencies

Lists the dependencies for a resource.

/adddependency:resource

Adds a dependency for a resource.

/removedependency:resource

Removes a dependency for a resource.

/addcheckpoints:key[\subkey...][,key[\subkey...]...]

Adds a registry checkpoint for a resource.

/removecheckpoints:key[\subkey...][,key[\subkey...]...]

Removes a registry checkpoint for a resource.

/checkpoints

Lists registry checkpoints for a resource. The resource name is optional. Checkpoints for all cluster resources are displayed if you do not provide a resource name.

/addcryptocheckpoints:key[\subkey...][,key[\subkey...]...]

Adds a cryptographic key checkpoint for a resource.

/removecryptocheckpoints:key[\subkey...][,key[\subkey...]...]

Removes a cryptographic key checkpoint for a resource.

/cryptocheckpoints

Lists cryptographic key checkpoints for a resource. The resource name is optional. If you do not provide a resource name, checkpoints for all cluster resources are displayed.

/? or /help

Displays cluster resource syntax.

Cluster resource common property names

The following table describes the common cluster resource property names, their uses, and valid settings.

Common property names Use

Description

Describes a resource.

Type

Specifies the resource type.

DebugPrefix

Specifies the appropriate debugger for the resource. For more information, see the Microsoft Platform Software Development Kit.

SeparateMonitor

Indicates whether a resource shares a Resource Monitor. Valid values are True (1) and False (0).

PersistentState

Describes the last known persistent state of a resource. In order to save the PersistentState property of the resource, the resource must be offline.

LooksAlivePollInterval

Recommended interval (in milliseconds) that the Cluster service polls a resource to determine whether it appears to be operational. If a value is not specified, a default value is taken from the LooksAlivePollInterval property for the resource type.

IsAlivePollInterval

Interval (in milliseconds) that the Cluster service polls a resource to determine whether it is operational. If a value is not specified, a default value is taken from the IsAlivePollInterval property for the specific resource type. IsAlivePollInterval cannot be zero.

RestartAction

Describes the action to perform if the resource fails. The choices are as follows:

ClusterResourceDontRestart (0): Do not restart following a failure.

ClusterResourceRestartNoNotify (1): If the resource exceeds its restart threshold within its restart period, the Cluster service does not attempt to failover the group to another node.

ClusterResourceRestartNotify (2): If the resource exceeds its restart threshold within its restart period, the Cluster service attempts to failover the group to another node.

If you do not enter a value, the default allows the resource to affect the group, which can cause the group to failover to another system.

RestartThreshold

Specifies how many times the Cluster service attempts to restart the resource in the RestartPeriod before failing over the group.

RestartPeriod

Specifies the amount of time allowed for the restart attempts to reach the RestartThreshold before the Cluster service fails over the group.

PendingTimeout

Specifies the amount of time that a Pending Online or Pending Offline resource has to resolve its status before the Cluster service puts the resource in Offline or Failed status.

The default value is three minutes.