← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/setup/install_proc.txt

Modified the database so that exercises are now stored in the database, rather
than in flat files.

This also necessitated adding new tables and storm classes for test suites
and test cases.

Note that this commit merely changes the database and adds a script to
upload exercises. The code for actually reading exercises has yet
to be changed.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/setup/install_proc.txt
 
1
# Installation Procedure for IVLE
 
2
# ===============================
 
3
 
 
4
# Target Platform: Ubuntu 8.04
 
5
#
 
6
# IMPORTANT: This is NOT a shell script. It has interactive sections and
 
7
# things that need to be customized.
 
8
# It is written like a shell script so it can be mostly cut-and-pasted into
 
9
# the shell, but it can't simply be executed.
 
10
 
 
11
# While other install guides in this package are generic, this one is very
 
12
# specific to our intended configuration. It will be very helpful if trying to
 
13
# set up IVLE on Ubuntu 8.04 or higher; less helpful for other platforms.
 
14
# This refers to ivle.conf, also included.
 
15
#
 
16
# Author: Matt Giuca
 
17
# Date: 29/1/2008
 
18
 
 
19
##########################################################################
 
20
# Apt packages
 
21
##########################################################################
 
22
sudo apt-get install rsync subversion build-essential debootstrap       \
 
23
                     apache2 libapache2-mod-python libapache2-svn       \
 
24
                     python-svn python-cjson python-genshi              \
 
25
                     postgresql php5 php5-pgsql python-routes           \
 
26
                     python-docutils python-epydoc                      \
 
27
                     python-storm python-psycopg2
 
28
 
 
29
##########################################################################
 
30
# Configure postgres
 
31
##########################################################################
 
32
 
 
33
# Set the postgres user's postgres password
 
34
# At the prompt type (substituting <***password***> with a real one).
 
35
sudo -u postgres psql -c "ALTER USER postgres WITH ENCRYPTED PASSWORD '<***password***>'"
 
36
 
 
37
##########################################################################
 
38
# Installing ivle
 
39
##########################################################################
 
40
#
 
41
# Check out the IVLE trunk
 
42
 
 
43
svn co https://ivle.svn.sourceforge.net/svnroot/ivle/trunk ivle_svn
 
44
cd ivle_svn
 
45
 
 
46
# Create a postgres database
 
47
# (only need the first line if it was previously created and is now changed)
 
48
sudo -u postgres dropdb ivle
 
49
sudo -u postgres createdb ivle
 
50
sudo -u postgres createlang plpgsql ivle
 
51
sudo -u postgres psql -d ivle < userdb/users.sql
 
52
 
 
53
# Set up IVLE
 
54
./setup.py config
 
55
 
 
56
# -j is required to rebuild all jails, not just do an update
 
57
sudo ./setup.py build -j
 
58
sudo ./setup.py install
 
59
 
 
60
# Create a user
 
61
sudo ivle-makeuser [OPTIONS] <login> 'Firstname Lastname' <rolenm> -p <password>
 
62
# role = guest/student/tutor/lecturer/admin
 
63
 
 
64
# Configure the Apache HTTP server
 
65
sudo cp doc/setup/ivle-both.conf /etc/apache2/sites-available/ivle
 
66
# MODIFY the first few lines so it is specific to your server.
 
67
# * Change ServerAdmin and ServerName (for error reporting).
 
68
# * Inside the first VirtualHost block, there are two ServerNames
 
69
#   (localhost and public.localhost). You must change these to the domains
 
70
#   for regular IVLE and published-browsing IVLE respectively.
 
71
# * Inside the second VirtualHost block, there is one ServerName
 
72
#   (svn.localhost). You must change this to the domain for svn access.
 
73
# * Change all paths beginning with /opt/ivle or /home/informatics to the
 
74
#   locations you have installed things in.
 
75
# * Update all of the paths to where you installed IVLE, if required.
 
76
sudo vim /etc/apache2/sites-available/ivle
 
77
 
 
78
# Replace the default with the IVLE site.
 
79
sudo a2dissite default
 
80
sudo a2ensite ivle
 
81
 
 
82
# Restart Apache.
 
83
sudo /etc/init.d/apache2 restart
 
84
 
 
85
# Make sure the 3 domains given in Apache conf all lookup to your server.
 
86
# (By default these are localhost, public.localhost and svn.localhost).
 
87
# For testing purposes, this can be done by editing /etc/hosts, for example:
 
88
# 127.0.0.1     svn.localhost public.localhost
 
89
sudo vim /etc/hosts
 
90
 
 
91
##########################################################################
 
92
# User management server: usrmgt-server
 
93
##########################################################################
 
94
 
 
95
sudo cp doc/setup/usrmgt-server.init /etc/init.d/usrmgt-server
 
96
sudo chown root:root /etc/init.d/usrmgt-server
 
97
sudo chmod +x /etc/init.d/usrmgt-server
 
98
 
 
99
# To start it now:
 
100
sudo /etc/init.d/usrmgt-server start
 
101
 
 
102
# To run it at boot time:
 
103
sudo update-rc.d usrmgt-server defaults 99  # create symlinks in /etc/rc*.d
 
104
 
 
105
##########################################################################
 
106
# Setting up phpBB Forum in IVLE
 
107
##########################################################################
 
108
# This should all be run from the SVN directory
 
109
 
 
110
# Create a postgres database
 
111
# (only need the first line if it was previously created and is now changed)
 
112
sudo -u postgres dropdb ivle_forum
 
113
sudo -u postgres createdb ivle_forum
 
114
sudo -u postgres psql -d ivle_forum < userdb/forum_schema.sql
 
115
sudo -u postgres psql -d ivle_forum < userdb/forum_data.sql