1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
.. IVLE - Informatics Virtual Learning Environment
Copyright (C) 2007-2009 The University of Melbourne
.. This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.. This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.. You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
************
Installation
************
System requirements
===================
Given versions are those on which IVLE is known to work; earlier versions
might work too. Debian/Ubuntu package names are given after the name of the
software.
* Ubuntu 8.04 or later (other distros should work with some tweaking, but are untested)
* Apache 2.x with modules:
+ mod_python (``libapache2-mod-python``)
+ mod_dav_svn and mod_authz_svn (``libapache2-svn``)
* Python 2.5 or 2.6 with modules:
+ pysvn (``python-svn``)
+ cjson (``python-cjson``)
+ Genshi (``python-genshi``)
+ ConfigObj (``python-configobj``)
+ Routes (``python-routes``)
+ docutils (``python-docutils``)
+ epydoc (``python-epydoc``)
+ Storm (``python-storm``)
+ psycopg2 (``python-psycopg2``)
* jQuery (``libjs-jquery``)
* PostgreSQL 8.3 or later (``postgresql``)
* Subversion (``subversion``)
* debootstrap (``debootstrap``)
* GCC and related build machinery (``build-essential``)
Master versus slave servers
===========================
Installing from a Debian package
================================
Installing from source
======================
While installing from a distribution package is often a better idea for
users, developers will need to install from a plain source tree.
To get the tree, either grab and extract a release tarball, or get the
very latest code using bzr: ::
bzr get lp:ivle
You should then change into the new source directory.
As IVLE needs to compile some binaries, you must first build, then
install it: ::
./setup.py build
sudo ./setup.py install
Unlike the package, you will have to manually set up the database and
configuration.
.. TODO: Separate IVLE PostgreSQL account.
First you must create a PostgreSQL database, and populate it with the
IVLE schema. You may use any name for the database. ::
sudo -u postgres createdb ivle
sudo -u postgres createlang plpgsql ivle
sudo -u postgres psql -d ivle < userdb/users.sql
The configuration wizard - ``ivle-config`` - will ask you a series of
questions. Apart from database settings, the defaults should be correct
for a development system. If deploying IVLE properly - particularly on
multiple nodes - several options will need to be changed. Watching
carefully, run: ::
sudo ivle-config
Basic configuration
===================
.. Note: Place here only the configuration required to get the system
installed and running. Any further configuration should go in config.rst.
IVLE needs a directory hierarchy in which to store filesystem data, which
by default lives in ``/var/lib/ivle``. Create it now. ::
sudo ivle-createdatadirs
.. TODO: Setting jail/devmode, jail/suite, jail/extra_packages...
We also need to document setting of the default mirror, once
issue #150 is fixed.
You will require a self-contained jail environment in which to safely
execute student code. The creation process basically downloads a minimal
Ubuntu system and installs it in ``/var/lib/ivle/jails/__base__``. Note
that this could download a couple of hundred megabytes. You should
replace the URL with a good close Ubuntu mirror. ::
sudo ivle-buildjail -r -m http://url.to.archive/mirror
.. note::
For more advanced configuration, see :ref:`Configuring IVLE
<ref-configuring-ivle>`.
|