cps.1 (2012 03)

c
cps(1) cps(1)
ENVIRONMENT VARIABLES
When not in a Serviceguard cluster, if --nodes is not specified,
cps additionally looks for the
CFANOUT_HOSTS environment variable. This variable 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
cps assumes a predefined security setup when using remsh and ssh transports. 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,
csshsetup 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
cps
can simultaneously execute remote jobs is limited by the maximum
number of threads that can be created concurrently and the availability of reserved ports in rsh rcmd
modules.
For additional limitations, see the
cexec(1)
manpage.
HOSTLIST EXPRESSIONS
cps 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 represent 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
specifically 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 ALSO
pdsh(1), ps(1), ssh(1), rsh(1), cexec(1), ccp(1), ckill(1), cuptime(1), cwall(1M), csshsetup(1).
2 Hewlett-Packard Company 2 HP-UX 11i Version 3: March 2012