Legion 1.6.3 Basic User Manual
Table of Contents

Before you start

1.0 Introduction
1.1 About this manual
1.2 Style conventions
1.3 About Legion

Getting started

2.0 Setting up and logging in
2.1 Preparing your Legion environment
2.2 Logging in to a Legion system
2.2.1 Logging in as a user
2.2.2 Changing your password
2.2.3 About object permissions
2.2.4 Checking your log in status
2.2.5 Logging out
2.2.6 Using Legion in a Kerberos environment

Context space

3.0 An introduction to context space
4.0 The GUI
4.1 Installing the GUI in Windows 95
4.2 Running the GUI in Windows95
4.3 Running the GUI in a Unix environment
4.4 The main GUI window
4.5 View windows
4.6 The startup view window
4.7 Main menu commands
4.7.1 File
4.7.2 View
4.7.3 Edit
4.8 Context space vs. the GUI cache
5.0 Context space
5.1 Legion object names
5.2 About the LOID
5.3 Organizing context space
6.0 Working in context space
6.1 View a context's contents
6.2 Looking up an object's LOID
6.3 Create a new context
6.4 Changing the working context
6.5 Checking the current working context
6.6 Alternate names for existing contexts
6.7 Assigning a context name to a LOID
6.8 Renaming an object
6.9 Listing an object's names
6.10 Removing names and objects
6.11 Using the same name in different contexts
6.12 Copying a local file to a Legion file object
6.13 Copying a Legion file object
6.14 Viewing a file object's contents
6.15 Importing a local Unix tree
6.16 Link a directory to context space
7.0 Host and vault objects
7.1 What is a host object and vault object?
7.2 About the bootstrap host and vault
7.3 Creating objects on new hosts
7.4 Instance placement on hosts and vaults

Running applications

8.0 Running a Legion application
9.0 PVM
9.1 Core PVM interface
9.2 Tids & LOIDs
9.3 Task classes
9.4 Installing PVM-Legion
9.5 Compilation
9.6 Registering compiled tasks
9.7 Examples
9.8 Running PVM code with the fewest changes
10.0 MPI
10.1 Legion MPI
10.1.1 Task classes
10.1.2 Installing Legion MPI
10.1.3 Compilation
10.1.4 Register compiled tasks
10.1.5 Running the MPI application
10.1.6 Example
10.1.7 Accessing files in programs using MPI
10.1.8 Scheduling MPI processes
10.1.9 Debugging support
10.1.10 Checkpointing support
10.1.10.1 Example
10.1.10.2 API (C & Fortran)
10.1.10.3 Running the above example
10.1.10.4 Recovering from failure
10.1.10.5 Restarting application
10.1.10.6 Compiling/makefile
10.1.10.7 Another example
10.1.10.8 Limitations
10.1.11 Functions supported
10.1.12 Running a Legion MPI code with the fewest changes
10.2 Native MPI
10.2.1 Task classes
10.2.2 Compilation
10.2.3 Register compiled tasks
10.2.4 Running a native MPI application
10.2.5 Making Legion calls from native MPI programs
10.2.6 Example
10.2.7 Scheduling native MPI processes
11.0 Executing remote programs
11.1 Introduction
11.2 Compatible and incompatible programs
11.3 Registering incompatible programs
11.4 Registering Legion-compatible programs
11.5 Running a remote program
11.6 Converting a C/C++ program
11.7 Summary
11.8 Running a remote program from the GUI
12.0 Replaying & debugging applications
12.1 Sample record and replay

Appendices

A-1 Sample makefile

A-2 About Legion tty objects
A-2.1 Simple tty management
A-2.2 Complex tty management
A-3 Alphabetical list of Legion commands

A-4 Subject listing of Legion commands
A-4.1 Calls on objects
A-4.2 Calls on class objects
A-4.3 Calls on LegionClass
A-4.4 Calls on file and context objects
A-4.5 Start-up and shutdown functions
A-4.6 Scheduling support
A-4.7 General functions about the state of the system
A-4.8 Security
A-4.9 Application development
A-4.10 Program support

Getting help
References
Index


The Legion Group
Department of Computer Science
School of Engineering & Applied Science
University of Virginia
151 Engineer's Way, P.O. Box 400740
Charlottesville, VA 22904-4740
legion@virginia.edu
http://legion.virginia.edu/

Directory of Legion 1.6.3 Manuals
[Home] [General] [Documentation] [Software]
[Testbeds] [Et Cetera] [Map/Search]

Free JavaScripts provided by The JavaScript Source

legion@Virginia.edu
http://legion.virginia.edu/