~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-07-07 12:01:03 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:820
lib: Added new package pulldown_subj, a collection of modules designed to
    pull student subject enrolments from the server.
    Note that the actual code to do this is not included (since that is
    specific to the organisation running IVLE) - just a pluggable interface
    and an example plugin module.
configure.py: Added new config option: subject_pulldown_modules, which allows
    you to specify which modules are plugged in here.
    (Actually that was added accidentally in a previous commit; but this
    revision fixes some comments).

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
# Installation Procedure for IVLE
2
2
# ===============================
3
3
 
4
 
# Target Machine: Ubuntu (Versions 6.06 and 7.10 - differences between
5
 
# versions noted)
 
4
# Target Platform: Ubuntu 8.04
6
5
#
7
6
# IMPORTANT: This is NOT a shell script. It has interactive sections and
8
7
# things that need to be customized.
17
16
# Author: Matt Giuca
18
17
# Date: 29/1/2008
19
18
 
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
 
 
 
19
##########################################################################
39
20
# Apt packages
 
21
##########################################################################
 
22
 
40
23
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
 
 
 
24
sudo apt-get install gcc libc6 libc6-dev make debootstrap
 
25
sudo apt-get install apache2 libapache2-mod-python libapache2-svn
 
26
sudo apt-get install python2.5-dev python-svn python-webpy
 
27
sudo apt-get install postgresql python-pygresql python-ldap
 
28
sudo apt-get install php5 php5-pgsql
 
29
sudo apt-get install python-cjson
 
30
sudo apt-get install python-docutils python-epydoc
 
31
 
 
32
##########################################################################
 
33
# Configure postgres
 
34
##########################################################################
 
35
#
 
36
# Some of these instructions follow
 
37
#     https://help.ubuntu.com/community/PostgreSQL
 
38
# 1. install the base packages
 
39
 
 
40
# Set the postgres user's postgres password
 
41
sudo -u postgres psql template1
 
42
# At the prompt type (substituting <***password***> with a real one.
 
43
ALTER USER postgres WITH ENCRYPTED PASSWORD '<***password***>';
 
44
\q
 
45
 
 
46
##########################################################################
 
47
# Installing ivle
 
48
##########################################################################
 
49
#
78
50
# 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.
 
51
 
 
52
export IVLE_SVN=ivle_svn
 
53
svn co https://ivle.svn.sourceforge.net/svnroot/ivle/trunk $IVLE_SVN
 
54
cd $IVLE_SVN
 
55
 
 
56
# Create a postgres database
 
57
# (only need the first line if it was previously created and is now changed)
 
58
sudo -u postgres dropdb ivle
 
59
sudo -u postgres createdb ivle
 
60
sudo -u postgres psql -d ivle < userdb/users.sql
85
61
 
86
62
# Set up IVLE
87
 
cd ivle_svn
88
63
./setup.py listmake
89
64
./setup.py config
90
65
 
91
 
# "Root directory" - type "/"
 
66
# "Root directory" - type "/" or "/ivle" (without the quotes)
92
67
# "UID of web server process" - 1000 at this stage (informatics)
93
68
# Leave others default.
94
69
# Note: This will cause IVLE to get installed to /opt/ivle
96
71
./setup.py build
97
72
sudo ./setup.py install
98
73
 
 
74
# Make the directory containing the svn auth.
 
75
# Make sure it is owned by www-data.
 
76
sudo mkdir /opt/ivle/svn
 
77
sudo chown -R www-data:www-data /opt/ivle/svn
 
78
 
 
79
# Make the "repositories" and "sessions" directories in the home.
 
80
# Make sure they are owned by www-data.
 
81
cd /home/informatics
 
82
sudo mkdir repositories sessions
 
83
sudo chown -R www-data:www-data repositories sessions
 
84
 
99
85
# Create a user
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.
 
86
sudo ./makeuser.py [OPTIONS] <login> 'Firstname Lastname' <rolenm> -p <password>
 
87
# role = guest/student/tutor/lecturer/admin
 
88
 
 
89
# Configure the Apache HTTP server
 
90
sudo cp doc/setup/ivle-both.conf /etc/apache2/sites-available/ivle.conf
107
91
# MODIFY the first few lines so it is specific to your server.
 
92
# * Change ServerAdmin and ServerName (for error reporting).
 
93
# * Inside the first VirtualHost block, there are two ServerNames
 
94
#   (localhost and public.localhost). You must change these to the domains
 
95
#   for regular IVLE and published-browsing IVLE respectively.
 
96
# * Inside the second VirtualHost block, there is one ServerName
 
97
#   (svn.localhost). You must change this to the domain for svn access.
 
98
# * Change all paths beginning with /opt/ivle or /home/informatics to the
 
99
#   locations you have installed things in.
 
100
vim /etc/apache2/sites-available/ivle.conf
108
101
 
109
102
# Replace the existing config link with the ivle one
110
103
cd /etc/apache2/sites-enabled/
111
104
sudo ln -fs /etc/apache2/sites-available/ivle.conf 000-default
112
105
 
 
106
# Make sure the 3 domains given in Apache conf all lookup to your server.
 
107
# (By default these are localhost, public.localhost and svn.localhost).
 
108
# For testing purposes, this can be done by editing /etc/hosts, for example:
 
109
127.0.0.1       public.localhost
 
110
127.0.0.1       svn.localhost
 
111
 
113
112
# Restart the server
114
113
sudo apache2ctl -k restart
115
114
 
116
 
#
117
 
# Installing postgres
118
 
# ===============================
119
 
#
120
 
# Some of these instructions follow
121
 
#     https://help.ubuntu.com/community/PostgreSQL
122
 
# 1. install the base packages
123
 
 
124
 
sudo apt-get install postgresql
125
 
sudo apt-get install python-pygresql
126
 
 
127
 
# Set the postgres user's postgres password
128
 
sudo -u postgres psql template1
129
 
# At the prompt type (substituting <***password***> with a real one.
130
 
ALTER USER postgres WITH ENCRYPTED PASSWORD '<***password***>';
131
 
\q
132
 
 
133
 
# Create a database
134
 
cd <<ivle source directory>>/userdb
135
 
sudo -u postgres createdb ivle
136
 
sudo -u postgres psql -d ivle < users.sql
137
 
 
138
 
#
139
 
# Installing Pound
 
115
##########################################################################
 
116
# User management server: usrmgt-server
 
117
##########################################################################
 
118
# To start the user management server:
 
119
cd /opt/ivle/scripts
 
120
sudo ./usrmgt-server <port> <usrmgt-password>
 
121
# usrmgt-password is the password entered in setup.py config (usrmgt_magic)
 
122
# Note that the port number and usrmgt password are recorded in
 
123
# the automatically created init.d script: doc/setup/usrmgt-server.init
 
124
 
 
125
# To run it at boot time:
 
126
sudo cp doc/setup/usrmgt-server.init /etc/init.d/usrmgt-server
 
127
sudo chown root:root /etc/init.d/usrmgt-server
 
128
sudo chmod 700 /etc/init.d/usrmgt-server  # so world can't read database magic
 
129
sudo update-rc.d usrmgt-server defaults 99  # create symlinks in /etc/rc*.d
 
130
 
 
131
##########################################################################
 
132
# Setting up phpBB Forum in IVLE
 
133
##########################################################################
 
134
# This should all be run from the SVN directory
 
135
 
 
136
# Create a postgres database
 
137
# (only need the first line if it was previously created and is now changed)
 
138
sudo -u postgres dropdb ivle_forum
 
139
sudo -u postgres createdb ivle_forum
 
140
sudo -u postgres psql -d ivle_forum < userdb/forum_schema.sql
 
141
sudo -u postgres psql -d ivle_forum < userdb/forum_data.sql
 
142
 
 
143
#Change to the installed IVLE directory
 
144
cd /opt/ivle
 
145
# Fix permissions for install
 
146
cd www/php/phpBB3
 
147
# At very minimum you apache user must be able to write to
 
148
# cache/ files/ store/ images/avatars/upload config.php
 
149
sudo chown -R www-data:www-data .
 
150
 
 
151
##########################################################################
 
152
# Installing Pound reverse proxy (optional)
 
153
##########################################################################
 
154
 
140
155
sudo apt-get install pound
141
156
 
142
157
# edit /etc/default/pound so that the line reading
145
160
#     startup=1
146
161
#
147
162
# copy pound.cfg to /etc/pound/pound.cfg
 
163
# edit IP addresses in pound.cfg