← 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

  • Committer: mattgiuca
  • Date: 2008-01-31 01:44:30 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:345
Global CSS change: ivlebody no longer has 1em of padding (it has none).
This is because most apps were disabling it (and it had to change anyway for
other reasons -- see below).

Hence, all apps which WERE disabling the padding have had that removed, and
just work by default. (console, browser, tutorial)
All apps which WEREN'T disabling the padding (very few) now have to manually
include an extra div. This has been done on all such apps, and has been
heavily documented (both in the CSS file and doc/app_howto). (help, dummy,
debuginfo).

media/common/ivle.css: 
    The real change here (which isn't yet being used) is that ivlebody is now
    positioned absolutely and takes up all the space on the canvas. This is
    to be used for full-page layouts in console and browser.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/setup/install_proc.txt
1
1
# Installation Procedure for IVLE
2
2
# ===============================
3
3
 
4
 
# Target Platform: Ubuntu 8.04+
 
4
# Target Machine: Ubuntu (Versions 6.06 and 7.10 - differences between
 
5
# versions noted)
5
6
#
6
7
# IMPORTANT: This is NOT a shell script. It has interactive sections and
7
8
# things that need to be customized.
10
11
 
11
12
# While other install guides in this package are generic, this one is very
12
13
# 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
# set up IVLE on Ubuntu 7.06 or higher; less helpful for other platforms.
14
15
# This refers to ivle.conf, also included.
15
16
#
16
17
# Author: Matt Giuca
17
18
# Date: 29/1/2008
18
19
 
19
 
##########################################################################
 
20
sudo vim /etc/apt/sources.list
 
21
 
 
22
# 7.10 (Gutsy) specific #
 
23
 
 
24
# Gutsy by default had the CD-ROM packages selected, and the Internet packages
 
25
# commented out. (A comment in the apt sources list said it was because it
 
26
# failed to verify - IMPORTANT?? Probably not.)
 
27
# Comment out line 4 (deb cdrom:...)
 
28
 
 
29
# End 7.10 (Gutsy) specific #
 
30
 
 
31
# Uncomment ALL the lines for main, restricted and universe
 
32
# (deb http:...gutsy main restricted, deb-src ... main restricted
 
33
# deb http:...gutsy universe)
 
34
# Universe is important for pysvn (python-svn) later on
 
35
# :wq
 
36
 
 
37
sudo apt-get update
 
38
 
20
39
# 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
 
                     python-configobj postgresql 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
 
# Create a postgres database
42
 
# (only need the first line if it was previously created and is now changed)
43
 
sudo -u postgres dropdb ivle
44
 
sudo -u postgres createdb ivle
45
 
sudo -u postgres createlang plpgsql ivle
46
 
sudo -u postgres psql -d ivle < userdb/users.sql
 
40
sudo apt-get install subversion
 
41
sudo apt-get install gcc libc6 libc6-dev
 
42
# On 6.06 (Dapper):
 
43
sudo apt-get install python2.4-dev
 
44
# On 7.10 (Gutsy):
 
45
sudo apt-get install python2.5-dev
 
46
 
 
47
# Python packages needed by IVLE or student code
 
48
# See trunk/doc/dependencies.txt
 
49
wget 'http://pypi.python.org/packages/source/p/python-cjson/python-cjson-1.0.5.tar.gz'
 
50
 
 
51
tar -zxvf python-cjson-1.0.5.tar.gz
 
52
 
 
53
cd python-cjson-1.0.5
 
54
./setup.py build
 
55
sudo ./setup.py install
 
56
cd ..
 
57
 
 
58
# 6.06 (Dapper) specific
 
59
wget 'http://webpy.org/static/web.py-0.22.tar.gz'
 
60
tar -zxvf web.py-0.22.tar.gz
 
61
cd webpy
 
62
python ./setup.py build
 
63
sudo python ./setup.py install
 
64
cd ..
 
65
 
 
66
sudo apt-get install python-svn python-webpy python2.4-gtk2 python-matplotlib
 
67
# End 6.06 (Dapper) specific
 
68
 
 
69
# 7.10 (Gutsy) specific
 
70
sudo apt-get install python-svn python-webpy python-numpy python-matplotlib
 
71
# Note: I had a lot of trouble with the python-svn package.
 
72
# After playing around a bit it started working.
 
73
# python -c 'import pysvn'
 
74
# to test if it worked.
 
75
# Do Not install python-svn-dbg.
 
76
# End 7.10 (Gutsy) specific
 
77
 
 
78
# Check out the IVLE trunk
 
79
svn co https://ivle.svn.sourceforge.net/svnroot/ivle/trunk ivle_svn
 
80
# Says the SourceForge certificate authority is not trusted.
 
81
# I chose "Accept (p)ermanently" - Problem??
 
82
 
 
83
# NOTE: From this point onwards it is 7.10 (Gutsy) specific. This is because I
 
84
# never was able to get IVLE to build with all dependencies on Dapper.
47
85
 
48
86
# Set up IVLE
 
87
cd ivle_svn
 
88
./setup.py listmake
 
89
./setup.py config
 
90
 
 
91
# "Root directory" - type "/"
 
92
# "UID of web server process" - 1000 at this stage (informatics)
 
93
# Leave others default.
 
94
# Note: This will cause IVLE to get installed to /opt/ivle
 
95
 
49
96
./setup.py build
50
97
sudo ./setup.py install
51
98
 
52
 
sudo ivle-config
53
 
sudo ivle-createdatadirs
54
 
 
55
 
# Create the jail. The mirror option is optional.
56
 
sudo ivle-buildjail -r -m http://url.to.archive/mirror
57
 
 
58
99
# Create a user
59
 
sudo ivle-makeuser [OPTIONS] <login> 'Firstname Lastname' <rolenm> -p <password>
60
 
# role = guest/student/tutor/lecturer/admin
61
 
 
62
 
# Configure the Apache HTTP server
63
 
sudo cp doc/setup/ivle-both.conf /etc/apache2/sites-available/ivle
 
100
sudo ./makeuser.py <username>
 
101
 
 
102
# Set up the Apache HTTP server
 
103
sudo apt-get install apache2 libapache2-mod-python
 
104
 
 
105
# DO: Copy the file "ivle.conf" from this package to
 
106
# /etc/apache2/sites-available.
64
107
# MODIFY the first few lines so it is specific to your server.
65
 
# * Change ServerAdmin and ServerName (for error reporting).
66
 
# * Inside the first VirtualHost block, there is a ServerName and ServerAlias
67
 
#   (localhost and public.localhost). You must change these to the domains
68
 
#   for regular IVLE and published-browsing IVLE respectively.
69
 
# * Inside the second VirtualHost block, there is one ServerName
70
 
#   (svn.localhost). You must change this to the domain for svn access.
71
 
sudo vim /etc/apache2/sites-available/ivle
72
 
 
73
 
# Replace the default with the IVLE site.
74
 
sudo a2dissite default
75
 
sudo a2ensite ivle
76
 
 
77
 
# Restart Apache.
78
 
sudo /etc/init.d/apache2 restart
79
 
 
80
 
# Make sure the 3 domains given in Apache conf all lookup to your server.
81
 
# (By default these are localhost, public.localhost and svn.localhost).
82
 
# For testing purposes, this can be done by editing /etc/hosts, for example:
83
 
# 127.0.0.1     svn.localhost public.localhost
84
 
sudo vim /etc/hosts
85
 
 
86
 
##########################################################################
87
 
# User management server: usrmgt-server
88
 
##########################################################################
89
 
 
90
 
sudo cp doc/setup/usrmgt-server.init /etc/init.d/usrmgt-server
91
 
sudo chown root:root /etc/init.d/usrmgt-server
92
 
sudo chmod +x /etc/init.d/usrmgt-server
93
 
 
94
 
# To start it now:
95
 
sudo /etc/init.d/usrmgt-server start
96
 
 
97
 
# To run it at boot time:
98
 
sudo update-rc.d usrmgt-server defaults 99  # create symlinks in /etc/rc*.d
 
108
 
 
109
# Replace the existing config link with the ivle one
 
110
cd /etc/apache2/sites-enabled/
 
111
sudo ln -fs /etc/apache2/sites-available/ivle.conf 000-default
 
112
 
 
113
# Restart the server
 
114
sudo apache2ctl -k restart