cmviewcl(1m)cmviewcl(1m)NAMEcmviewcl - view information about a high availability cluster
SYNOPSIScmviewcl [-v] [-f format] [-s config] [-l type] [-r release]
[-c cluster_name]
[{-n node_name}... | {-p package_name}... | {-S site_name}...]
DESCRIPTIONcmviewcl 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).
Options
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‐
ues:
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‐
ter.
-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‐
age_name(s).
-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)
manpage.
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.
Package_Weight_Default_Parameters:
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.
Quorum_Server_Status:
This section contains information on the con‐
figured quorum server for the given node.
NAME The host name or IP address of the quorum
server.
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.
Network_Parameters:
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
disabled.
Capacity_Parameters:
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
node.
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
PKG_SWITCH)
Script_Parameters:
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.
Node_Switching_Parameters
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
node.
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
package.
Policy_Parameters:
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
described.
CONFIGURED_VALUE The configured value of the policy described
by POLICY_NAME . See cmmakepkg(1m) for
details of the possible policy values.
Dependency_Parameters:
This section contains information about the
current state of this package's configured
dependencies on other packages within the
cluster
DEPENDENCY_NAME Unique identifier for the dependency
SATISFIED May have values of yes or no.
Weight_Parameters:
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
described
ATTRIBUTE_NAME Name of attribute.
ATTRIBUTE_VALUE The value of the Attribute described by
ATTRIBUTE_NAME.
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".
MULTI_NODE_PACKAGES (HP-UX only)
A list of packages that can run parallel
instances on multiple nodes. (Formerly SYS‐
TEM_MULTI_NODE_PACKAGES)
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:
name=value
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‐
tifier.
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
package:PKG3|status=up
package:PKG1|status=up
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
status=up
EXAMPLES
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.*//'
RETURN VALUEcmviewcl returns the following value:
0 Successful completion.
1 Command failed.
WARNINGS
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.
AUTHORcmviewcl was developed by HP.
SEE ALSOcmhaltcl(1m), cmhaltnode(1m), cmhaltpkg(1m), cmruncl(1m), cmrunn‐
ode(1m), cmrunpkg(1m), cmquerycl(1m), cmmakepkg(1m), cmviewcl(5).
Requires Optional Serviceguard Software cmviewcl(1m)