crm_resource

Langue: en

Autres versions - même langue

Version: October 2010 (fedora - 01/12/10)

Section: 8 (Commandes administrateur)

NAME

Pacemaker - Part of the Pacemaker cluster resource manager

SYNOPSIS

crm_resource (query|command) [options]

DESCRIPTION

crm_resource - Perform tasks related to cluster resources.
Allows resources to be queried (definition and location), modified, and moved around the cluster.

OPTIONS

-?, --help
This text
-$, --version
Version information
-V, --verbose
Increase debug output
-Q, --quiet
Print only the value on stdout
-r, --resource=value
Resource ID

Queries:

-L, --list
List all resources
-l, --list-raw
List the IDs of all instansiated resources (no groups/clones/...)
-O, --list-operations
List active resource operations. Optionally filtered by resource (-r) and/or node (-N)
-o, --list-all-operations
List all resource operations. Optionally filtered by resource (-r) and/or node (-N)
-q, --query-xml
Query the definition of a resource
-W, --locate
Display the current location(s) of a resource
-A, --stack
Display the pre-requisits and depandants of a resource
-a, --constraints
Display the (co)location constraints that apply to a resource

Commands:

-p, --set-parameter=value
Set the named parameter for a resource. See also -m, --meta
-g, --get-parameter=value
Display the named parameter for a resource. See also -m, --meta
-d, --delete-parameter=value
Delete the named parameter for a resource. See also -m, --meta
-M, --move
Move a resource from its current location, optionally specifying a destination (-N) and/or a period for which it should take effect (-u) If -N is not specified, the cluster will force the resource to move by creating a rule for the current location and a score of -INFINITY NOTE: This will prevent the resource from running on this node until the constraint is removed with -U
-U, --un-move
Remove all constraints created by a move command

Advanced Commands:

-D, --delete
Delete a resource from the CIB
-F, --fail
Tell the cluster this resource has failed
-R, --refresh
(Advanced) Refresh the CIB from the LRM
-C, --cleanup
(Advanced) Delete a resource from the LRM
-P, --reprobe
(Advanced) Re-check for resources started outside of the CRM

Additional Options:

-N, --node=value
Host uname
-t, --resource-type=value
Resource type (primitive, clone, group, ...)
-v, --parameter-value=value
Value to use with -p, -g or -d
-u, --lifetime=value
Lifespan of migration constraints
-m, --meta
Modify a resource's configuration option rather than one which is passed to the resource agent script. For use with -p, -g, -d
-z, --utilization
Modify a resource's utilization attribute. For use with -p, -g, -d
-s, --set-name=value
(Advanced) ID of the instance_attributes object to change
-i, --nvpair=value
(Advanced) ID of the nvpair object to change/delete
-f, --force

EXAMPLES

List the configured resources:
# crm_resource --list

Display the current location of 'myResource':

# crm_resource --resource myResource --locate

Move 'myResource' to another machine:

# crm_resource --resource myResource --move

Move 'myResource' to a specific machine:

# crm_resource --resource myResource --move --node altNode

Allow (but not force) 'myResource' to move back to its original location:

# crm_resource --resource myResource --un-move

Tell the cluster that 'myResource' failed:

# crm_resource --resource myResource --fail

Stop a 'myResource' (and anything that depends on it):

# crm_resource --resource myResource --set-parameter target-role --meta --parameter-value Stopped

Tell the cluster not to manage 'myResource':

The cluster will not attempt to start or stop the resource under any circumstances. Useful when performing maintenance tasks on a resource.

# crm_resource --resource myResource --set-parameter is-managed --meta --parameter-value false

Erase the operation history of 'myResource' on 'aNode':

The cluster will 'forget' the existing resource state (including any errors) and attempt to recover the resource. Useful when a resource had failed permanently and has been repaired by an administrator.

# crm_resource --resource myResource --cleanup --node aNode

AUTHOR

Written by Andrew Beekhof

REPORTING BUGS

Report bugs to pacemaker@oss.clusterlabs.org