Provided by: pacemaker_1.1.6-2ubuntu3_amd64 bug

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 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)

       -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:
       -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