← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/setup/faq.txt

  • Committer: William Grant
  • Date: 2010-07-20 04:52:31 UTC
  • mto: This revision was merged to the branch mainline in revision 1826.
  • Revision ID: grantw@unimelb.edu.au-20100720045231-8ia3uk8nao8zdq1i
Replace cjson with json, or simplejson if json is not available (Python <2.6)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/setup/faq.txt
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
 
 
12
 
    <Directory "/opt/ivle/www/php">
13
 
        SetHandler None
14
 
    </Directory>
15
 
 
16
 
The easiest way is to ensure you copied ivle.conf.
17
 
 
18
 
All the CSS and images are missing
19
 
==================================
20
 
 
21
 
There are a couple of causes of this problem.
22
 
 
23
 
1. You could be missing the part of Apache conf which configures the
24
 
    "/opt/ivle/www/media" directory. In this case, hyperlinks will be correct.
25
 
2. You may have set your "root_dir" setting incorrectly. Make sure it
26
 
    corresponds to the URL space where IVLE lives on the web server, or all
27
 
    the URLs will be wrong. In this case, hyperlinks will be wrong as well.
28
 
 
29
 
IVLE displays a generic Terms of Service notice
30
 
===============================================
31
 
 
32
 
You should customize the TOS notice at trunk/www/apps/tos/license.html.
33
 
 
34
 
Apache Server isn't Restarting
35
 
==============================
36
 
 
37
 
Make sure no console processes are lying around (e.g. sudo killall
38
 
python), then restart with "sudo apache2ctl restart".  If the issue
39
 
persists, try stopping the server and starting it in two separate
40
 
steps, so you see the errors reported by the start script.
41
 
 
42
 
Try to log in, and I'm just dumped back to the login screen with no error
43
 
=========================================================================
44
 
 
45
 
This is usually because IVLE can't save your session information. IVLE saves
46
 
sessions to a sessions directory on disk. Unfortunately, this is not currently
47
 
configurable in ./setup.py config. You need to edit the Apache config file.
48
 
 
49
 
Look for PythonOption mod_python.file_session.database_directory. Make sure it
50
 
is set to the place you want. Then, you need to manually make sure that
51
 
directory exists.
52
 
 
53
 
The default is /home/informatics/sessions.