← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to platform/README

  • Committer: drtomc
  • Date: 2007-12-04 01:57:41 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:3
A README file describing sundry bits of the platform infrastructure.

Show diffs side-by-side

added added

removed removed

Lines of Context:
platform/README
 
1
README for the Informatics Virtual Learning Environment
 
2
 
 
3
The IVLE back end consists of the following pieces:
 
4
 
 
5
1. A lighttpd instance for the sandboxed execution of students' python code.
 
6
 
 
7
2. An apache (2.2) instance for managing a set of subversion (SVN) repositories
 
8
   (one per student).
 
9
 
 
10
3. A chroot jail per student which contains the following:
 
11
    a. A minimal standard environment containing a standard set of directories
 
12
       and hard links to a standard set of files (binaries, libraries, python
 
13
       code).
 
14
    b. A working copy (checked out version) of the student's SVN repository.
 
15
       This may include branches for submission and public access, though
 
16
       initially, it will only include the trunk.
 
17
    c. A working directory into which the student's programs may write files.
 
18
 
 
19
4. A SVN hook to automatically update the repository of a student when [s]he
 
20
   commits a change to his/her repository.
 
21
 
 
22
Authentication & Authorization
 
23
==============================
 
24
 
 
25
Authentication is to be done against centaur (the IS LDAP server), however
 
26
apache 2.2 cannot connect to it because the CA issued by IS is incorrect. If
 
27
there is a way to work around this, we don't know it at the moment. Until
 
28
we are able to use LDAP (or Active Directory), the configuration of the web
 
29
servers uses a password file located in the config directory.
 
30
 
 
31
Filesystem Layout
 
32
=================
 
33
 
 
34
The installation of the informatics infrastructure is rooted at
 
35
    /home/informatics/
 
36
with the following subdirectories:
 
37
 
 
38
/home/informatics/config
 
39
    All the configuration files - apache, lighttpd, etc.
 
40
 
 
41
/home/informatics/bin
 
42
    All the executables (i.e. scripts!).
 
43
 
 
44
/home/informatics/config/jail
 
45
    A directory containing all the template files and directories
 
46
    for creating a user's jail. The process of creating a jail copies
 
47
    the directory structure, then hard-links all the files.
 
48
 
 
49
/home/informatics/jails
 
50
    The directory containing for each student a chroot jail.
 
51
 
 
52
/home/informatics/jails/<name>
 
53
    The jail for the named student.
 
54
 
 
55
/home/informatics/jails/<name>/home/<name>/svn/trunk
 
56
    The working copy of his/her SVN repository for the named student.
 
57
 
 
58
/home/informatics/jails/<name>/home/<name>/svn/public
 
59
    The published work of the named student (does not require aaa)
 
60
 
 
61
/home/informatics/jails/<name>/home/<name>/svn/submitted
 
62
    The submitted work for the named student.
 
63
 
 
64
/home/informatics/jails/<name>/run
 
65
    The starting working directory when the named student's python
 
66
    scripts are run.
 
67
 
 
68
/home/informatics/www
 
69
    The root directory for the www view of things.
 
70
 
 
71
/home/informatics/www/home/<name>
 
72
    A symbolic link to /home/informatics/jails/<name>/home/<name>/svn/trunk.
 
73
    This allows the CGI module to see the python scripts for the named user.
 
74
    Access to this via the web is restricted to *authenticated* users.
 
75
 
 
76
/home/informatics/www/public/<name>
 
77
    A symbolic link to /home/informatics/jails/<name>/home/<name>/svn/public.
 
78
    This allows the CGI module to see the python scripts for the named user.
 
79
    This {will be,is} where the published work for the named student will be
 
80
    located.