← 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: matt.giuca
  • Date: 2009-01-12 01:03:59 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:1077
Reverted revisions 1059 and 1069 - renaming the DB user from 'postgres' to
    'ivleuser'.
    Heart was in the right place, but currently doesn't work because postgres
    owns the relations and we've no way to correct that yet (since we manually
    run the .sql script as postgres).

    This will be reverted back again once that's solved.

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
                     python2.5-dev python-svn python-webpy python-cjson \
 
25
                     postgresql python-pygresql php5 php5-pgsql         \
 
26
                     python-docutils python-epydoc python-ldap
 
27
 
 
28
##########################################################################
 
29
# Configure postgres
 
30
##########################################################################
 
31
 
 
32
# Set the postgres user's postgres password
 
33
# At the prompt type (substituting <***password***> with a real one).
 
34
sudo -u postgres psql -c "ALTER USER postgres WITH ENCRYPTED PASSWORD '<***password***>'"
 
35
 
 
36
##########################################################################
 
37
# Installing ivle
 
38
##########################################################################
 
39
#
 
40
# Check out the IVLE trunk
 
41
 
 
42
svn co https://ivle.svn.sourceforge.net/svnroot/ivle/trunk ivle_svn
 
43
cd ivle_svn
 
44
 
 
45
# Create a postgres database
 
46
# (only need the first line if it was previously created and is now changed)
 
47
sudo -u postgres dropdb ivle
 
48
sudo -u postgres createdb ivle
 
49
sudo -u postgres createlang plpgsql ivle
 
50
sudo -u postgres psql -d ivle < userdb/users.sql
 
51
 
 
52
# Set up IVLE
 
53
./setup.py listmake
 
54
./setup.py config
 
55
 
 
56
# "Root directory" - type "/" or "/ivle" (without the quotes)
 
57
# "UID of web server process" - 1000 at this stage (informatics)
 
58
# Leave others default.
 
59
# Note: This will cause IVLE to get installed to /opt/ivle
 
60
 
 
61
sudo mkdir -p /home/informatics/{repositories/{users,groups},sessions,logs,jails,jailssrc}
 
62
sudo chown -R www-data:www-data /home/informatics/{repositories,sessions,logs}
 
63
 
 
64
# -j is required to rebuild all jails, not just do an update
 
65
sudo ./setup.py build -j
 
66
sudo ./setup.py install
 
67
 
 
68
# Make the directory containing the svn auth.
 
69
# Make sure it is owned by www-data.
 
70
sudo mkdir /opt/ivle/svn
 
71
sudo chown -R www-data:www-data /opt/ivle/svn
 
72
 
 
73
# Make the "repositories", "sessions" and "logs" directories in the home.
 
74
# Make sure they are owned by www-data.
 
75
 
 
76
# Create a user
 
77
sudo ./makeuser.py [OPTIONS] <login> 'Firstname Lastname' <rolenm> -p <password>
 
78
# role = guest/student/tutor/lecturer/admin
 
79
 
 
80
# Configure the Apache HTTP server
 
81
sudo cp doc/setup/ivle-both.conf /etc/apache2/sites-available/ivle
 
82
# MODIFY the first few lines so it is specific to your server.
 
83
# * Change ServerAdmin and ServerName (for error reporting).
 
84
# * Inside the first VirtualHost block, there are two ServerNames
 
85
#   (localhost and public.localhost). You must change these to the domains
 
86
#   for regular IVLE and published-browsing IVLE respectively.
 
87
# * Inside the second VirtualHost block, there is one ServerName
 
88
#   (svn.localhost). You must change this to the domain for svn access.
 
89
# * Change all paths beginning with /opt/ivle or /home/informatics to the
 
90
#   locations you have installed things in.
 
91
sudo vim /etc/apache2/sites-available/ivle
 
92
 
 
93
# Replace the default with the IVLE site.
 
94
sudo a2dissite default
 
95
sudo a2ensite ivle
 
96
 
 
97
# Restart Apache.
 
98
sudo /etc/init.d/apache2 restart
 
99
 
 
100
# Make sure the 3 domains given in Apache conf all lookup to your server.
 
101
# (By default these are localhost, public.localhost and svn.localhost).
 
102
# For testing purposes, this can be done by editing /etc/hosts, for example:
 
103
# 127.0.0.1     svn.localhost public.localhost
 
104
sudo vim /etc/hosts
 
105
 
 
106
##########################################################################
 
107
# User management server: usrmgt-server
 
108
##########################################################################
 
109
 
 
110
sudo cp doc/setup/usrmgt-server.init /etc/init.d/usrmgt-server
 
111
sudo chown root:root /etc/init.d/usrmgt-server
 
112
sudo chmod +x /etc/init.d/usrmgt-server
 
113
 
 
114
# To start it now:
 
115
sudo /etc/init.d/usrmgt-server start
 
116
 
 
117
# To run it at boot time:
 
118
sudo update-rc.d usrmgt-server defaults 99  # create symlinks in /etc/rc*.d
 
119
 
 
120
##########################################################################
 
121
# Setting up phpBB Forum in IVLE
 
122
##########################################################################
 
123
# This should all be run from the SVN directory
 
124
 
 
125
# Create a postgres database
 
126
# (only need the first line if it was previously created and is now changed)
 
127
sudo -u postgres dropdb ivle_forum
 
128
sudo -u postgres createdb ivle_forum
 
129
sudo -u postgres psql -d ivle_forum < userdb/forum_schema.sql
 
130
sudo -u postgres psql -d ivle_forum < userdb/forum_data.sql
 
131
 
 
132
#Change to the installed IVLE directory
 
133
cd /opt/ivle
 
134
# Fix permissions for install
 
135
cd www/php/phpBB3
 
136
# At very minimum you apache user must be able to write to
 
137
# cache/ files/ store/ images/avatars/upload config.php
 
138
sudo chown -R www-data:www-data .
 
139
 
 
140
##########################################################################
 
141
# Installing Pound reverse proxy (optional)
 
142
##########################################################################
 
143
 
 
144
sudo apt-get install pound
 
145
 
 
146
# edit /etc/default/pound so that the line reading
 
147
#     startup=0
 
148
# instead reads
 
149
#     startup=1
 
150
#
 
151
# copy pound.cfg to /etc/pound/pound.cfg
 
152
# edit IP addresses in pound.cfg