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

« back to all changes in this revision

Viewing changes to doc/dependencies.txt

[Uber-commit of holiday work because I lacked a local copy of the branch.]

 ivle.makeuser: Don't use jailconf.py as a header for the in-jail conf.py;
     generate the whole thing using string formatting operators and include
     the template inline.

 ivle.makeuser.make_conf_py: XXX the inclusion of ivle.conf.jail_base in
     the jail. It is simply there to placate ivle.studpath, and needs
     to go before we can entirely remove the in-jail config.

 ivle-buildjail:
   - Add. Converted from setup.buildjail.
   - Build the jail in __base_build__ and rsync it to __base__ when
     done, rather than operating only in ./jail
   - Rename --rebuildjail/-j to --recreate/-r, as the whole script
     is now for jail rebuilding. Also add a warning to the usage string about
     the large volume likely to be downloaded.
   - Check existence before removing trees.
   - Don't copy jailconf.py over conf.py in the jail. Also make
     sure that we remove conf.pyc.

 setup.configure:
   - Stop generating jailconf.py at all.
   - Add a jail_system_build setting, defaulting to __base_build__ next to
     the existing __base__.
   - Don't use an OptionParser before calling the real function, as that
     adds options dynamically.

 setup.install:
   - Add an option (-R) to avoid writing out svn revision info to
     $PREFIX/share/ivle/revision.txt.
   - Remove jail-copying things.
   - Install all services to the host, rather than just usrmgt-server. We do
     this so we can build the jail from the host without the source tree.
   - Shuffle some things, and don't install phpBB3 twice.
   - Add a --root argument, to take an alternate root directory to install
     into (as given to autotools in $DESTDIR).

 setup.build:
   - Allow running as non-root.
   - Take a --no-compile option to not byte-compile Python files.

 setup.util:
   - Include usrmgt-server in the list of services.
   - Add make_install_path(), a wrapper around os.path.join() that ensures
     the second path is relative.
   - Install ivle-buildjail with the other binaries.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
 
4
4
IVLE requires the following:
5
5
 
6
 
* Linux (similar Unices may work but not guaranteed; we pull out some
7
 
    linux-specific libraries into our jail so may need customization,
8
 
    particularly of setup.py).
9
 
 
 
6
* Ubuntu Linux 7.04 or later (see note)
10
7
* Python 2.5
11
8
* Apache HTTP server
12
9
* mod_python
 
10
* PostgreSQL
 
11
 
 
12
The setup program also requires:
 
13
 
 
14
* GCC
 
15
* Make
 
16
* Debootstrap
 
17
 
 
18
Note: While the developers have made every effort to ensure IVLE is compatible
 
19
with all POSIX-compliant operating systems, our setup procedure is currently
 
20
tailored to Ubuntu Linux. The default install builds a jail based on the Ubuntu 
 
21
APT system, but this could be fairly easily modified to work with other APT 
 
22
systems which support debootstrap.
 
23
 
 
24
Getting IVLE running on another Unix system that doesn't support APT would 
 
25
require getting the equivilent packages using the local package system and 
 
26
modifying buildjail.sh to bootstrap a new jail.
 
27
 
 
28
At this stage we can only officially recommend Ubuntu 8.04 or later.  
 
29
(Previously supported 7.04 and 7.10, but the APT repositoryies lack important 
 
30
packages which had to be manually installed).
 
31
 
 
32
Ubuntu Install Procedure
 
33
------------------------
 
34
 
 
35
This document merely summarises the required modules. A step-by-step install
 
36
procedure for Ubuntu is located in trunk/doc/setup/install_proc.txt.
13
37
 
14
38
Python Libraries
15
39
----------------
18
42
site packages directory:
19
43
 
20
44
* [cjson](http://cheeseshop.python.org/pypi/python-cjson)
21
 
* [web.py](http://webpy.org/)
 
45
* [pygresql](http://www.pygresql.org/)
22
46
* [pysvn](http://pysvn.tigris.org/)
 
47
 
 
48
All of these can be installed by Ubuntu's package management system. See
 
49
trunk/doc/setup/install_proc.txt for details.
 
50
 
 
51
Additionally, these libraries are installed by the setup script for the
 
52
purposes of student code using them:
 
53
 
 
54
* [matplotlib](http://matplotlib.sourceforge.net/)
 
55
* [nltk](http://nltk.sourceforge.net)
 
56
* [BeautifulSoup](http://www.crummy.com/software/BeautifulSoup)
 
57
* [lxml](http://codespeak.net/lxml/)
 
58
* [PIL](http://www.pythonware.com/products/pil/)
 
59
* [elementtree](http://effbot.org/zone/elementtree-13-intro.htm) - 1.3 ALPHA
 
60
* [simpletal](http://www.owlfish.com/software/simpleTAL/)
 
61
* [scipy](http://www.scipy.org)