Distributed Systems Administration Utilities User's Guide, Linux, March 2009

the distribution of ssh keys. The companion utility Parallel Distributed Copy (pdcp) enables
file and directory copies to be performed in parallel to a set of remote systems. The dshbak
filter allows the output from multiple systems to be formatted and consolidated for better
on-screen presentation.
The cexec, ccp, ckill, cps, and cuptime tools are wrappers around the pdsh and
pdcp commands optimized for use in a Serviceguard cluster. They default to executing
commands clusterwide. These wrappers do the following:
— cexec - Like pdsh but with additional reporting and retry features
— ccp - Copies files clusterwide
— ckill - Kills the named process clusterwide or on the specified systems
— cps - Issues a ps command clusterwide or on the specified systems
— cuptime - Runs the uptime command clusterwide
These commands can also be used outside a cluster, but like pdsh and pdcp, the user must
specify a list of target hosts. The cexec command operates like pdsh and adds reporting
capabilities. Saved reports can be used to reissue previous commands and target only those
systems where the command originally failed, originally succeeded, or both. Command
fanout is more fully described in Chapter 4: “Command Fanout” (page 83).
The next section describes the commands provided with each DSAU component.
1.1 Distributed Systems Administration Utilities Commands
Table 1-1 Configuration Synchronization Command
When to Use itWhat it DoesCommand
When setting up the configuration master.Helps set up the cfengine environment.
csync_wizard
Table 1-2 Consolidated Logging Commands
When to Use itWhat it DoesCommand
To examine log files.Displays log files.
clog
When setting up log consolidation.Helps set up log consolidation servers and
clients.
clog_wizard
Table 1-3 Command Fanout Commands
When to Use itWhat it DoesCommand
To perform on-demand synchronization of
files across a set of systems or a
Serviceguard cluster.
Copies files to multiple hosts in parallel.
In a Serviceguard cluster, copies files
clusterwide.
ccp
To execute a non-interactive shell command
across a set of systems or cluster. To
consolidate identical output, pipe the
output to dshbak -c.
Issues commands to multiple hosts in
parallel. In a Serviceguard cluster, issues
command clusterwide.
cexec
To send a signal to a named process across
multiple systems or a cluster.
Distributes a kill command to multiple
hosts in parallel. In a Serviceguard cluster,
issues command clusterwide by default.
ckill
To collect process information from groups
of systems simultaneously.
Distributes a ps(1) command to multiple
hosts in parallel. In a Serviceguard cluster,
issues command clusterwide by default.
cps
12 Introduction