← 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-02-19 08:26:11 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:509
common.db: Rewrote user_authenticate to return 3 values (True, false, None)
    Now returns False if the password did not match, None if the password
    field is NULL (None implying a soft failure, with the possibility of
    validating against LDAP or something else).

auth.authenticate: Rewrote this module with a new plugin interface
    (as discussed with Tom Conway). Allows successive modules to try to
    authenticate the user.
    Changed the authenticate function interface: Now raises an AuthError
    when auth fails, instead of returning None.

dispatch.login: Handle new auth interface (exception catch).
    Auth is now able to provide an error message, in the exception.
    The exception message is displayed as an error to the user.

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 7.10
 
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 7.06 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
sudo vim /etc/apt/sources.list
 
20
 
 
21
# Gutsy by default had the CD-ROM packages selected, and the Internet packages
 
22
# commented out. (A comment in the apt sources list said it was because it
 
23
# failed to verify - IMPORTANT?? Probably not.)
 
24
# Comment out line 4 (deb cdrom:...)
 
25
 
 
26
# Uncomment ALL the lines for main, restricted and universe
 
27
# (deb http:...gutsy main restricted, deb-src ... main restricted
 
28
# deb http:...gutsy universe)
 
29
# Universe is important for pysvn (python-svn) later on
 
30
# :wq
 
31
 
 
32
##########################################################################
 
33
# Apt packages
 
34
##########################################################################
 
35
 
 
36
sudo apt-get update
 
37
sudo apt-get install subversion
 
38
sudo apt-get install gcc libc6 libc6-dev make
 
39
sudo apt-get install apache2 libapache2-mod-python
 
40
sudo apt-get install python2.5-dev python-svn python-webpy python-numpy python-matplotlib
 
41
sudo apt-get install postgresql python-pygresql
 
42
 
 
43
# Note: I had a lot of trouble with the python-svn package.
 
44
# After playing around a bit it started working.
 
45
# python -c 'import pysvn'
 
46
# to test if it worked.
 
47
# Do Not install python-svn-dbg.
 
48
 
 
49
##########################################################################
 
50
# Python packages needed by IVLE or student code
 
51
##########################################################################
 
52
#
 
53
# See trunk/doc/dependencies.txt
 
54
 
 
55
wget 'http://pypi.python.org/packages/source/p/python-cjson/python-cjson-1.0.5.tar.gz'
 
56
tar -zxvf python-cjson-1.0.5.tar.gz
 
57
 
 
58
cd python-cjson-1.0.5
 
59
./setup.py build
 
60
sudo ./setup.py install
 
61
cd ..
 
62
 
 
63
##########################################################################
 
64
# Configure postgres
 
65
##########################################################################
 
66
#
 
67
# Some of these instructions follow
 
68
#     https://help.ubuntu.com/community/PostgreSQL
 
69
# 1. install the base packages
 
70
 
 
71
# Set the postgres user's postgres password
 
72
sudo -u postgres psql template1
 
73
# At the prompt type (substituting <***password***> with a real one.
 
74
ALTER USER postgres WITH ENCRYPTED PASSWORD '<***password***>';
 
75
\q
 
76
 
 
77
##########################################################################
 
78
# Installing ivle
 
79
##########################################################################
 
80
#
 
81
# Check out the IVLE trunk
 
82
 
 
83
export IVLE_SVN=ivle_svn
 
84
svn co https://ivle.svn.sourceforge.net/svnroot/ivle/trunk $IVLE_SVN
 
85
cd $IVLE_SVN
 
86
 
 
87
# Create a postgres database
 
88
# (only need the first line if it was previously created and is now changed)
 
89
sudo -u postgres dropdb ivle
 
90
sudo -u postgres createdb ivle
 
91
sudo -u postgres psql -d ivle < userdb/users.sql
 
92
 
 
93
# Set up IVLE
 
94
./setup.py listmake
 
95
./setup.py config
 
96
 
 
97
# "Root directory" - type "/" or "/ivle" (without the quotes)
 
98
# "UID of web server process" - 1000 at this stage (informatics)
 
99
# Leave others default.
 
100
# Note: This will cause IVLE to get installed to /opt/ivle
 
101
 
 
102
./setup.py build
 
103
sudo ./setup.py install
 
104
 
 
105
# Create a user
 
106
sudo ./makeuser.py [OPTIONS] <login> 'Firstname Lastname' <rolenm> -p <password>
 
107
# role = guest/student/tutor/lecturer/admin
 
108
 
 
109
# Configure the Apache HTTP server
 
110
sudo cp doc/setup/ivle.conf /etc/apache2/sites-available
 
111
# MODIFY the first few lines so it is specific to your server.
 
112
vim /etc/apache2/sites-available/ivle.conf
 
113
 
 
114
# Replace the existing config link with the ivle one
 
115
cd /etc/apache2/sites-enabled/
 
116
sudo ln -fs /etc/apache2/sites-available/ivle.conf 000-default
 
117
 
 
118
# Make the directory corresponding to the directory for saved session
 
119
# objects in the apache config ivle.conf. Make sure it is owned by www-data,
 
120
# or at least readable and writable by it.
 
121
 
 
122
sudo mkdir /home/informatics/sessions
 
123
sudo chown www-data:www-data /home/informatics/sessions
 
124
 
 
125
# Restart the server
 
126
sudo apache2ctl -k restart
 
127
 
 
128
 
 
129
##########################################################################
 
130
# Installing Pound reverse proxy (optional)
 
131
##########################################################################
 
132
 
 
133
sudo apt-get install pound
 
134
 
 
135
# edit /etc/default/pound so that the line reading
 
136
#     startup=0
 
137
# instead reads
 
138
#     startup=1
 
139
#
 
140
# copy pound.cfg to /etc/pound/pound.cfg
 
141
# edit IP addresses in pound.cfg