← 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: apeel
  • Date: 2008-03-14 01:33:50 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:688
setup.py now creates the /etc/init.d script for usrmgr-server, and install_proc.txt has instructions on installing it.

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 Platform: Ubuntu 7.10
5
5
#
6
6
# IMPORTANT: This is NOT a shell script. It has interactive sections and
7
7
# things that need to be customized.
10
10
 
11
11
# While other install guides in this package are generic, this one is very
12
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.
 
13
# set up IVLE on Ubuntu 7.06 or higher; less helpful for other platforms.
14
14
# This refers to ivle.conf, also included.
15
15
#
16
16
# Author: Matt Giuca
17
17
# Date: 29/1/2008
18
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
 
19
32
##########################################################################
20
33
# Apt packages
21
34
##########################################################################
22
 
sudo apt-get install 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
 
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 python-ldap
 
42
sudo apt-get install php5 php5-pgsql
 
43
 
 
44
# Note: I had a lot of trouble with the python-svn package.
 
45
# After playing around a bit it started working.
 
46
# python -c 'import pysvn'
 
47
# to test if it worked.
 
48
# Do Not install python-svn-dbg.
 
49
 
 
50
##########################################################################
 
51
# Python packages needed by IVLE or student code
 
52
##########################################################################
 
53
#
 
54
# See trunk/doc/dependencies.txt
 
55
 
 
56
# CJSON
 
57
wget 'http://pypi.python.org/packages/source/p/python-cjson/python-cjson-1.0.5.tar.gz'
 
58
tar -zxvf python-cjson-1.0.5.tar.gz
 
59
 
 
60
cd python-cjson-1.0.5
 
61
./setup.py build
 
62
sudo ./setup.py install
 
63
cd ..
 
64
 
 
65
# NLTK for student code
 
66
wget 'http://prdownloads.sourceforge.net/nltk/nltk-0.9.2.tar.gz'
 
67
tar -xzvf nltk-0.9.2.tar.gz
 
68
wget 'http://prdownloads.sourceforge.net/nltk/nltk-data-0.9.2.zip'
 
69
unzip nltk-data-0.9.2.zip
 
70
 
 
71
cd nltk-0.9.2
 
72
sudo python setup.py install
 
73
cd ..
 
74
sudo mkdir /usr/share/nltk
 
75
sudo mv data /usr/share/nltk/
 
76
sudo chmod -R g+r /usr/share/nltk/data
 
77
 
 
78
# Beautiful Soup for student code
 
79
# via apt-get
 
80
sudo apt-get install python-beautifulsoup
 
81
# or 
 
82
wget 'http://www.crummy.com/software/BeautifulSoup/download/BeautifulSoup.tar.gz'
 
83
tar -xzvf BeautifulSoup.tar.gz
 
84
 
 
85
cd BeautifulSoup*
 
86
sudo python setup.py install
 
87
cd ..
 
88
 
 
89
# Documentation packages needed for tutorial system: Docutils, Epydoc
 
90
# wget each of these, untar them, and then do: sudo python ./setup.py install
 
91
 
 
92
http://docutils.sourceforge.net/docutils-snapshot.tgz
 
93
http://downloads.sourceforge.net/epydoc/epydoc-3.0.1.tar.gz?use_mirror=optusnet
 
94
 
 
95
# Or using apt-get
 
96
# (Note: epydoc doesn't work on Fiesty using apt-get)
 
97
 
 
98
sudo apt-get install python-docutils python-epydoc
27
99
 
28
100
##########################################################################
29
101
# Configure postgres
30
102
##########################################################################
 
103
#
 
104
# Some of these instructions follow
 
105
#     https://help.ubuntu.com/community/PostgreSQL
 
106
# 1. install the base packages
31
107
 
32
108
# Set the postgres user's postgres password
33
109
sudo -u postgres psql template1
34
 
# At the prompt type (substituting <***password***> with a real one).
 
110
# At the prompt type (substituting <***password***> with a real one.
35
111
ALTER USER postgres WITH ENCRYPTED PASSWORD '<***password***>';
36
112
\q
37
113
 
41
117
#
42
118
# Check out the IVLE trunk
43
119
 
44
 
svn co https://ivle.svn.sourceforge.net/svnroot/ivle/trunk ivle_svn
45
 
cd ivle_svn
 
120
export IVLE_SVN=ivle_svn
 
121
svn co https://ivle.svn.sourceforge.net/svnroot/ivle/trunk $IVLE_SVN
 
122
cd $IVLE_SVN
46
123
 
47
124
# Create a postgres database
48
125
# (only need the first line if it was previously created and is now changed)
49
126
sudo -u postgres dropdb ivle
50
127
sudo -u postgres createdb ivle
51
 
sudo -u postgres createlang plpgsql ivle
52
128
sudo -u postgres psql -d ivle < userdb/users.sql
53
129
 
54
130
# Set up IVLE
60
136
# Leave others default.
61
137
# Note: This will cause IVLE to get installed to /opt/ivle
62
138
 
63
 
sudo ./setup.py build
 
139
./setup.py build
64
140
sudo ./setup.py install
65
141
 
66
 
# Make the directory containing the svn auth.
67
 
# Make sure it is owned by www-data.
68
 
sudo mkdir /opt/ivle/svn
69
 
sudo chown -R www-data:www-data /opt/ivle/svn
70
 
 
71
 
# Make the "repositories", "sessions" and "logs" directories in the home.
72
 
# Make sure they are owned by www-data.
73
 
cd /home/informatics
74
 
sudo mkdir -p repositories/users sessions logs
75
 
sudo chown -R www-data:www-data repositories sessions logs
76
 
 
77
 
cd /home/informatics/ivle_svn
78
 
 
79
142
# Create a user
80
143
sudo ./makeuser.py [OPTIONS] <login> 'Firstname Lastname' <rolenm> -p <password>
81
144
# role = guest/student/tutor/lecturer/admin
82
145
 
83
146
# Configure the Apache HTTP server
84
 
sudo cp doc/setup/ivle-both.conf /etc/apache2/sites-available/ivle
 
147
sudo cp doc/setup/ivle.conf /etc/apache2/sites-available
85
148
# MODIFY the first few lines so it is specific to your server.
86
 
# * Change ServerAdmin and ServerName (for error reporting).
87
 
# * Inside the first VirtualHost block, there are two ServerNames
88
 
#   (localhost and public.localhost). You must change these to the domains
89
 
#   for regular IVLE and published-browsing IVLE respectively.
90
 
# * Inside the second VirtualHost block, there is one ServerName
91
 
#   (svn.localhost). You must change this to the domain for svn access.
92
 
# * Change all paths beginning with /opt/ivle or /home/informatics to the
93
 
#   locations you have installed things in.
94
 
sudo vim /etc/apache2/sites-available/ivle
95
 
 
96
 
# Replace the default with the IVLE site.
97
 
sudo a2dissite default
98
 
sudo a2ensite ivle
99
 
 
100
 
# Restart Apache.
101
 
sudo /etc/init.d/apache2 restart
102
 
 
103
 
# Make sure the 3 domains given in Apache conf all lookup to your server.
104
 
# (By default these are localhost, public.localhost and svn.localhost).
105
 
# For testing purposes, this can be done by editing /etc/hosts, for example:
106
 
# 127.0.0.1     svn.localhost public.localhost
107
 
sudo vim /etc/hosts
 
149
vim /etc/apache2/sites-available/ivle.conf
 
150
 
 
151
# Replace the existing config link with the ivle one
 
152
cd /etc/apache2/sites-enabled/
 
153
sudo ln -fs /etc/apache2/sites-available/ivle.conf 000-default
 
154
 
 
155
# Make the directory corresponding to the directory for saved session
 
156
# objects in the apache config ivle.conf. Make sure it is owned by www-data,
 
157
# or at least readable and writable by it.
 
158
 
 
159
sudo mkdir /home/informatics/sessions
 
160
sudo chown www-data:www-data /home/informatics/sessions
 
161
 
 
162
# Restart the server
 
163
sudo apache2ctl -k restart
108
164
 
109
165
##########################################################################
110
166
# User management server: usrmgt-server
111
167
##########################################################################
112
168
# To start the user management server:
113
169
cd /opt/ivle/scripts
114
 
sudo ./usrmgt-server <port> <usrmgt-password>
115
 
# usrmgt-password is the password entered in setup.py config (usrmgt_magic)
116
 
# Note that the port number and usrmgt password are recorded in
 
170
sudo ./usrmgt-server <port> <database password>
 
171
# Note that the port number and database password are recorded in
117
172
# the automatically created init.d script: doc/setup/usrmgt-server.init
118
173
 
119
174
# To run it at boot time:
120
 
sudo cp doc/setup/usrmgt-server.init /etc/init.d/usrmgt-server
 
175
sudo cp doc/setup/usrmgt-server.init /etc/init.d
121
176
sudo chown root:root /etc/init.d/usrmgt-server
122
177
sudo chmod 700 /etc/init.d/usrmgt-server  # so world can't read database magic
123
178
sudo update-rc.d usrmgt-server defaults 99  # create symlinks in /etc/rc*.d