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

« back to all changes in this revision

Viewing changes to doc/setup/faq.txt

[Uber-commit of holiday work because I lacked a local copy of the branch.]

 ivle.makeuser: Don't use jailconf.py as a header for the in-jail conf.py;
     generate the whole thing using string formatting operators and include
     the template inline.

 ivle.makeuser.make_conf_py: XXX the inclusion of ivle.conf.jail_base in
     the jail. It is simply there to placate ivle.studpath, and needs
     to go before we can entirely remove the in-jail config.

 ivle-buildjail:
   - Add. Converted from setup.buildjail.
   - Build the jail in __base_build__ and rsync it to __base__ when
     done, rather than operating only in ./jail
   - Rename --rebuildjail/-j to --recreate/-r, as the whole script
     is now for jail rebuilding. Also add a warning to the usage string about
     the large volume likely to be downloaded.
   - Check existence before removing trees.
   - Don't copy jailconf.py over conf.py in the jail. Also make
     sure that we remove conf.pyc.

 setup.configure:
   - Stop generating jailconf.py at all.
   - Add a jail_system_build setting, defaulting to __base_build__ next to
     the existing __base__.
   - Don't use an OptionParser before calling the real function, as that
     adds options dynamically.

 setup.install:
   - Add an option (-R) to avoid writing out svn revision info to
     $PREFIX/share/ivle/revision.txt.
   - Remove jail-copying things.
   - Install all services to the host, rather than just usrmgt-server. We do
     this so we can build the jail from the host without the source tree.
   - Shuffle some things, and don't install phpBB3 twice.
   - Add a --root argument, to take an alternate root directory to install
     into (as given to autotools in $DESTDIR).

 setup.build:
   - Allow running as non-root.
   - Take a --no-compile option to not byte-compile Python files.

 setup.util:
   - Include usrmgt-server in the list of services.
   - Add make_install_path(), a wrapper around os.path.join() that ensures
     the second path is relative.
   - Install ivle-buildjail with the other binaries.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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.