Queries:¶

-L, --list

List all cluster resources with status

-l, --list-raw

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

-O, --list-operations

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

-o, --list-all-operations

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

--list-standards

List supported standards

--list-ocf-providers

List all available OCF providers

--list-agents=value

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

--list-ocf-alternatives=value

List all available providers for the named OCF agent

--show-metadata=value

Show the metadata for the named class:provider:agent

-q, --query-xml

Show XML configuration of resource (after any template expansion)

-w, --query-xml-raw

Show XML configuration of resource (before any template expansion)

-g, --get-parameter=value

Display named parameter for resource. Use instance attribute unless --meta or --utilization is specified

-W, --locate

Show node(s) currently running resource

-A, --stack

Display the prerequisites and dependents of a resource

-a, --constraints

Display the (co)location constraints that apply to a resource

-Y, --why

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

Commands:¶

--validate

Call the validate-all action of the local given resource

-C, --cleanup

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 cleared, 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.

-R, --refresh

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.

-p, --set-parameter=value

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

-d, --delete-parameter=value

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

Resource location:¶

-M, --move

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, --master. NOTE: This may prevent the resource from running on its previous location until the implicit constraint expires or is removed with --clear.

-B, --ban

Create a constraint to keep resource off a node. Optional: --node, --lifetime, --master. 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 master for master/slave clones with master-max=1 (all other situations result in an error as there is no sane default).

-U, --clear

Remove all constraints created by the --ban and/or --move commands. Requires: --resource. Optional: --node, --master, --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.

-e, --expired

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

-u, --lifetime=value

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

--master

Limit scope of command to the Master role (with -B, -M, -U). For -B and -M, the previous master may remain active in the Slave role.

Advanced Commands:¶

-D, --delete

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

-F, --fail

(Advanced) Tell the cluster this resource has failed

--restart

(Advanced) Tell the cluster to restart this resource and anything that depends on it

--wait

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

--force-demote

(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.

--force-stop

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

--force-start

(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.

--force-promote

(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.

--force-check

(Advanced) Bypass the cluster and check the state of a resource on the local node.

Additional Options:¶

-N, --node=value

Node name

--recursive

Follow colocation chains when using --set-parameter

-t, --resource-type=value

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

-v, --parameter-value=value

Value to use with -p

-m, --meta

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

-z, --utilization

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

-n, --operation=value

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

-I, --interval=value

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

-s, --set-name=value

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

-i, --nvpair=value

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

-T, --timeout=value

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

-f, --force

If making CIB changes, do so regardless of quorum. See help for individual commands for additional behavior.