crm_shadow(8) [debian man page]
PACEMAKER(8) System Administration Utilities PACEMAKER(8) NAME
Pacemaker - Part of the Pacemaker cluster resource manager SYNOPSIS
crm_shadow (query|command) [modifiers] DESCRIPTION
crm_shadow - Perform configuration changes in a sandbox before updating the live cluster. Sets up an environment in which configuration tools (cibadmin, crm_resource, etc) work offline instead of against a live cluster, allowing changes to be previewed and tested for side-effects. OPTIONS
-?, --help This text -$, --version Version information -V, --verbose Increase debug output Queries: -w, --which Indicate the active shadow copy -p, --display Display the contents of the active shadow copy -E, --edit Edit the contents of the active shadow copy with your favorite $EDITOR -d, --diff Display the changes in the active shadow copy -F, --file Display the location of the active shadow copy file Commands: -c, --create=value Create the named shadow copy of the active cluster configuration -e, --create-empty=value Create the named shadow copy with an empty cluster configuration -C, --commit=value Upload the contents of the named shadow copy to the cluster -D, --delete=value Delete the contents of the named shadow copy -r, --reset=value Recreate the named shadow copy from the active cluster configuration -s, --switch=value (Advanced) Switch to the named shadow copy Additional Options: -f, --force (Advanced) Force the action to be performed -b, --batch (Advanced) Don't spawn a new shell -a, --all (Advanced) Upload the entire CIB, including status, with --commit EXAMPLES
Create a blank shadow configuration: # crm_shadow --create-empty myShadow Create a shadow configuration from the running cluster: # crm_shadow --create myShadow Display the current shadow configuration: # crm_shadow --display Discard the current shadow configuration (named myShadow): # crm_shadow --delete myShadow Upload the current shadow configuration (named myShadow) to the running cluster: # crm_shadow --commit myShadow AUTHOR
Written by Andrew Beekhof REPORTING BUGS
Report bugs to pacemaker@oss.clusterlabs.org Pacemaker 1.1.7 April 2012 PACEMAKER(8)
Check Out this Related Man Page
PACEMAKER(8) System Administration Utilities PACEMAKER(8) NAME
Pacemaker - Part of the Pacemaker cluster resource manager SYNOPSIS
crm_resource (query|command) [options] DESCRIPTION
crm_resource - Perform tasks related to cluster resources. Allows resources to be queried (definition and location), modified, and moved around the cluster. OPTIONS
-?, --help This text -$, --version Version information -V, --verbose Increase debug output -Q, --quiet Print only the value on stdout -r, --resource=value Resource ID Queries: -L, --list List all resources -l, --list-raw List the IDs of all instantiated resources (no groups/clones/...) -O, --list-operations List active resource operations. Optionally filtered by resource (-r) and/or node (-N) -o, --list-all-operations List all resource operations. Optionally filtered by resource (-r) and/or node (-N) -q, --query-xml Query the definition of a resource (template expanded) -w, --query-xml-raw Query the definition of a resource (raw xml) -W, --locate Display the current location(s) of a resource -A, --stack Display the prerequisites and dependents of a resource -a, --constraints Display the (co)location constraints that apply to a resource Commands: -p, --set-parameter=value Set the named parameter for a resource. See also -m, --meta -g, --get-parameter=value Display the named parameter for a resource. See also -m, --meta -d, --delete-parameter=value Delete the named parameter for a resource. See also -m, --meta -M, --move Move a resource from its current location, optionally specifying a destination (-N) and/or a period for which it should take effect (-u) If -N is not specified, the cluster 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 -U, --un-move Remove all constraints created by a move command Advanced Commands: -D, --delete Delete a resource from the CIB -F, --fail Tell the cluster this resource has failed -R, --refresh (Advanced) Refresh the CIB from the LRM -C, --cleanup (Advanced) Delete a resource from the LRM -P, --reprobe (Advanced) Re-check for resources started outside of the CRM Additional Options: -N, --node=value Host uname -t, --resource-type=value Resource type (primitive, clone, group, ...) -v, --parameter-value=value Value to use with -p, -g or -d -u, --lifetime=value Lifespan of migration constraints -m, --meta Modify a resource's configuration option rather than one which is passed to the resource agent script. For use with -p, -g, -d -z, --utilization Modify a resource's utilization attribute. For use with -p, -g, -d -s, --set-name=value (Advanced) ID of the instance_attributes object to change -i, --nvpair=value (Advanced) ID of the nvpair object to change/delete -f, --force EXAMPLES
List the configured resources: # crm_resource --list Display the current location of 'myResource': # crm_resource --resource myResource --locate Move 'myResource' to another machine: # crm_resource --resource myResource --move Move 'myResource' to a specific machine: # crm_resource --resource myResource --move --node altNode Allow (but not force) 'myResource' to move back to its original location: # crm_resource --resource myResource --un-move Tell the cluster that 'myResource' failed: # crm_resource --resource myResource --fail Stop a 'myResource' (and anything that depends on it): # crm_resource --resource myResource --set-parameter target-role --meta --parameter-value Stopped Tell the cluster not to manage 'myResource': The cluster will not attempt to start or stop the resource under any circumstances. Useful when performing maintenance tasks on a resource. # crm_resource --resource myResource --set-parameter is-managed --meta --parameter-value false Erase the operation history of 'myResource' on 'aNode': The cluster will 'forget' the existing resource state (including any errors) and attempt to recover the resource. Useful when a resource had failed permanently and has been repaired by an administrator. # crm_resource --resource myResource --cleanup --node aNode AUTHOR
Written by Andrew Beekhof REPORTING BUGS
Report bugs to pacemaker@oss.clusterlabs.org Pacemaker 1.1.7 April 2012 PACEMAKER(8)