|
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 |
||
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. |
|
|
589
by stevenbird
added section re my issues with restarting apache |
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. |
|
|
594
by mattgiuca
Added to doc/setup/faq.txt: sessions directory. |
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. |