NAME     AVAILABILITY     DESCRIPTION     PARTITIONING     SEE ALSO     BUGS     AUTHORS

glunix(1)

 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
and may have attached to it the aliases
dawn, production, smp, desktop
. Each term in a partition description may be either a machine name, an alias, or a range of machine names, for instance
dawn0..dawn10
indicates the set of machines
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
environment variable to the partition description desired. This value is read by all GLUnix programs at the time of initialization of the GLUnix library (see Glib_Intialize(3) for more information).

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

NAME     AVAILABILITY     DESCRIPTION     PARTITIONING     SEE ALSO     BUGS     AUTHORS


This man page was automatically generated by MHTML-2-HTML on Sun Feb 21 10:27:35 PST 1999.
Copyright (c) 1996 Douglas Ghormley.