Distributed Systems Administration Utilities User's Guide

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 cluster-wide. These wrappers do the following:
— cexec - Like pdsh but with additional reporting and retry features
— ccp - Copies files cluster-wide
— ckill - Kills the named process cluster-wide or on the specified systems
— cps - Issues a ps command cluster-wide or on the specified systems
— cuptime - Runs the uptime command cluster-wide
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).
IMPORTANT: On HP-UX 11i v3 Integrity systems, pdsh requires an additional software,
LibcExt, to make use of the functions that are not shipped with the standard Library Routines,
libc in HP-UX 11i v3. LibcExt contains setegid() and seteuid() POSIX APIs, which the
pdsh tool requires to function properly.
LibcExt forms part of the Portability Package (Product # PortPkg) depot. You can download
Portability Package from the HP Software Depot web site at www.software.hp.com
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
cluster-wide.
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 cluster-wide.
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 cluster-wide by default.
ckill
10 Introduction