Linux Certif

Toute la documentation sur la certification Linux LPI

crm_resource

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