← Back to branch summary

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

« back to all changes in this revision

Viewing changes to platform/README

  • Committer: matt.giuca
  • Date: 2009-01-14 10:10:12 UTC
  • mto: This revision was merged to the branch mainline in revision 1090.
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:branches%2Fstorm:1132
The new ivle.database.User class is now used in Request and usrmgt, which
    means it is now almost universally used in favour of ivle.user.User (now
    deprecated).

Noticeable change: The minor bug where the change to a user object in the
    database is not reflected in the user's session (eg. changing nick doesn't
    update title until log out).

ivle.dispatch:
    Session now contains 'login' (username string) rather than 'user' (full
        ivle.user.User object). This is a unicode string now.

    req.user is now a ivle.database.User object rather than an ivle.user.User
        object. This makes for a whole lot of really subtle differences, but
        largely conforms to the same interface. Note that strings must now all
        be unicode.

    login: Removed use of ivle.db. Now uses User object.

    html: Now handles unicode login and config options.

ivle.db: Removed update_user. Now replaced with Storm model.

ivle.database: Renamed has_cap back to hasCap (saved for later). Fixed small
    unicode bug.

ivle.makeuser.make_svn_auth now takes a store object.

usrmgt-server: Use new User class.

userservice: Now uses User class internally.
    get_user action now returns ISO 8601 date format, rather than a
        time tuple. (Wasn't being used).
    get_user action no longer transmits local_password (small security risk;
        note that it wasn't possible to see this for any user other than
        yourself unless admin).

ivle.util - added function object_to_dict.

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