Poster of Linux kernelThe best gift for a Linux geek
CRM_RESOURCE

CRM_RESOURCE

Section: Heartbeat 1.0.9 Administration Guide (8) Updated: $Date: 2006/08/31 11:53:00 $
Local index Up
 

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
COMMANDS
OPTIONS
EXAMPLES
FILES
SEE ALSO
NOTES
AUTHOR
CAVEATS
BUGS

This document was created by man2html, using the manual pages.
Time: 22:01:28 GMT, April 16, 2011