Legion 1.8
System Administrator Manual

Before you start

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

Installing and running Legion

2.0Downloading Legion 1.8 8
2.1Legion structure 9
2.2Space requirements 9
2.3Software requirements 9
2.4RSA and OpenSSL 10
2.5Downloading binary files 10
3.0Starting a new system 12
3.1Before you start 12
3.2Set up the environment 14
3.3Starting a single host system 15
3.3.1 Choose a bootstrap host 15
3.3.2 Set up and configure 15
3.3.3 Start up 16
3.3.4 Initialize 17
3.3.5 Set security 19
3.3.6 Starting up other packages 21
3.4Starting a multihost system 21
3.4.1 Set up 21
3.4.2 Create a new vault 22
3.4.3 Create a new host 22
3.4.4 Adding new users to a secure net 23
3.4.5 Working in the new net 24
3.5Making a set-up script for users 24
4.0System shutdown 26
4.1Shutting down an insecure system 26
4.2Shutting down a secure system 26
5.0System restart 27
6.0Summary of commands 28
6.1Starting a new system 28
6.2Start working in a running system 28
6.3Shutdown 29
6.4Restart 29

Legion security

7.0About Legion security 30
7.1Message layer 30
7.2MayI layer 31
7.3Special implications of security 33
7.4Legion and Kerberos 33
7.5Session file 34
8.0Using security features 35
8.1Authentication objects 35
8.2Security and context space 36
8.3Creating new users 37
8.4Logging in users 38
8.5Changing user passwords 38
8.6Changing implicit parameters and ACL information 38

Legion system management

9.0Legion core objects 42
9.1Core objects classes 42
10.0 Implementation model 44
10.1 Implementation caches 45
10.2 Implementation tools 46
11.0 Host and vault objects 49
11.1 About host-vault pairs 49
11.2 Manipulating host-vault pairing 51
11.3 Adding a new host 52
11.3.1 legion_starthost flags 54
11.3.2 The host object's log 56
11.4 Adding a new vault 56
11.4.1 legion_startvault flags 57
11.5 Backup vaults 57
12.0 Process control daemon host objects 59
12.1 Adding a PCD host object 59
12.1.1 Configure the daemon 59
12.1.2 Start the daemon and the host object 61
12.2 PCD host commands 62
12.2.1 Adding a new account 62
12.2.2 Removing an account 64
12.2.3 Viewing available accounts 64
12.3 How the PCD host object works 64
12.4 Using a PCD host as your bootstrap host 65
13.0 Batch queue host objects 66
13.1 Starting a batch queue host object 66
13.2 Setting the local queue 66
13.3 Before running objects on the new host 67
13.4 Troubleshooting 67
14.0 Virtual hosts 69
15.0 Setting up a native MPI host 72
16.0 Legion domains 73
16.1 Naming Legion domains 73
16.2 Domains and binding services 73
16.3 Joining domains 74
16.4 Related commands 75
16.4.1 Listing currently connected domains 75
16.4.2 Generating cookies 76
16.4.3 Displaying cookies 76
16.4.4 Connecting domains 76
17.0 Resource management 77
17.1 Scheduling-related commands 77
17.1.1 Configuring the scheduler 77
17.1.2 Setting a class's default scheduler 78
17.1.3 Setting scheduler policy 78
17.1.4 Adding resources to a collection 78
17.1.5 Subcollections 79

Getting help 80

Index 81

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/