crm_resource - Man Page

Show help options

Show all help options

Show output help

Show query help

Show command help

Show location help

Show advanced option help

Show additional options

Specify output format as one of: text (default), xml

Specify file name for output (or "-" for stdout)

List all cluster resources with status

List IDs of all instantiated resources (individual members rather than groups etc.)

List active resource operations, optionally filtered by --resource and/or --node

List all resource operations, optionally filtered by --resource and/or --node

List all available options of the given type. Allowed values: primitive (primitive resource meta-attributes), fencing (parameters common to all fencing resources)

List supported standards

List all available OCF providers

List all agents available for the named standard and/or provider

List all available providers for the named OCF agent

Show the metadata for the named class:provider:agent

Show XML configuration of resource (after any template expansion)

Show XML configuration of resource (before any template expansion)

Display named parameter for resource (use instance attribute unless --element, --meta, or --utilization is specified)

Show node(s) currently running resource

Display the location and colocation constraints that apply to a resource, and if --recursive is specified, to the resources directly or indirectly involved in those colocations. If the named resource is part of a group, or a clone or bundle instance, constraints for the collective resource will be shown unless --force is given.

Equivalent to --constraints --recursive

Show why resources are not running, optionally filtered by --resource and/or --node

Validate resource configuration by calling agent's validate-all action. The configuration may be specified either by giving an existing resource name with -r, or by specifying --class, --agent, and --provider arguments, along with any number of --option arguments. An optional LEVEL argument can be given to control the level of checking performed.

If resource has any past failures, clear its history and fail count. Optionally filtered by --resource, --node, --operation and --interval (otherwise all). --operation and --interval apply to fail counts, but entire history is always clear, to allow current state to be rechecked. If the named resource is part of a group, or one numbered instance of a clone or bundled resource, the clean-up applies to the whole collective resource unless --force is given.

Delete resource's history (including failures) so its current state is rechecked. Optionally filtered by --resource and --node (otherwise all). If the named resource is part of a group, or one numbered instance of a clone or bundled resource, the refresh applies to the whole collective resource unless --force is given.

Set named parameter for resource (requires -v). Use instance attribute unless --element, --meta, or --utilization is specified.

Delete named parameter for resource. Use instance attribute unless --element, --meta or, --utilization is specified.

Create a constraint to move resource. If --node is specified, the constraint will be to move to that node, otherwise it will be to ban the current node. Unless --force is specified this will return an error if the resource is already running on the specified node. If --force is specified, this will always ban the current node. Optional: --lifetime, --promoted. NOTE: This may prevent the resource from running on its previous location until the implicit constraint expires or is removed with --clear.

Create a constraint to keep resource off a node. Optional: --node, --lifetime, --promoted. NOTE: This will prevent the resource from running on the affected node until the implicit constraint expires or is removed with --clear. If --node is not specified, it defaults to the node currently running the resource for primitives and groups, or the promoted instance of promotable clones with promoted-max=1 (all other situations result in an error as there is no sane default).

Remove all constraints created by the --ban and/or --move commands. Requires: --resource. Optional: --node, --promoted, --expired. If --node is not specified, all constraints created by --ban and --move will be removed for the named resource. If --node and --force are specified, any constraint created by --move will be cleared, even if it is not for the specified node. If --expired is specified, only those constraints whose lifetimes have expired will be removed.

Modifies the --clear argument to remove constraints with expired lifetimes.

Lifespan (as ISO 8601 duration) of created constraints (with -B, -M) see https://en.wikipedia.org/wiki/ISO_8601#Durations)

Limit scope of command to promoted role (with -B, -M, -U). For -B and -M, previously promoted instances may remain active in the unpromoted role.

Deprecated: Use --promoted instead

(Advanced) Delete a resource from the CIB. Required: -t

(Advanced) Tell the cluster this resource has failed

(Advanced) Tell the cluster to restart this resource and anything that depends on it. This temporarily modifies the CIB, and other CIB modifications should be avoided while this is in progress. If a node is fenced because the stop portion of the restart fails, CIB modifications such as target-role may remain.

(Advanced) Wait until the cluster settles into a stable state

(Advanced) Show parameter hashes that Pacemaker uses to detect configuration changes (only accurate if there is resource history on the specified node). Required: --resource, --node. Optional: any NAME=VALUE parameters will be used to override the configuration (to see what the hash would be with those changes).

(Advanced) Bypass the cluster and demote a resource on the local node. Unless --force is specified, this will refuse to do so if the cluster believes the resource is a clone instance already running on the local node.

(Advanced) Bypass the cluster and stop a resource on the local node

(Advanced) Bypass the cluster and start a resource on the local node. Unless --force is specified, this will refuse to do so if the cluster believes the resource is a clone instance already running on the local node.

(Advanced) Bypass the cluster and promote a resource on the local node. Unless --force is specified, this will refuse to do so if the cluster believes the resource is a clone instance already running on the local node.

(Advanced) Bypass the cluster and check the state of a resource on the local node. An optional LEVEL argument can be given to control the level of checking performed.

Node name

Follow colocation chains when using --set-parameter or --constraints

Resource XML element (primitive, group, etc.) (with -D)

Value to use with -p

Use resource meta-attribute instead of instance attribute (with -p, -g, -d)

Use resource utilization attribute instead of instance attribute (with -p, -g, -d)

Use resource element attribute instead of instance attribute (with -p, -g, -d)

Operation to clear instead of all (with -C -r)

Interval of operation to clear (default 0s) (with -C -r -n)

The standard the resource agent conforms to (for example, ocf). Use with --agent, --provider, --option, and --validate.

The agent to use (for example, IPaddr). Use with --class, --provider, --option, and --validate.

The vendor that supplies the resource agent (for example, heartbeat). Use with --class, --agent, --option, and --validate.

Specify a device configuration parameter as NAME=VALUE (may be specified multiple times). Use with --validate and without the -r option.

(Advanced) XML ID of attributes element to use (with -p, -d)

(Advanced) XML ID of nvpair element to use (with -p, -d)

(Advanced) Abort if command does not finish in this time (with --restart, --wait, --force-*)

List all options, including advanced and deprecated (with --list-options)

Force the action to be performed. See help for individual commands for additional behavior.

Display software version and exit

Increase debug output (may be specified multiple times)

Be less descriptive in output.

Resource ID