cmviewcl man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

cmviewcl(1m)							  cmviewcl(1m)

       cmviewcl - view information about a high availability cluster

       cmviewcl [-v] [-f format] [-s config] [-l type] [-r release]
		[-c cluster_name]
		[{-n node_name}... | {-p package_name}... | {-S site_name}...]

       cmviewcl	 displays  the current status information of a cluster. Output
       can be displayed for the whole cluster or it may be limited to particu‐
       lar nodes or packages.

       To  view	 cluster  information,	a user must either be a superuser with
       effective user ID of zero (see id(1) and su(1)), or have an access pol‐
       icy  of	MONITOR	 allowed  in the cluster configuration file, or have a
       policy of PACKAGE_ADMIN in a package's configuration file.  See	access
       policy in cmquerycl(1m) or cmmakepkg(1m).

       cmviewcl supports the following options:

	      -c cluster_name	Name  of  the cluster to view.	If this option
				is omitted, cmviewcl will display  information
				about  the current cluster that the local node
				belongs to.

	      -f format		Select the output format to display.  The for‐
				mat parameter may be one of the following val‐

				table This option displays  a  human  readable
				      tabular  output  format.	 This  is  the
				      default output format if no -f is speci‐
				      fied on the command line.

				line  This  option displays a machine parsable
				      output format. Data items are displayed,
				      one  per	line, in a way that makes them
				      easy to manipulate with  tools  such  as
				      grep(1)  and  awk(1).   This option also
				      shows additional information not	avail‐
				      able  in	the table output format.  Some
				      of these are detailed under  Specialized
				      Line    Output.	  Please    refer   to
				      cmviewcl(5) for further details.

	      -l type		Limit the type	of  data  displayed.  If  this
				option	is  specified, cmviewcl will only dis‐
				play information related to type.  Valid  val‐
				ues are:

				cluster Only  display  status or configuration
					information related to the cluster.

				group	Only display  information  related  to
					groups	as  defined  by the OPS or RAC
					group membership  services.   This  is
					only  displayed	 in  clusters  created
					using Serviceguard Extension for RAC.

				node	Only display status  or	 configuration
					related to the nodes in the cluster.

				package Only  display  status or configuration
					related to the packages in  the	 clus‐

	      -n node_name	View   information  only  about	 the  specific
				node_name,  including  information  about  the
				packages that are running on these nodes.

	      -p package_name	View information only about the specific pack‐

	      -S site_name	View  information  only	 about	the   specific
				site_name(s),	the   nodes  assigned  to  the
				site(s), and relevant packages.	 A package  is
				considered  relevant  to  a site if it matches
				any of these conditions:

				 1. It is a failover package and it is running
				on a node within the site.
				 2. It is a failover package, and is only con‐
				figured for nodes within the site.
				 3. It is a system multi-node package,	or  it
				is  a multi-node package and is configured for
				any node within the site.

				For example, consider a failover package  con‐
				figured	 for  all nodes in a cluster. If it is
				not running on one of the nodes in the site(s)
				specified with the -S option, then it will not
				be displayed in the output.

				This option should only be  used  on  clusters
				configured  using  an HP approved, site-aware,
				disaster tolerant solution on HP-UX.

	      -r release	Make the tabular formatted output  mimic  that
				of  the	 specified  release.   This option has
				been provided for compatibility with  existing
				scripts	  that	 parse	the  tabular  form  of
				cmviewcl output. This option  is  not  allowed
				with  the  '-f line' option. It is recommended
				that newly created scripts  utilize  the  line
				oriented  output  format.  This option is only
				available on HP-UX.

				Valid values for release are:

				  A.11.12 or 11.12
				  A.11.16 or 11.16

	      -s config		Displays only the static configuration	infor‐
				mation,	 not  the  dynamic status information.
				This option can only be used  when  '-f	 line'
				option is also specified.

	      -v		Verbose	 output	 will  be  displayed. When the
				tabular output has been selected, this	option
				provides  additional  detailed status informa‐
				tion.  When  line  oriented  output  has  been
				selected, this option provides additional con‐
				figuration and status information.

   Tabular output format
       The tabular output format contains the following information:

	      CLUSTER		Name of the cluster.  This name will  be  used
				to identify the cluster.

	      STATUS		Status	of  the	 cluster,  node, package, etc.
				Status is either up, down, starting,  halting,
				or  unknown,  unknown is a special status that
				indicates insufficient	information  was  col‐
				lected	to  exactly determine whether the item
				is up or down, e.g., when some of the nodes in
				the  cluster  cannot  be reached over the net‐
				work.  Please see the cmviewcl(5) manpage  for
				more details.

	      GROUP		Name  of  a group as defined by the OPS or RAC
				group membership services.  This is only  dis‐
				played	in clusters created using Serviceguard
				Extension for RAC

	      MEMBER		ID number of a member of a group.

	      PID		Process ID of the group member.

	      MEMBER_NODE	Node on which the group member is running.

	      NODE		Name of the node.

	      STATE		The action that the node or  package  is  cur‐
				rently	taking	(if any).  The normal state is
				running.  However, a  node  may	 be  reforming
				which  means  that  a  new node is joining the
				cluster, or one or more nodes have  lost  con‐
				nection	 with  each  other. For information on
				the package state, please see the  cmviewcl(5)

	      SITE_NAME		Site  name  to which nodes have been assigned.
				(HP-UX only) This is only displayed  in	 clus‐
				ters  configured  using	 an  HP	 approved site
				aware disaster tolerant solution.

				This section contains the listing  of  default
				values for package weights.

	      NAME		Weight name.

	      VALUE		The default value for the weight. This applies
				to all packages unless it is overridden in the
				package configuration file.

				This  section contains information on the con‐
				figured quorum server for the given node.

	      NAME		The host name or  IP  address  of  the	quorum

	      STATUS		Status of the quorum server; can be up or down
				or unknown.  Status indicates whether the quo‐
				rum  server  is available to the node as a tie
				breaking service.

	      STATE		The state of the quorum server with respect to
				the  node.   The  normal state is running, the
				cluster	 tie-breaking  service	is  available.
				Other  states may appear as the node interacts
				with the quorum server.

	      Cluster_Lock_LUN: This section contains information on the  con‐
				figured lock LUN for a given node.

	      DEVICE		Full  device path name of the cluster lock LUN
				device as seen from the specified node.

	      STATUS		Status	of  the	 cluster  lock	LUN  indicates
				whether	 the  cluster lock is available to the
				node as a tie breaking service.	 Status can be
				up, down or unknown.  It is up when the device
				responds as expected.  It  is  down  when  the
				device experiences known errors.

	      Cluster_Lock_LVM: This  section contains information on the con‐
				figured LVM lock for a given  node.  (This  is
				HP-UX only.)

	      VOLUME_GROUP	This  is  the  path  of	 the volume group that
				holds the cluster lock.

	      PHYSICAL_VOLUME	This physical volume contains the path to  the
				disk holding the cluster for this node.

	      STATUS		Status	of  the	 cluster  lock	LVM  indicates
				whether the cluster lock is available  to  the
				node as a tie breaking service.	 Status can be
				up, down or unknown.  It is up when the device
				responds  as  expected.	  It  is down when the
				device experiences known errors.

				This section contains the listing of the  net‐
				work interfaces for the given node.

	      INTERFACE		A network interface is either a PRIMARY inter‐
				face or a STANDBY interface.

	      NAME		Name of the hardware path  and	interface  for
				the network.

	      STATUS		Status	and  state  of	the network interface.
				Status can be up, down,	 or  unknown.	Status
				indicates  the	current physical status of the
				interface.  State can only  be	disabled.   If
				the interface has been disabled via the cmmod‐
				net command, then the state will be  shown  as
				disabled  (next to status).  If only status is
				shown, it implies that the  interface  is  not

				This  section  contains the listing of capaci‐
				ties for the given node.

	      NAME		Capacity name.

	      LIMIT		Maximum value for this capacity.

	      USED		Amount of capacity used	 by  packages  on  the

	      PERCENT_USED	Percentage of capacity currently used.

	      PACKAGE		Name of the package.

	      AUTO_RUN		Value  of  the	global	switching flag for the
				package.  Switching is either enabled or  dis‐
				abled.	 The  value  enabled means that in the
				event of a failure, the package will automati‐
				cally  move  to	 the next available node.  The
				value disabled means the package will  not  be
				restarted    after   a	 failure.    (Formerly

				This section contains a listing of items  spe‐
				cific to the package.

	      ITEM		Service,  subnet,  cluster  interconnect  sub‐
				net(HP-UX only) or  resource  information  for
				the  package.  Cluster	interconnect subnet is
				only displayed in clusters created using  Ser‐
				viceguard Extension for RAC.

	      NAME		The  "value"  of  the item.  For example, this
				would be a subnet address or  the  name	 of  a
				service or resource.

	      MAX_RESTARTS	If a service fails, this is the maximum number
				of times it will be attempted to be  restarted
				(as  defined  by the SERVICE_RESTART parameter
				in a package's RUN_SCRIPT).

	      RESTARTS		The number  of	times  that  the  service  has
				failed and was restarted.

				This  section  contains a listing of the nodes
				on which the package can run.

	      NODE_TYPE		A node is either a  PRIMARY  or	 an  ALTERNATE

	      SWITCHING		Value of the node switching flag for the pack‐
				age.  Switching is either enabled or disabled.
				This  indicates	 whether  or not a package can
				switch to the node if a failure	 occurs,  pro‐
				vided that global switching is enabled for the

				This section contains a listing of  the	 poli‐
				cies  that have been configured for this pack‐
				age.  See cmmakepkg(1m)	 for  details  of  the
				possible package policies.

	      POLICY_NAME	The   name   of	  the	package	 policy	 being

	      CONFIGURED_VALUE	The configured value of the  policy  described
				by   POLICY_NAME   .   See  cmmakepkg(1m)  for
				details of the possible policy values.

				This section contains  information  about  the
				current	 state	of  this  package's configured
				dependencies  on  other	 packages  within  the

	      DEPENDENCY_NAME	Unique identifier for the dependency

	      SATISFIED		May have values of yes or no.

				This  section  contains the listing of weights
				configured for the given package.

	      WEIGHT_NAME	Weight name. This corresponds to a node capac‐
				ity of the same name.

	      WEIGHT_VALUE	Weight value

	      Other_Attributes: This  section  contains	 a  listing  of	 other
				important  attributes  of  the	package	 being

	      ATTRIBUTE_NAME	Name of attribute.

	      ATTRIBUTE_VALUE	The   value  of	 the  Attribute	 described  by

				Style	  Style of the package can  be	either
					  legacy   or	modular.    The	 style
					  describes the configuration style of
					  the package.

				Priority  Priority   of	 the  package  can  be
					  either a numerical value  between  1
					  and  3000  or "no_priority".	If the
					  priorty is configured as no_priority
					  or  if it is not configured then the
					  value is displayed as "no_priority".

				A list	of  packages  that  can	 run  parallel
				instances  on  multiple	 nodes. (Formerly SYS‐

	      UNOWNED_PACKAGES	A listing of packages not currently running.

   Line output format
       The line output format is designed for  simple  machine	parsing	 using
       tools such as grep(1), cut(1) or awk(1).

       Each line of output is composed of the form:


       The value field is a string that describes a single piece of configura‐
       tion or status data related to name.

       The name field uniquely identifies a single configuration or data  item
       and is composed of one or more elements, separated by a pipe character.
       In cases where the output contains multiple lines with the same type of
       name element, the name element is further qualified by an element iden‐

       The name element identifier is appended to the name element  and	 sepa‐
       rated  by  a  colon. The name element identifier is used to distinguish
       which object the configuration or status information corresponds to.

       In the following example, the name element  path	 for  current  package
       status  is  package|status.  Since multiple package status elements are
       being displayed, the package element is further qualified with the ele‐
       ment  identifiers  PKG3	and  PKG1 which correspond to the names of the
       packages for which the status item applies.

	      # cmviewcl -f line -l package | grep -e status

       When the cmviewcl command line unambiguously selects a  single  object,
       the  initial  name  element  is not included since the context has been
       specified by the command. As an example:

	      # cmviewcl -f line -l package -p PKG1 | grep -e status

       Display the current status of all packages

	      cmviewcl -l package

       Display a detailed status of a particular package

	      cmviewcl -v -l package -p PKG1

       Display just the current state of the cluster

	      cmviewcl -f line -l cluster | grep status | cut -d= -f2'

       Print the name of packages that have global switching disabled

	      cmviewcl -v -f  line  |  grep  '^package:[^.]*.autorun=dis'  |
	      sed -e 's/^.*://' -e 's/|auto.*//'

       cmviewcl returns the following value:

	      0	   Successful completion.
	      1	   Command failed.

       In  some cases, the command may fail to view the cluster configuration.
       Here are some possible causes:

	      o The node from which the command is issued is not configured in
		the cluster.

	      o The binary cluster configuration file is missing or corrupt.

	      o cmclconfd  is missing or is corrupt or is not configured prop‐
		erly in the /etc/inetd.conf file (or /etc/xinetd.d directory).

	      o The user is not allowed access to the cluster in the  security
		files.	 Version of Serviceguard earlier than A.11.16, specify
		access in the node's .rhosts or	 cmclnodelist  files.  Version
		A.11.16 and later, prior to the existence of a cluster config‐
		uration file, specify access in node's .rhosts or cmclnodelist
		files.	However,  once a cluster is configured, specify access
		in the cluster or package configuration files.

	      o NOTE: When this command is run by an authorized	 user  who  is
		not  the  superuser(UID=0),  only those entries that match the
		user running the command and the node where the command is run
		are displayed.

       cmviewcl was developed by HP.

       cmhaltcl(1m),   cmhaltnode(1m),	 cmhaltpkg(1m),	 cmruncl(1m),  cmrunn‐
       ode(1m), cmrunpkg(1m), cmquerycl(1m), cmmakepkg(1m), cmviewcl(5).

		    Requires Optional Serviceguard Software	  cmviewcl(1m)

List of man pages available for HP-UX

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]
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