← 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

[Uber-commit of holiday work because I lacked a local copy of the branch.]

 ivle.makeuser: Don't use jailconf.py as a header for the in-jail conf.py;
     generate the whole thing using string formatting operators and include
     the template inline.

 ivle.makeuser.make_conf_py: XXX the inclusion of ivle.conf.jail_base in
     the jail. It is simply there to placate ivle.studpath, and needs
     to go before we can entirely remove the in-jail config.

 ivle-buildjail:
   - Add. Converted from setup.buildjail.
   - Build the jail in __base_build__ and rsync it to __base__ when
     done, rather than operating only in ./jail
   - Rename --rebuildjail/-j to --recreate/-r, as the whole script
     is now for jail rebuilding. Also add a warning to the usage string about
     the large volume likely to be downloaded.
   - Check existence before removing trees.
   - Don't copy jailconf.py over conf.py in the jail. Also make
     sure that we remove conf.pyc.

 setup.configure:
   - Stop generating jailconf.py at all.
   - Add a jail_system_build setting, defaulting to __base_build__ next to
     the existing __base__.
   - Don't use an OptionParser before calling the real function, as that
     adds options dynamically.

 setup.install:
   - Add an option (-R) to avoid writing out svn revision info to
     $PREFIX/share/ivle/revision.txt.
   - Remove jail-copying things.
   - Install all services to the host, rather than just usrmgt-server. We do
     this so we can build the jail from the host without the source tree.
   - Shuffle some things, and don't install phpBB3 twice.
   - Add a --root argument, to take an alternate root directory to install
     into (as given to autotools in $DESTDIR).

 setup.build:
   - Allow running as non-root.
   - Take a --no-compile option to not byte-compile Python files.

 setup.util:
   - Include usrmgt-server in the list of services.
   - Add make_install_path(), a wrapper around os.path.join() that ensures
     the second path is relative.
   - Install ivle-buildjail with the other binaries.

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.
21
21
##########################################################################
22
22
sudo apt-get install rsync subversion build-essential debootstrap       \
23
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                      \
 
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
27
                     python-storm python-psycopg2
28
28
 
29
29
##########################################################################
37
37
##########################################################################
38
38
# Installing ivle
39
39
##########################################################################
 
40
#
 
41
# Check out the IVLE trunk
 
42
 
 
43
svn co https://ivle.svn.sourceforge.net/svnroot/ivle/trunk ivle_svn
 
44
cd ivle_svn
40
45
 
41
46
# Create a postgres database
42
47
# (only need the first line if it was previously created and is now changed)
46
51
sudo -u postgres psql -d ivle < userdb/users.sql
47
52
 
48
53
# Set up IVLE
49
 
./setup.py build
 
54
./setup.py config
 
55
 
 
56
# -j is required to rebuild all jails, not just do an update
 
57
sudo ./setup.py build -j
50
58
sudo ./setup.py install
51
59
 
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
60
# Create a user
59
61
sudo ivle-makeuser [OPTIONS] <login> 'Firstname Lastname' <rolenm> -p <password>
60
62
# role = guest/student/tutor/lecturer/admin
63
65
sudo cp doc/setup/ivle-both.conf /etc/apache2/sites-available/ivle
64
66
# MODIFY the first few lines so it is specific to your server.
65
67
# * Change ServerAdmin and ServerName (for error reporting).
66
 
# * Inside the first VirtualHost block, there is a ServerName and ServerAlias
 
68
# * Inside the first VirtualHost block, there are two ServerNames
67
69
#   (localhost and public.localhost). You must change these to the domains
68
70
#   for regular IVLE and published-browsing IVLE respectively.
69
71
# * Inside the second VirtualHost block, there is one ServerName
70
72
#   (svn.localhost). You must change this to the domain for svn access.
 
73
# * Change all paths beginning with /opt/ivle or /home/informatics to the
 
74
#   locations you have installed things in.
 
75
# * Update all of the paths to where you installed IVLE, if required.
71
76
sudo vim /etc/apache2/sites-available/ivle
72
77
 
73
78
# Replace the default with the IVLE site.
96
101
 
97
102
# To run it at boot time:
98
103
sudo update-rc.d usrmgt-server defaults 99  # create symlinks in /etc/rc*.d
 
104
 
 
105
##########################################################################
 
106
# Setting up phpBB Forum in IVLE
 
107
##########################################################################
 
108
# This should all be run from the SVN directory
 
109
 
 
110
# Create a postgres database
 
111
# (only need the first line if it was previously created and is now changed)
 
112
sudo -u postgres dropdb ivle_forum
 
113
sudo -u postgres createdb ivle_forum
 
114
sudo -u postgres psql -d ivle_forum < userdb/forum_schema.sql
 
115
sudo -u postgres psql -d ivle_forum < userdb/forum_data.sql