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

588 by mattgiuca
doc/setup: Added faq.txt, with common setup issues.
1
Install Procedure - Frequently Asked Questions
2
==============================================
3
4
This is a guide for administrators trying to configure IVLE. It answers
5
questions about common installation mistakes.
6
7
Two IVLE headings, and 404 error message "There is no application called 'php'.
8
===============================================================================
9
10
This is an Apache conf problem - you are missing the following section:
11
1092.1.29 by William Grant
Update docs to comply with more recent Debian standards, and IVLE changes.
12
    <Directory "/usr/local/share/ivle/www/php">
588 by mattgiuca
doc/setup: Added faq.txt, with common setup issues.
13
        SetHandler None
14
    </Directory>
15
16
The easiest way is to ensure you copied ivle.conf.
17
18
IVLE displays a generic Terms of Service notice
19
===============================================
20
1092.1.29 by William Grant
Update docs to comply with more recent Debian standards, and IVLE changes.
21
You should customize the TOS notice at /var/lib/ivle/notices/tos.html.
589 by stevenbird
added section re my issues with restarting apache
22
23
Apache Server isn't Restarting
24
==============================
25
26
Make sure no console processes are lying around (e.g. sudo killall
1092.1.29 by William Grant
Update docs to comply with more recent Debian standards, and IVLE changes.
27
python), then restart with "sudo /etc/init.d/apache2 restart".  If the issue
589 by stevenbird
added section re my issues with restarting apache
28
persists, try stopping the server and starting it in two separate
29
steps, so you see the errors reported by the start script.
594 by mattgiuca
Added to doc/setup/faq.txt: sessions directory.
30
31
Try to log in, and I'm just dumped back to the login screen with no error
32
=========================================================================
33
34
This is usually because IVLE can't save your session information. IVLE saves
35
sessions to a sessions directory on disk. Unfortunately, this is not currently
36
configurable in ./setup.py config. You need to edit the Apache config file.
37
38
Look for PythonOption mod_python.file_session.database_directory. Make sure it
39
is set to the place you want. Then, you need to manually make sure that
40
directory exists.
41
1092.1.29 by William Grant
Update docs to comply with more recent Debian standards, and IVLE changes.
42
The default is /var/lib/ivle/sessions.