Man Linux: Main Page and Category List

NAME

       crm_resource - Interact with the Cluster Resource Manager

SYNOPSIS

       crm_resource [-?VS] -(L|Q|W|D|C|P|p) [options]

DESCRIPTION

       crm_resource  allow  resources to be listed, started, stopped, migrated
       and so forth.

       --help, -?
               this help message

       --verbose, -V
               turn on debug info. additional instances increase verbosity

       --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 it current location.

               Use -H to specify a destination.  If -H is  not  specified,  we
               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

               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 of 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  (eg.  class,  type,  is_managed)  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
               Resource ID

       --resource-type string, -t string
               Resource type (primitive, clone, group, ...)

       --property-value string, -v string
               Property value

       --host-uname string, -H string
               Host name

       --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 10,000)

               NOTE: This will prevent the resource from running on this  node
               until the constraint is removed with -U

       -s string
               (Advanced  Use  Only)  ID  of the instance_attributes object to
               change

       -i string
               (Advanced Use Only) ID of the nvpair object to change/delete

EXAMPLES

       Listing all resources
              crm_resource -L

       Checking where a resource is running (and if it does)
              crm_resource -W -r my_first_ip

              resource my_first_ip is running on: server1

              crm_resource -W -r my_first_ip

              resource my_first_ip is NOT running

       Start/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

       Migrating a resource away from its current location
              crm_resource -M -r my_first_ip

       Migrating 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 doesnt move back.
              In such cases, you should use -M to move it back  and  then  run
              this command.

       Deleting a resource from the CR
              crm_resource -D -r my_first_ip -t primitive

       Deleting a resource group from the CRM
              crm_resource -D -r my_first_group -t group

       Disabling a resource management for a resource in the CRM
              crm_resource -p is_managed -r my_first_ip -t primitive -v off

       Enabling a resource management for a resource in the CRM
              crm_resource -p is_managed -r my_first_ip -t primitive -v on

       Resetting a failed resource after having been manually cleaned up
              crm_resource -C -H c001n02 -r my_first_ip

       Rechecking all nodes for resources started outside of the CRM
              crm_resource -P

       Rechecking one node for resources started outside of the CRM
              crm_resource -P -H c001n02

FILES

SEE ALSO

       cibadmin(8), crmadmin(8), lrmadmin(8), heartbeat(8)

NOTES

AUTHOR

       crm_resource was written by Andrew Beekhof.

       This  manual  page  was  originally  written by Gildas Le Nadan (Genome
       Research Limited, 2006).

CAVEATS

BUGS