This manual is an introduction to Legion 1.6 for users with little or no experience with Legion. It gives instructions for logging in to an active Legion system and a high-level introduction to Legion context space. Users who need to install or start a Legion system should consult the System Administrator Manual (Downloading Legion 1.6.x). If you need more help please contact us.
There are three additional Legion manuals. The System Administrator Manual has information for Legion system administrators, including installing and running a Legion system, configuring security features, and managing resources. The Developer Manual provides information and documentation for Legion programmers and includes information about languages, libraries, core objects, and implementing new objects. The Reference Manual is a more specialized resource, providing detailed information about specific elements of the Legion system. There are also man pages for all Legion commands, included with the system files, and several on-line tutorials on the Legion web site (http://legion.virginia.edu).
This manual assumes that you are working on a previously installed, compiled, and running system.1 (See the System Administrator Manual for information on installing, compiling, and starting a new Legion system.) Before going any further, be sure that the system is properly installed and running. Check with your system administrator if you are unsure.
Developed at the University of Virginia, Legion is an integrated software system for distributed parallel computation. While fully supporting existing codes written in MPI and PVM, Legion provides features and services that allow users to take advantage of much larger, more complex resource pools. With Legion, for example, a user can easily run a computation on a supercomputer at a national center while dynamically visualizing the results on a local machine or schedule and run a large parameter space study on several workstation farms simultaneously. Legion permits computational scientists to use cycles wherever they are, allowing bigger jobs to run in shorter times through higher degrees of parallelization.
These features also make Legion attractive to administrators looking for ways to increase and simplify the use of shared high-performance machines. The Legion implementation emphasizes extensibility, and multiple policies for resource use can be embedded in a single Legion system that spans multiple resources or even administrative domains.
1.It is actually not always necessary to have a Legion system running in order to use Legion: some Legion hosts can run as client hosts in a larger Legion system. A client host does not have the full set of Legion system binaries, but a set of binary executable files that can contact other Legion hosts in its Legion system. For more information on this option, please e-mail us at email@example.com.