glunix(1)  1/31/97

glunix(1)  1/31/97

NAME

glunix -	introduction to the set of GLUnix programs

AVAILABILITY

All programs discussed in this overview page are located in the directory /usr/now/bin. They all link with the libglunix.so dynamic library in /usr/now/lib.

DESCRIPTION

This section briefly describes, in alphabetical order, the GLUnix commands currently available to the end user:

glubatch	A batch job submission system for submitting and querying non-interactive, low-priority jobs.
gluenv	Display GLUnix-related environment variables.
glukill	Send signals to jobs running under GLUnix.
glumake	A parallel version of gmake. This program will save you lots of time if you are doing program development.
glupart	A tool for managing the partitioning a naming of a GLUnix cluster. See the PARTITIONING section below for a description of GLUnix partitioning.
glups	Query the jobs currently running under GLUnix.
gluptime	Find out how long GLUnix has been running and how many jobs it has executed.
glurun	Run sequential and parallel jobs under GLUnix.
glush	A modified tcsh shell which automatically executes (most) command line programs on remote nodes via GLUnix.
glustat	Query how many machines are in the GLUnix cluster, how many are considered available to remote jobs, and the current load on each machine.

There are a few programs which are meant for use only by a GLUnix developer or the system administrator. They are not safe for use by end users:

gluadmin	An interface so some of the administrative aspects of the GLUnix library (see Glib(3) interface.
gludebug	Dynamically query and set the debug levels of various GLUnix modules.
gluperf	Dynamically query and set the performance monitoring facilities of GLUnix.
run_glunix	Starts, stops, and restarts GLUnix clusters.

PARTITIONING

A partition in GLUnix does not entail physically separate groups of nodes as the term does when used in the MPP world. Rather, in GLUnix, a partition is simply a set of nodes that the user has chosen to use. It is possible under certain conditions to reserve a set of machines as well.

A partition description is really a type of equation where the basic terms are either machine names or aliases. A machine name is simply the hostname of a given machine. Aliases are names created by end users and attached to a set of machines. For instance, a given machine may have a machine name

dawn0

dawn, production, smp, desktop

dawn0..dawn10

dawn0,
dawn1, dawn2, ..., dawn9, dawn10

The operations that are permitted in a partition descriptions are set union (+), set intersection (^), set difference (-), and paren groupings (( and )).

Some examples of partition descriptions are:

dawn0..dawn10-smp	The set of machines dawn0 through dawn10 which are not associated with the alias smp .
dawn-desktop	All machines with the alias dawn , but without the alias desktop .
dawn^(smp-desktop)+dawn5	All machines which have the alias dawn and also are non-desktop SMPs, plus dawn5 .

Any user can create an alias using the glupart program. Aliases have access control lists indicating who can assign them to a machine, or remove them from a machine.

For most GLUnix commands, the partition can be selected by setting the

GLUNIX_NODES

SEE ALSO

gluadmin(1), glubatch(1), gludebug(1), gluenv(1), glukill(1), glumake(1), glupart(1), glups(1), gluptime(1), gluperf(1), glurun(1), glush(1), glustat(1)

BUGS

See the individual man pages for known bugs of each program.

Should any other bugs be found, please report to glunix-bugs@now.cs.berkeley.edu.

AUTHORS

GLUnix and the GLUnix library were designed and written by:

Douglas Ghormley (ghorm@cs.berkeley.edu),
David Petrou (dpetrou@cs.berkeley.edu),
Amin Vahdat (vahdat@cs.berkeley.edu).
Keith Vetter (keithv@cs.berkeley.edu).

glunix(1)  1/31/97

glunix(1)  1/31/97