README for Rex

* Introduction

Rex is a remote execution utility that runs a supplied command 
on a set of remote hosts.  Arbitrary data can be supplied to the
command in the form of local files, which will be transferred to each
remote host prior to running the command and removed afterward.  Both
parallel and sequential execution is supported.

Special mode exists to distribute a file or files to several hosts.  

Rex is written in TCL and provides extensive scripting facilities.  It
provides a convenient way to administrate multiple servers.

The program is designed to operate in a minimalistic environment.  It
is self-contained and does not need any external libraries.  The only
requirements are:

** Expect v. 5.44.1.13 or newer
** ssh and scp

* Installing 

Change to the toplevel source directory and type

  ./install

This will install the script to /usr/bin/rex and its manpage to
/usr/share/man/man8/rex.8.  Use the following options to change these
defaults:

    --prefix=DIR      set installation prefix (default /usr)
    --sysconfdir=DIR  set configuration directory (/etc/rex)
    --bindir=DIR      set directory for user executables ($prefix/bin)
    --mandir=DIR      set man documentation root directory ($prefix/share/man)
    --tclpackagedir=DIR
	              directory for installing TCL packages
    --extras          install extra packages

The -n (--dry-run) option will cause install to print what it was
about to do, without actually doing that.  Use it for inspecting
whether your invocation will produce the expected results.

* Usage Instructions

Please refer to the manual page for rex(8).  To read it without
installing the package, run "man ./rex.man8" in the rex source directory.

* Bug Reporting

Please send your suggestions and bug reports to <gray+rex@gnu.org.ua>.


Local Variables:
mode: outline
paragraph-separate: "[ 	]*$"
version-control: never
End: