← 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: 2009-01-13 01:36:15 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:1123
Merge setup-refactor branch. This completely breaks existing installations;
every path (both filesystem and Python) has changed. Do not upgrade without
knowing what you are doing.

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.