Legion 1.7 Basic User Manual

Before you start

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

Getting started

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

Context space

3.0An introduction to context space
4.0Context space
4.1Legion object names
4.2About the LOID
4.3Organizing context space
5.0Working in context space
5.1Viewing contexts
5.1.1View a context's contents
5.1.2Look up LOIDs
5.1.3Create a new context
5.1.4Change the working context
5.1.5Check your current working context
5.2Naming objects
5.2.1Give an object extra context names
5.2.2Assign a context name to a LOID
5.2.3Change an object's context path
5.2.4List context names
5.2.5Remove names and objects
5.2.6Use the same name in different contexts
5.3Moving between local files and contexts
5.3.1Copying
5.3.1.1Copy a local file to a Legion file object
5.3.1.2Copy a Legion file object to a local file
5.3.1.3Copy a Legion file object to another Legion file object
5.3.1.4Using wildcards
5.3.2Viewing a file object's contents
5.3.3Importing a local Unix tree
5.3.4File sharing: temporarily link files to context space
6.0Host and vault objects
6.1What's a host/vault and a host/vault object?
6.2About the bootstrap host/vault
6.3Creating objects on new hosts
6.4Instance placement on hosts and vaults
6.5Backup vaults
6.5.1Assigning and synchronizing backup vaults
6.5.2Using replication
6.5.3WORM objects

Running applications

7.0Running a Legion application
8.0Executing programs remotely
8.1Introduction
8.2Linked and independent programs
8.3Registering independent programs
8.4Registering Legion-linked programs
8.5Running a program remotely
8.5.1Choosing a remote host
8.5.2Command-line arguments
8.5.3Getting input files to the remote host
8.5.3.1Before the program starts
8.5.3.2After the program has started
8.5.4Getting output files from the remote host
8.5.4.1Before the program starts
8.5.4.2After the program has started
8.5.5Option file
8.5.6Creating and using a probe file
8.5.7Blocking vs. nonblocking
8.5.8About legion_probe_run
8.5.9Context scratch space
8.5.10Retrieving files from context scratch space
8.6Example
8.7Converting a C/C++ program
9.0PVM
9.1Core PVM interface
9.2Tids & LOIDs
9.3Task classes
9.4Installing PVM-Legion
9.5Compilation
9.6Registering compiled tasks
9.7Examples
9.8Running PVM code with the fewest changes
10.0MPI
10.1Legion MPI
10.1.1Task classes
10.1.2Installing Legion MPI
10.1.3Compilation
10.1.4Register compiled tasks
10.1.5Running the MPI application
10.1.6Example
10.1.7Input and output files
10.1.7.1Flags
10.1.7.2Subroutines
10.1.8Scheduling MPI processes
10.1.9Debugging support
10.1.10Checkpointing support
10.1.10.1Example
10.1.10.2API (C & Fortran)
10.1.10.3Running the above example
10.1.10.4Recovering from failure
10.1.10.5Restarting application
10.1.10.6Compiling/makefile
10.1.10.7Another example
10.1.10.8Limitations
10.1.11Functions supported
10.1.12Running a Legion MPI code with the fewest changes
10.2Native MPI
10.2.1Task classes
10.2.2Compilation
10.2.3Register compiled tasks
10.2.4Running a native MPI application
10.2.5Making Legion calls from native MPI programs
10.2.6Example
10.2.7Scheduling native MPI processes
11.0Replaying & debugging applications
11.1Sample record and replay

Appendices

A-1Sample makefile
A-2About Legion tty objects
A-2.1 Simple tty management
A-2.2 Complex tty management
A-3Alphabetical list of Legion commands
A-4Subject 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.7 Manuals
[Home] [General] [Documentation] [Software]
[Testbeds] [Et Cetera] [Map/Search]

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