← 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-02-24 02:02:03 UTC
  • mto: This revision was merged to the branch mainline in revision 1119.
  • Revision ID: matt.giuca@gmail.com-20090224020203-aqdcjnsj6y7wl32o
Added a new look to the IVLE header bar. Mmmm... Web 2.0.
Added top-level directory image-source, containing SVG and script files for
    generating the images.
ivle/webapp/coremedia/images: Added 'chrome' directory containing the rendered
    images.
Modified ivle/webapp/base/ivle-headings.html and
    ivle/webapp/coremedia/ivle.css to support the new images.
    Note that the H1 and H2 at the top of the page are no longer displayed
    (and their custom styles have been removed). There is a heading image
    instead.

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