crm_resource man page on Oracle

Man page or keyword search:  
man Server   33470 pages
apropos Keyword Search (all sections)
Output format
Oracle logo
[printable version]

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 cluster 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)

       --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
	      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:
       -C, --cleanup
	      Delete  the  resource  history  and  re-check the current state.
	      Optional: --resource

       -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

   Resource location:
       -M, --move
	      Move a resource from its current location to the named  destina‐
	      tion.  Requires: --host. Optional: --lifetime, --master

	      NOTE: This may prevent the resource from running on the previous
	      location node until  the	implicit  constraints  expire  or  are
	      removed with --unban

       -B, --ban
	      Prevent  the  named  resource  from running on the named --host.
	      Requires: --resource. Optional: --host, --lifetime, --master

	      If --host is not specified, it defaults to:

	      * the curent location for primitives and groups, or

	      * the curent location of the master for m/s resources with  mas‐
	      ter-max=1

	      All  other  situations  result  in  an error as there is no sane
	      default.

	      NOTE: This will prevent the resource from running on  this  node
	      until the constraint expires or is removed with --clear

       -U, --clear
	      Remove  all  constraints created by the --ban and/or --move com‐
	      mands.  Requires: --resource. Optional: --host, --master

	      If --host is not specified, all constraints created by --ban and
	      --move will be removed for the named resource.

       -u, --lifetime=value
	      Lifespan of constraints created by the --ban and --move commands

       --master
	      Limit  the  scope	 of the --ban, --move and --clear  commands to
	      the Master role.	For --ban and --move, the previous master  can
	      still remain active in the Slave role.

   Advanced Commands:
       -D, --delete
	      (Advanced) Delete a resource from the CIB

       -F, --fail
	      (Advanced) Tell the cluster this resource has failed

       --force-stop
	      (Advanced)  Bypass  the cluster and stop a resource on the local
	      node. Additional detail with -V

       --force-start
	      (Advanced) Bypass the cluster and start a resource on the	 local
	      node. Additional detail with -V

       --force-check
	      (Advanced)  Bypass the cluster and check the state of a resource
	      on the local node. Additional detail with -V

   Additional Options:
       -N, --node=value
	      Host uname

       --recursive
	      Follow colocation chains when using --set-parameter

       -t, --resource-type=value
	      Resource type (primitive, clone, group, ...)

       -v, --parameter-value=value
	      Value to use with -p, -g or -d

       -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

       List the available OCF agents:

	      # crm_resource --list-agents ocf

       List the available OCF agents from the linux-ha project:

	      # crm_resource --list-agents ocf:heartbeat

       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	 loca‐
       tion:

	      # 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.10-29.el7		   May 2014			  PACEMAKER(8)
[top]

List of man pages available for Oracle

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net