← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/setup/forum.txt

  • Committer: William Grant
  • Date: 2009-02-23 23:47:02 UTC
  • mfrom: (1099.1.211 new-dispatch)
  • Revision ID: grantw@unimelb.edu.au-20090223234702-db4b1llly46ignwo
Merge from lp:~ivle-dev/ivle/new-dispatch.

Pretty much everything changes. Reread the setup docs. Backup your databases.
Every file is now in a different installed location, the configuration system
is rewritten, the dispatch system is rewritten, URLs are different, the
database is different, worksheets and exercises are no longer on the
filesystem, we use a templating engine, jail service protocols are rewritten,
we don't repeat ourselves, we have authorization rewritten, phpBB is gone,
and probably lots of other things that I cannot remember.

This is certainly the biggest commit I have ever made, and hopefully
the largest I ever will.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/setup/forum.txt
 
1
IVLE phpBB3 integration
 
2
=======================
 
3
 
 
4
IVLE has an optional forum, an integrated instance of phpBB3.
 
5
It is not installed by default, so this document describes how to do it.
 
6
These instructions assume that you already have a working IVLE instance on the
 
7
same server.
 
8
 
 
9
phpBB requires PHP and a database driver to run. If on a Debian system, install
 
10
the 'php5' and 'php5-pgsql' packages.
 
11
 
 
12
You will first need to grab a copy of phpBB3. Extract it somewhere, and make it
 
13
visible under the IVLE domain. Make sure that you do not conflict with any
 
14
existing URLs, by using a directory like 'phpbb3'. You also need to tell Apache
 
15
not to send it through the IVLE dispatcher. Directives in your IVLE Apache
 
16
virtual host like this should work:
 
17
 
 
18
  <Location /phpbb3>
 
19
      SetHandler none
 
20
  </Location>
 
21
  Alias /phpbb3 /local/path/to/phpBB3
 
22
 
 
23
phpBB uses a different database. We will use PostgreSQL here, but IVLE does not
 
24
care which you use, as long as phpBB supports it. Create a database:
 
25
 
 
26
  sudo -u postgres createdb -E UTF-8 ivle_forum
 
27
 
 
28
Point your web browser at the phpBB URL, and follow the installation procedure.
 
29
Once it is installed and working, we need to apply some IVLE-specific patches
 
30
to achieve authentication integration:
 
31
 
 
32
  patch -p1 -d /local/path/to/phpBB3 < ivle/webapp/forum/phpbb3.diff
 
33
  chown -R www-data: /local/path/to/phpBB3
 
34
 
 
35
Choose a secure password with which to sign authentication cookies. Put it in
 
36
$ivle_secret in phpBB3/config.php.
 
37
 
 
38
To configure the IVLE side of things, create a new file at
 
39
/etc/ivle/plugins.d/forum.conf. In it put the following:
 
40
 
 
41
 [ivle.webapp.forum#Plugin]
 
42
 base = phpbb3 # Assuming that you used the same Alias line.
 
43
 secret = <FORUM SECRET> # Replace this with your chosen secret.
 
44
 
 
45
You should now be able to click on the Forum tab in IVLE and be automatically
 
46
logged in.