cps(1)cps(1)NAMEcps - View processes from multiple hosts. cps is part of the Distrib‐
uted Systems Administration Utilities (DSAU).
SYNOPSIS
Path: /opt/dsau/bin/cps
[cps options] {-a | -e } [other ps(1) options]
[--help ]
[--version ]
DESCRIPTION
Displays processes from multiple hosts; defaults to work cluster-wide
in a Serviceguard cluster. When not in a Serviceguard cluster,
defaults to issuing commands on the local host. accepts all arguments
of ps. You must pass the ps(1) command's -a or -e option to cps. For
additional information, see the manpage.
REMOTE COMMAND TRANSPORT OPTIONS
The user selects how runs commands on remote hosts at runtime using the
-R option. The protocols listed below are supported; the default com‐
mand transport is ssh.
· rsh
Uses an internal, thread-safe implementation of BSD to run
commands using the standard rsh(1) protocol.
· ssh
Uses a variant of to run multiple copies of the command.
Standard cps
Options
--nodes host1,host2,...
Target the specified list of hosts. No spaces are allowed in
the comma-separated list. The host list may contain hostlist
hostlist expressions of the form "host[1-5,7]." For more
information about the hostlist format, see the HOSTLIST
EXPRESSIONS section below. This option overrides all other
host specification options.
--exclude host1,host2,...
Target the specified list of hosts.In a Serviceguard cluster,
this option is not required and the default is all cluster
members.
The host list may contain hostlist expressions of the form
"host[1-5,7]" . For more information about the hostlist for‐
mat, see the HOSTLIST EXPRESSIONS section below.
Other
Options
Note: Pass standard options after cps options. All cps options are
specified in "long option" form (preceded by --) to differentiate them
from ps options. See EXAMPLES for details.
In addition to all options, the following are valid:
--fanout number
Sets the maximum number of simultaneous remote commands to
number. The default is 64.
--help Displays help on command options and quits.
--rcmd moduleName
Set remote command transport options module to moduleName,
where moduleName is ssh or rsh.
--timeout seconds
Sets the connect timeout in seconds.
--ctime seconds
Sets a limit on the amount of time a remote command is
allowed to execute. Default is no limit.
--version Shows the version of .
ENVIRONMENT VARIABLES
When not in a Serviceguard cluster, if --nodes is not specified, addi‐
tionally looks for the CFANOUT_HOSTS environment variable. This vari‐
able can be set to a filename from which the list of target hosts is
read. The file should contain a list of hosts, one per line. A line
can itself be a hostlist expression.
LIMITATIONS
assumes a predefined security setup when using remsh and ssh trans‐
ports. Neither transport can prompt for a password. For remsh, the
user's /.rhosts must be appropriately configured. For ssh, a public
key distribution must be performed to all targeted hosts. For the ssh
case, the csshsetup tool is provided to make the ssh setup as simple as
possible. For example, makes it easy to set up any node to any node
trust relationships in a Serviceguard cluster for groups of managed
systems.
The number of nodes on which can simultaneously execute remote jobs is
limited by the maximum number of threads that can be created concur‐
rently and the availability of reserved ports in modules.
For additional limitations, see the manpage.
HOSTLIST EXPRESSIONS
accepts lists of hosts in the general form: prefix[n-m,l-k,...], where
n < m and l < k, and so on, as an alternative to explicit lists of
hosts. This form is not the same as regular expression character
classes (also denoted by "[]" ). For example, node[19] does not repre‐
sent an expression matching node1 or node9, but rather the degenerate
hostlist: node19.
The hostlist syntax is provided only as a convenience on clusters using
a "prefixNNN" naming convention and specification of ranges should not
be considered necessary -- thus node1,node9 could be listed specifi‐
cally or as hostlist node[1,9].
EXAMPLES
To view all processes in the Serviceguard cluster.
cps-ef
To view all processes on node1.
cps--nodes node1 -ef
To search for processUnique on nodes node1 and node2.
cps--nodes node1,node2 -ef | grep processUnique
Standard ps options must follow cps options on the command line.
CORRECT: cps--nodes node1 -ef
INCORRECT: cps-ef --nodes node1
Note that some shells will interpret brackets ([ and ]) for pattern
matching. Depending on your shell, you may need to enclose ranged
lists within quotes. For example, in tcsh, the first example above
should be executed as:
cps--nodes "node[01-05]" -ef | more
SEE ALSOpdsh(1), ps(1), ssh(1), rsh(1), cexec(1), ccp(1), ckill(1), cuptime(1),
cwall(1M), csshsetup(1)cps(1)
