CRM_RESOURCE(8) [FIXME: manual] CRM_RESOURCE(8)
NAME
crm_resource - interact with the Cluster Resource Manager
SYNOPSIS
crm_resource [-?|-V|-S] -L|-Q|-W|-D|-C|-P|-p [options]
DESCRIPTION
The crm_resource command performs various resource-related actions on the cluster. It can modify the definition of configured resources,
start and stop resources, and delete and migrate resources between nodes.
--help, -?
Print the help message.
--verbose, -V
Turn on debug information.
Note
Increase the level of verbosity by providing additional instances.
--quiet, -Q
Print only the value on stdout (for use with -W).
COMMANDS
--list, -L
List all resources.
--query-xml, -x
Query a resource.
Requires: -r
--locate, -W
Locate a resource.
Requires: -r
--migrate, -M
Migrate a resource from its current location.
Use -H to specify a destination.
If -H is not specified, the resource is forced to move by creating a rule for the current location and a score of -INFINITY.
Note
This prevents the resource from running on this node until the constraint is removed with -U.
Requires: -r, Optional: -H, -f
--un-migrate, -U
Remove all constraints created by -M
Requires: -r
--delete, -D
Delete a resource from the CIB.
Requires: -r, -t
--cleanup, -C
Delete a resource from the LRM.
Requires: -r. Optional: -H
--reprobe, -P
Recheck for resources started outside the CRM.
Optional: -H
--refresh, -R
Refresh the CIB from the LRM.
Optional: -H
--set-parameter string, -p string
Set the named parameter for a resource.
Requires: -r, -v. Optional: -i, -s
--get-parameter string, -g string
Get the named parameter for a resource.
Requires: -r. Optional: -i, -s
--delete-parameter string, -d string
Delete the named parameter for a resource.
Requires: -r. Optional: -i
--get-property string, -G string
Get the named property (such as class, type, or is_managed) of a resource.
Requires: -r
--set-property string, -S string
Set the named property (not parameter) for a resource.
Requires: -r, -t, -v
OPTIONS
--resource string, -r string
Specify the resource ID.
--resource-type string, -t string
Specify the resource type (primitive, clone, group, etc.).
--property-value string, -v string
Specify the property value.
--host-uname string, -H string
Specify the hostname.
--force-relocation, -f
Force the resource to move by creating a rule for the current location and a score of -INFINITY
This should be used if the resource's stickiness and constraint scores total more than INFINITY (currently 100,000).
Note
This prevents the resource from running on this node until the constraint is removed with -U.
-s string
(Advanced Use Only) Specify the ID of the instance_attributes object to change.
-i string
(Advanced Use Only) Specify the ID of the nvpair object to change or delete.
EXAMPLES
Listing all resources:
crm_resource -L
Checking where a resource is running (and if it is):
crm_resource -W -r my_first_ip
If the my_first_ip resource is running, the output of this command reveals the node on which it is running. If it is not running, the
output shows this.
Start or stop a resource:
crm_resource -r my_first_ip -p target_role -v started
crm_resource -r my_first_ip -p target_role -v stopped
Query the definition of a resource:
crm_resource -Q -r my_first_ip
Migrate a resource away from its current location:
crm_resource -M -r my_first_ip
Migrate a resource to a specific location:
crm_resource -M -r my_first_ip -H c001n02
Allow a resource to return to its normal location:
crm_resource -U -r my_first_ip
Note
The values of resource_stickiness and default_resource_stickiness may mean that it does not move back. In such cases, you should
use -M to move it back before running this command.
Delete a resource from the CRM:
crm_resource -D -r my_first_ip -t primitive
Delete a resource group from the CRM:
crm_resource -D -r my_first_group -t group
Disable resource management for a resource in the CRM:
crm_resource -p is_managed -r my_first_ip -t primitive -v off
Enable resource management for a resource in the CRM:
crm_resource -p is_managed -r my_first_ip -t primitive -v on
Reset a failed resource after having been manually cleaned up:
crm_resource -C -H c001n02 -r my_first_ip
Recheck all nodes for resources started outside the CRM:
crm_resource -P
Recheck one node for resources started outside the CRM:
crm_resource -P -H c001n02
FILES
/var/lib/heartbeat/crm/cib.xml--the CIB (minus status section) on disk. Editing this file directly is strongly discouraged.
SEE ALSO
???, ???, lrmadmin(8), heartbeat(8)
AUTHOR
crm_resource was written by Andrew Beekhof.
[FIXME: source] 07/05/2010 CRM_RESOURCE(8)