Digimer: /* status */

2012-09-26T03:31:58Z

status

@@ Line 836: / Line 836: @@
 OFFLINE: [ an-node02.alteeve.com ]
 </source>
 {{footer}}

Digimer: /* cib > delete */

2011-07-11T03:52:27Z

cib > delete

← Older revision		Revision as of 03:52, 11 July 2011
Line 49:		Line 49:
	Delete a shadow CIB		Delete a shadow CIB

			<source lang="text">
	usage: delete <shadow_cib>		usage: delete <shadow_cib>
			</source>

			Example; Delete a shadow CIB called <span class="code">stonith</span>.

			<source lang="text">
			cib delete stonith
			</source>
			<source lang="text">
			INFO: stonith shadow CIB deleted
			</source>

	=== cib > reset ===		=== cib > reset ===

Digimer: /* cib > new */

2011-07-11T03:15:40Z

cib > new

← Older revision		Revision as of 03:15, 11 July 2011
Line 36:		Line 36:
	</source>		</source>

	Example; Create a shadow CIB called <span class="code">~~status~~</span>:		Example; Create a shadow CIB called <span class="code">stonith</span>:

	<source lang="text">		<source lang="text">
	cib new ~~status~~		cib new stonith
	</source>		</source>
	<source lang="text">		<source lang="text">
	INFO: ~~status~~ shadow CIB created		INFO: stonith shadow CIB created
	</source>		</source>

Digimer: /* cib > new */

2011-07-11T03:07:50Z

cib > new

← Older revision		Revision as of 03:07, 11 July 2011
Line 32:		Line 32:
	Create a new shadow CIB.		Create a new shadow CIB.

			<source lang="text">
	usage: new <shadow_cib> [withstatus] [force] [empty]		usage: new <shadow_cib> [withstatus] [force] [empty]
			</source>

			Example; Create a shadow CIB called <span class="code">status</span>:

			<source lang="text">
			cib new status
			</source>
			<source lang="text">
			INFO: status shadow CIB created
			</source>

	=== cib > delete ===		=== cib > delete ===

Digimer at 01:05, 11 July 2011

2011-07-11T01:05:40Z

Show changes

Digimer at 06:22, 10 July 2011

2011-07-10T06:22:35Z

Show changes

Digimer: /* configure */

2011-07-10T00:46:40Z

configure

← Older revision		Revision as of 00:46, 10 July 2011
Line 482:		Line 482:
	=== cibstatus ===		=== cibstatus ===

	~~CIB status management and editing~~		Same menu as [[#cib > cibstatus]] off the root of the shell.

	=== template ===		=== template ===

Digimer: Created page with "{{howto_header}} This aims to be a complete guide to using Pacemaker's crm cluster resource manager tool. = crm = The crm
2011-07-09T23:45:41Z

Created page with "{{howto_header}} This aims to be a complete guide to using Pacemaker's crm cluster resource manager tool. = crm = The crm</spa..."

Páàjì titun
{{howto_header}}

This aims to be a complete guide to using [[Pacemaker]]'s crm cluster resource manager tool.

= crm =

The crm command is the main method of invoking the cluster resource manager.

* Called without arguments, it invokes the crm shell.
* Called with arguments, it acts as a "one-shot" operation, executing all commands following it.
* Called with crm -f /path/to/file, it will read the file and execute all commands found within.
* Called with crm -, [[STDIN]] is read for arguments.

= The crm Shell =

The crm shell acts as an interactive shell, allowing for the cluster to be manipulated in real-time.

All commands can be entered in a hierarchical manner. Simply enter a command and press <enter> to decent into that sub-command's menu. To return, type end, cd or up.

At any level, you can type help to get a list of arguments that are valid at the given level you are in.

At any time, you can type quit, bye or exit to leave the shell.

All commands listed in the rest of this document can be entered at the command line as a "one-shot" command. Likewise, a combination of command sequences can be saved in a file and the read into crm.

== cib ==

Manage shadow CIBs

=== new ===

Create a new shadow CIB.

usage: new <shadow_cib> [withstatus] [force] [empty]

=== delete ===

Delete a shadow CIB

usage: delete <shadow_cib>

=== reset ===

Copy live cib to a shadow CIB

usage: reset <shadow_cib>

=== commit ===

Copy a shadow CIB to the cluster

usage: commit <shadow_cib>

=== use ===

Change working CIB

=== diff ===

diff between the shadow CIB and the live CIB

=== list ===

list all shadow CIBs

=== import ===

import a CIB or PE input file to a shadow

usage: import {<file>|<number>} [<shadow>]

=== cibstatus ===

CIB status management and editing

==== load ====

load the CIB status section

usage: load {<file>|shadow:<cib>|live}

==== save ====

save the CIB status section

==== origin ====

display origin of the CIB status section

==== show ====

show CIB status section

This shows the raw [[XML]].

==== node ====

change node status

usage: node <node> {online|offline|unclean}

==== op ====

edit outcome of a resource operation

usage: op <operation> <resource> <exit_code> [<op_status>] [<node>]

==== quorum ====

set the quorum

usage: quorum <bool>

==== run ====

run policy engine

Also(?) displays the cluster status.

==== simulate ====

simulate cluster transition

Also(?) displays the cluster status.

== resource ==

Resources management

=== status ===

show status of resources

=== start ===

start a resource

usage: start <rsc>

=== stop ===

stop a resource

usage: stop <rsc>

=== restart ===

restart a resource

usage: restart <rsc>

=== promote ===

promote a master-slave resource

usage: promote <rsc>

=== demote ===

demote a master-slave resource

usage: demote <rsc>

=== manage ===

put a resource into managed mode

usage: manage <rsc>

=== unmanage ===

put a resource into unmanaged mode

usage: unmanage <rsc>

=== migrate ===

migrate a resource to another node

usage: migrate <rsc> [<node>] [<lifetime>] [force]

=== unmigrate ===

unmigrate a resource to another node

usage: unmigrate <rsc>

=== param ===

manage a parameter of a resource

<source lang="text">
usage:
param <rsc> set <param> <value>
param <rsc> delete <param>
param <rsc> show <param>
</source>

=== meta ===

manage a meta attribute

<source lang="text">
usage:
meta <rsc> set <attr> <value>
meta <rsc> delete <attr>
meta <rsc> show <attr>
</source>

=== utilization ===

manage a utilization attribute

<source lang="text">
usage:
utilization <rsc> set <attr> <value>
utilization <rsc> delete <attr>
utilization <rsc> show <attr>
</source>

=== failcount ===

manage failcounts

<source lang="text">
usage:
failcount <rsc> set <node> <value>
failcount <rsc> delete <node>
failcount <rsc> show <node>
</source>

=== cleanup ===

cleanup resource status

usage: cleanup <rsc> [<node>]

=== refresh ===

refresh CIB from the LRM status

=== reprobe ===

probe for resources not started by the CRM

== configure ==

CRM cluster configuration

=== node ===

define a cluster node

<source lang="text">
usage: node <uname>[:<type>]
[attributes <param>=<value> [<param>=<value>...]]
[utilization <param>=<value> [<param>=<value>...]]
</source>

=== primitive ===

define a resource

<source lang="text">
usage: primitive <rsc> [<class>:[<provider>:]]<type>
[params <param>=<value> [<param>=<value>...]]
[meta <attribute>=<value> [<attribute>=<value>...]]
[utilization <attribute>=<value> [<attribute>=<value>...]]
[operations id_spec
[op op_type [<attribute>=<value>...] ...]]
</source>

=== monitor ===

add monitor operation to a primitive

<source lang="text">
usage: monitor <rsc>[:<role>] <interval>[:<timeout>]
</source>

=== group ===

define a group

<source lang="text">
usage: group <name> <rsc> [<rsc>...]
[params <param>=<value> [<param>=<value>...]]
[meta <attribute>=<value> [<attribute>=<value>...]]
</source>

=== clone ===

define a clone

<source lang="text">
usage: clone <name> <rsc>
[params <param>=<value> [<param>=<value>...]]
[meta <attribute>=<value> [<attribute>=<value>...]]
</source>

=== ms ===

define a master-slave resource

<source lang="text">
usage: ms <name> <rsc>
[params <param>=<value> [<param>=<value>...]]
[meta <attribute>=<value> [<attribute>=<value>...]]
</source>

=== location ===

a location preference

<source lang="text">
usage: location <id> <rsc> {node_pref|rules}

node_pref :: <score>: <node>

rules ::
rule [id_spec] [$role=<role>] <score>: <expression>
[rule [id_spec] [$role=<role>] <score>: <expression> ...]

id_spec :: $id=<id> | $id-ref=<id>
score :: <number> | <attribute> | [-]inf
expression :: <simple_exp> [bool_op <simple_exp> ...]
bool_op :: or | and
simple_exp :: <attribute> [type:]<binary_op> <value>
| <unary_op> <attribute>
| date <date_expr>
type :: string | version | number
binary_op :: lt | gt | lte | gte | eq | ne
unary_op :: defined | not_defined
</source>

=== colocation ===

colocate resources

<source lang="text">
usage: colocation <id> <score>: <rsc>[:<role>] <rsc>[:<role>]
</source>

=== order ===

order resources

<source lang="text">
usage: order <id> score-type: <first-rsc>[:<action>] <then-rsc>[:<action>]
[symmetrical=<bool>]
</source>

=== property ===

set a cluster property

<source lang="text">
usage: property [$id=<set_id>] <option>=<value>
</source>

=== rsc_defaults ===

set resource defaults

<source lang="text">
usage: rsc_defaults [$id=<set_id>] <option>=<value>
</source>

=== role ===

define role access rights

<source lang="text">
role <role-id> rule [rule ...]

rule :: acl-right cib-spec [attribute:<attribute>]

acl-right :: read | write | deny

cib-spec :: xpath-spec | tag-ref-spec
xpath-spec :: xpath:<xpath> | shortcut
tag-ref-spec :: tag:<tag> | ref:<id> | tag:<tag> ref:<id>

shortcut :: meta:<rsc>[:<attr>]
params:<rsc>[:<attr>]
utilization:<rsc>
location:<rsc>
property[:<attr>]
node[:<node>]
nodeattr[:<attr>]
nodeutil[:<node>]
status
</source>

=== user ===

define user access rights

<source lang="text">
user <uid> {roles|rules}

roles :: role:<role-ref> [role:<role-ref> ...]
rules :: rule [rule ...]

(See the role command for details on rules.)
</source>

=== op_defaults ===

set resource operations defaults

<source lang="text">
usage: op_defaults [$id=<set_id>] <option>=<value>
</source>

=== show ===

display CIB objects

Shows the current cluster configuration.

=== edit ===

edit CIB objects

This opens an editor (vim?) with the current CIB objects.

=== filter ===

filter CIB objects

<source lang="text">
usage: filter <prog> [xml] [<id>...]
</source>

=== delete ===

delete CIB objects

<source lang="text">
usage: delete <id> [<id>...]
</source>

=== default-timeouts ===

set timeouts for operations to minimums from the meta-data

<source lang="text">
usage: default-timeouts <id> [<id>...]
</source>

=== rename ===

rename a CIB object

<source lang="text">
usage: rename <old_id> <new_id>
</source>

=== refresh ===

refresh from CIB

This will reload the old CIB, causing any uncommitted changes to be lost.

=== erase ===

erase the CIB

This wipes out all CIB objects, leaving only the bare node definitions. If used accidentally, use refresh to restore the current CIB configuration.

=== ptest ===

show cluster actions if changes were committed

INFO: install graphviz to see a transition graph

=== cib ===

Same menu as [[#cib]] off the root of the shell.

=== cibstatus ===

CIB status management and editing

=== template ===

edit and import a configuration from a template

=== commit ===

commit the changes to the CIB

=== verify ===

verify the CIB with crm_verify

=== upgrade ===

upgrade the CIB to version 1.0

=== save ===

save the CIB to a file

=== load ===

import the CIB from a file

=== xml ===

raw xml

== node ==

Nodes management

== options ==

User preferences

== ra ==

Resource agents information center

== status ==

Show cluster status

{{footer}}

Using crm - Revision history

Digimer: /* status */

Digimer: /* cib > delete */

Digimer: /* cib > new */

Digimer: /* cib > new */

Digimer at 01:05, 11 July 2011

Digimer at 06:22, 10 July 2011

Digimer: /* configure */