PACEMAKER(8) System Administration Utilities PACEMAKER(8)NAME
Pacemaker - Part of the Pacemaker cluster resource manager
SYNOPSIScrm_resource (query|command) [options]
DESCRIPTIONcrm_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 cluster resources
-l, --list-raw
List the IDs of all instantiated 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)
--list-standards
List supported standards
--list-ocf-providers
List all available OCF providers
--list-agents=value
List all agents available for the named standard and/or
provider.
--list-ocf-alternatives=value
List all available providers for the named OCF agent
--show-metadata=value
Show the metadata for the named class:provider:agent
-q, --query-xml
Query the definition of a resource (template expanded)
-w, --query-xml-raw
Query the definition of a resource (raw xml)
-W, --locate
Display the current location(s) of a resource
-A, --stack
Display the prerequisites and dependents of a resource
-a, --constraints
Display the (co)location constraints that apply to a resource
Commands:
-C, --cleanup
Delete the resource history and re-check the current state.
Optional: --resource
-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
Resource location:
-M, --move
Move a resource from its current location to the named destina‐
tion. Requires: --host. Optional: --lifetime, --master
NOTE: This may prevent the resource from running on the previous
location node until the implicit constraints expire or are
removed with --unban
-B, --ban
Prevent the named resource from running on the named --host.
Requires: --resource. Optional: --host, --lifetime, --master
If --host is not specified, it defaults to:
* the curent location for primitives and groups, or
* the curent location of the master for m/s resources with mas‐
ter-max=1
All other situations result in an error as there is no sane
default.
NOTE: This will prevent the resource from running on this node
until the constraint expires or is removed with --clear
-U, --clear
Remove all constraints created by the --ban and/or --move com‐
mands. Requires: --resource. Optional: --host, --master
If --host is not specified, all constraints created by --ban and
--move will be removed for the named resource.
-u, --lifetime=value
Lifespan of constraints created by the --ban and --move commands
--master
Limit the scope of the --ban, --move and --clear commands to
the Master role. For --ban and --move, the previous master can
still remain active in the Slave role.
Advanced Commands:
-D, --delete
(Advanced) Delete a resource from the CIB
-F, --fail
(Advanced) Tell the cluster this resource has failed
--force-stop
(Advanced) Bypass the cluster and stop a resource on the local
node. Additional detail with -V
--force-start
(Advanced) Bypass the cluster and start a resource on the local
node. Additional detail with -V
--force-check
(Advanced) Bypass the cluster and check the state of a resource
on the local node. Additional detail with -V
Additional Options:
-N, --node=value
Host uname
--recursive
Follow colocation chains when using --set-parameter
-t, --resource-type=value
Resource type (primitive, clone, group, ...)
-v, --parameter-value=value
Value to use with -p, -g or -d
-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
List the available OCF agents:
# crm_resource--list-agents ocf
List the available OCF agents from the linux-ha project:
# crm_resource--list-agents ocf:heartbeat
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 loca‐
tion:
# 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
Pacemaker 1.1.10-19.el7 November 2013 PACEMAKER(8)