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

Command

What it Does

When to Use it

csync_wizard

Helps set up the cfengine environment.

When setting up the configuration master.

 

 

 

Table 1-2 Consolidated Logging Commands

Command

What it Does

When to Use it

 

 

 

clog

Displays log files.

To examine log files.

 

 

 

clog_wizard

Helps set up log consolidation servers and

When setting up log consolidation.

 

clients.

 

 

 

 

Table 1-3 Command Fanout Commands

Command

What it Does

When to Use it

ccp

Copies files to multiple hosts in parallel.

To perform on-demand synchronization of

 

In a Serviceguard cluster, copies files

files across a set of systems or a

 

cluster-wide.

Serviceguard cluster.

 

 

 

cexec

Issues commands to multiple hosts in

To execute a non-interactive shell command

 

parallel. In a Serviceguard cluster, issues

across a set of systems or cluster. To

 

command cluster-wide.

consolidate identical output, pipe the

 

 

output to dshbak -c.

 

 

 

ckill

Distributes a kill command to multiple

To send a signal to a named process across

 

hosts in parallel. In a Serviceguard cluster,

multiple systems or a cluster.

 

issues command cluster-wide by default.

 

 

 

 

10 Introduction