← Back to branch summary

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

« back to all changes in this revision

Viewing changes to platform/README

  • Committer: William Grant
  • Date: 2010-02-11 05:27:24 UTC
  • Revision ID: grantw@unimelb.edu.au-20100211052724-171m0779yqzn1y1x
Add a setup.cfg with nose settings. You can now run the suite with 'IVLECONF=. nosetests'.

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.
81
 
 
82
 
Adding New Users
83
 
================
84
 
 
85
 
TODO - automate all this.
86
 
 
87
 
1. Create a subversion respository by adding
88
 
    [jdoe:/]
89
 
    jdoe=rw
90
 
  to the /home/informatics/config/svn-authz file.
91
 
 
92
 
2. Create a chroot jail (using the mkJail.sh script).
93
 
 
94
 
3. Initialize the svn repository with the commands
95
 
    cd /home/informatics/jails/jdoe/home/jdoe
96
 
    mkdir svn
97
 
    cd svn
98
 
    svn co <url to repository>/jdoe
99
 
    cd jdoe
100
 
    svn mkdir trunk
101
 
    svn ci
102
 
 
103
 
4. Create the symlinks so that the webserver can find the python code:
104
 
    cd /home/informatics/www
105
 
    ln -s /home/informatics/jails/jdoe/home/jdoe/svn/jdoe/trunk jdoe
106
 
 
107
 
5. Add authentication with htpasswd:
108
 
    htpasswd -m /home/informatics/config/digest jdoe
109