1PACEMAKER(8)            System Administration Utilities           PACEMAKER(8)
2
3
4

NAME

6       Pacemaker - Part of the Pacemaker cluster resource manager
7

SYNOPSIS

9       crm_resource (query|command) [options]
10

DESCRIPTION

12       crm_resource - Perform tasks related to cluster resources.
13
14              Allows  resources to be queried (definition and location), modi‐
15              fied, and moved around the cluster.
16

OPTIONS

18       -?, --help
19              This text
20
21       -$, --version
22              Version information
23
24       -V, --verbose
25              Increase debug output
26
27       -Q, --quiet
28              Print only the value on stdout
29
30       -r, --resource=value
31              Resource ID
32
33   Queries:
34       -L, --list
35              List all resources
36
37       -l, --list-raw
38              List   the   IDs   of    all    instantiated    resources    (no
39              groups/clones/...)
40
41       -O, --list-operations
42              List   active   resource  operations.   Optionally  filtered  by
43              resource (-r) and/or node (-N)
44
45       -o, --list-all-operations
46              List all resource operations.  Optionally filtered  by  resource
47              (-r) and/or node (-N)
48
49       -q, --query-xml
50              Query the definition of a resource (template expanded)
51
52       -w, --query-xml-raw
53              Query the definition of a resource (raw xml)
54
55       -W, --locate
56              Display the current location(s) of a resource
57
58       -A, --stack
59              Display the prerequisites and dependents of a resource
60
61       -a, --constraints
62              Display the (co)location constraints that apply to a resource
63
64   Commands:
65       -p, --set-parameter=value
66              Set the named parameter for a resource. See also -m, --meta
67
68       -g, --get-parameter=value
69              Display the named parameter for a resource. See also -m, --meta
70
71       -d, --delete-parameter=value
72              Delete the named parameter for a resource. See also -m, --meta
73
74       -M, --move
75              Move a resource from its current location, optionally specifying
76              a destination (-N) and/or a period  for  which  it  should  take
77              effect  (-u)  If -N is not specified, the cluster will force the
78              resource to move by creating a rule for the current location and
79              a  score  of -INFINITY NOTE: This will prevent the resource from
80              running on this node until the constraint is removed with -U
81
82       -U, --un-move
83              Remove all constraints created by a move command
84
85   Advanced Commands:
86       -D, --delete
87              Delete a resource from the CIB
88
89       -F, --fail
90              Tell the cluster this resource has failed
91
92       -R, --refresh
93              (Advanced) Refresh the CIB from the LRM
94
95       -C, --cleanup
96              (Advanced) Delete a resource from the LRM
97
98       -P, --reprobe
99              (Advanced) Re-check for resources started outside of the CRM
100
101   Additional Options:
102       -N, --node=value
103              Host uname
104
105       -t, --resource-type=value
106              Resource type (primitive, clone, group, ...)
107
108       -v, --parameter-value=value
109              Value to use with -p, -g or -d
110
111       -u, --lifetime=value
112              Lifespan of migration constraints
113
114       -m, --meta
115              Modify a resource's configuration option rather than  one  which
116              is passed to the resource agent script. For use with -p, -g, -d
117
118       -z, --utilization
119              Modify  a resource's utilization attribute. For use with -p, -g,
120              -d
121
122       -s, --set-name=value
123              (Advanced) ID of the instance_attributes object to change
124
125       -i, --nvpair=value
126              (Advanced) ID of the nvpair object to change/delete
127
128       -f, --force
129

EXAMPLES

131       List the configured resources:
132
133              # crm_resource --list
134
135       Display the current location of 'myResource':
136
137              # crm_resource --resource myResource --locate
138
139       Move 'myResource' to another machine:
140
141              # crm_resource --resource myResource --move
142
143       Move 'myResource' to a specific machine:
144
145              # crm_resource --resource myResource --move --node altNode
146
147       Allow (but not force) 'myResource' to move back to its  original  loca‐
148       tion:
149
150              # crm_resource --resource myResource --un-move
151
152       Tell the cluster that 'myResource' failed:
153
154              # crm_resource --resource myResource --fail
155
156       Stop a 'myResource' (and anything that depends on it):
157
158              # crm_resource --resource myResource --set-parameter target-role
159              --meta --parameter-value Stopped
160
161       Tell the cluster not to manage 'myResource':
162
163       The cluster will not attempt to start or stop the  resource  under  any
164       circumstances.  Useful when performing maintenance tasks on a resource.
165
166              #  crm_resource --resource myResource --set-parameter is-managed
167              --meta --parameter-value false
168
169       Erase the operation history of 'myResource' on 'aNode':
170
171       The cluster will 'forget' the existing resource  state  (including  any
172       errors)  and  attempt  to recover the resource.  Useful when a resource
173       had failed permanently and has been repaired by an administrator.
174
175              # crm_resource --resource myResource --cleanup --node aNode
176

AUTHOR

178       Written by Andrew Beekhof
179

REPORTING BUGS

181       Report bugs to pacemaker@oss.clusterlabs.org
182
183
184
185Pacemaker 1.1.6-1.fc14          September 2011                    PACEMAKER(8)