~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-12-01 04:27:58 UTC
  • mfrom: (1164.2.46 sphinx-docs)
  • Revision ID: matt.giuca@gmail.com-20091201042758-wuxd9bdec00c283i
Merged sphinx-docs branch. This adds Sphinx documentation for the entire IVLE system (for system administrators and developers), and removes all of our random old document files (all either irrelevant, or moved into the Sphinx docs nicely). Currently incomplete, but ready to merge.

Show diffs side-by-side

added added

removed removed

Lines of Context:
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
 
                     python-svn python-cjson python-genshi              \
25
 
                     python-configobj postgresql python-routes          \
26
 
                     python-docutils python-epydoc                      \
27
 
                     python-storm python-psycopg2
28
 
 
29
 
##########################################################################
30
 
# Configure postgres
31
 
##########################################################################
32
 
 
33
 
# Set the postgres user's postgres password
34
 
# At the prompt type (substituting <***password***> with a real one).
35
 
sudo -u postgres psql -c "ALTER USER postgres WITH ENCRYPTED PASSWORD '<***password***>'"
36
 
 
37
 
##########################################################################
38
 
# Installing ivle
39
 
##########################################################################
40
 
 
41
 
# Create a postgres database
42
 
# (only need the first line if it was previously created and is now changed)
43
 
sudo -u postgres dropdb ivle
44
 
sudo -u postgres createdb ivle
45
 
sudo -u postgres createlang plpgsql ivle
46
 
sudo -u postgres psql -d ivle < userdb/users.sql
47
 
 
48
 
# Set up IVLE
49
 
./setup.py build
50
 
sudo ./setup.py install
51
 
 
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
57
 
 
58
 
# Create a user
59
 
sudo ivle-makeuser [OPTIONS] <login> 'Firstname Lastname' <rolenm> -p <password>
60
 
# role = guest/student/tutor/lecturer/admin
61
 
 
62
 
# Configure the Apache HTTP server
63
 
sudo cp doc/setup/ivle-both.conf /etc/apache2/sites-available/ivle
64
 
# MODIFY the first few lines so it is specific to your server.
65
 
# * Change ServerAdmin and ServerName (for error reporting).
66
 
# * Inside the first VirtualHost block, there is a ServerName and ServerAlias
67
 
#   (localhost and public.localhost). You must change these to the domains
68
 
#   for regular IVLE and published-browsing IVLE respectively.
69
 
# * Inside the second VirtualHost block, there is one ServerName
70
 
#   (svn.localhost). You must change this to the domain for svn access.
71
 
sudo vim /etc/apache2/sites-available/ivle
72
 
 
73
 
# Replace the default with the IVLE site.
74
 
sudo a2dissite default
75
 
sudo a2ensite ivle
76
 
 
77
 
# Restart Apache.
78
 
sudo /etc/init.d/apache2 restart
79
 
 
80
 
# Make sure the 3 domains given in Apache conf all lookup to your server.
81
 
# (By default these are localhost, public.localhost and svn.localhost).
82
 
# For testing purposes, this can be done by editing /etc/hosts, for example:
83
 
# 127.0.0.1     svn.localhost public.localhost
84
 
sudo vim /etc/hosts
85
 
 
86
 
##########################################################################
87
 
# User management server: usrmgt-server
88
 
##########################################################################
89
 
 
90
 
sudo cp doc/setup/usrmgt-server.init /etc/init.d/usrmgt-server
91
 
sudo chown root:root /etc/init.d/usrmgt-server
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:
98
 
sudo update-rc.d usrmgt-server defaults 99  # create symlinks in /etc/rc*.d