NAME

reconcile − configure, modify, or unconfigure cluster-wide resources

SYNOPSIS

/usr/sam/bin/reconcile

DESCRIPTION

reconcile enables NFS Diskless cluster clients to configure, modify or unconfigure cluster-wide resources, such as printers or file systems.  Normally such tasks are accomplished during a SAM session through the use of cluster-wide tasks, tasks that are executed on every cluster member.  However, if a diskless client is inaccessible (down or not communicating with the LAN ) when the cluster-wide task is executed during the SAM session, the task is deferred for later execution. 

reconcile executes deferred tasks.  It is invoked automatically during client boot by the SAM single point administration startup script.  It can also be invoked explicitly on the client system to update the client’s cluster-wide resources without rebooting. 

EXTERNAL INFLUENCES

Environment Variables

LANG specifies the language used to display messages. 

If LANG is not specified or is set to the empty string, a default of C (see lang(5)) is used instead of LANG.  If any internationalization variable contains an invalid setting, reconcile behaves as if all internationalization variables are set to C.  See environ(5).

RETURN VALUE

reconcile returns the following values:

  0 Successful completion.  All deferred tasks completed successfully. 

  1 Successful completion.  All deferred tasks completed successfully, but some completed with exceptions or conditions. 

255 A task or command failure occurred.  A task failure results when at least one deferred task failed during execution or was prevented from executing.  A command failure generally prevents all tasks from executing and can be caused, for example, by missing or corrupt configuration files. 

DIAGNOSTICS

reconcile issues a summary of deferred tasks’ results on standard output, and logs all messages received on standard output and standard error in the SAM log file.  If reconcile fails (returns a value of 255), the summary is mailed to the root user of the cluster server. 

EXAMPLES

Update the local client’s cluster-wide resources:

/usr/sam/bin/reconcile

WARNINGS

reconcile cannot be used to update cluster-wide resources on the cluster server because tasks are never deferred for the server. 

The cluster resource database directory must be mounted from the server or results will be undefined. 

AUTHOR

reconcile was developed by HP. 

FILES

/etc/sam/domain/spa/* Cluster resource database

/var/sam/log/samlog SAM log file

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996