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

« back to all changes in this revision

Viewing changes to doc/man/faq.rst

  • Committer: mattgiuca
  • Date: 2008-01-11 00:49:06 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:172
util: Added buildurl function.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.. IVLE - Informatics Virtual Learning Environment
2
 
   Copyright (C) 2007-2009 The University of Melbourne
3
 
 
4
 
.. This program is free software; you can redistribute it and/or modify
5
 
   it under the terms of the GNU General Public License as published by
6
 
   the Free Software Foundation; either version 2 of the License, or
7
 
   (at your option) any later version.
8
 
 
9
 
.. This program is distributed in the hope that it will be useful,
10
 
   but WITHOUT ANY WARRANTY; without even the implied warranty of
11
 
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12
 
   GNU General Public License for more details.
13
 
 
14
 
.. You should have received a copy of the GNU General Public License
15
 
   along with this program; if not, write to the Free Software
16
 
   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
17
 
 
18
 
.. _ref-faq:
19
 
 
20
 
**************************
21
 
Frequently Asked Questions
22
 
**************************
23
 
 
24
 
This is a list of Frequently Asked Questions for IVLE. It answers questions 
25
 
about common issues encountered when configuring or running the system.
26
 
 
27
 
.. _ref-faq-how:
28
 
 
29
 
How can I...
30
 
============
31
 
 
32
 
... change the Terms of Service notice?
33
 
---------------------------------------
34
 
 
35
 
You should customize the ToS notice at :file:`/var/lib/ivle/notices/tos.html`.
36
 
 
37
 
... delete a user from IVLE?
38
 
----------------------------
39
 
 
40
 
This is usually a bad idea since it requires all the references to that user 
41
 
to be removed from IVLE. This may have unintended consequences particularly 
42
 
with groups or projects but might be required in installations where an 
43
 
existing login conflict with a new login (typically encountered when usernames 
44
 
are recycled).
45
 
 
46
 
The steps to completely remove a user would be:
47
 
 
48
 
1. Disable the users account
49
 
2. Unmount the users jailmount directory (typically 
50
 
   :file:`/var/lib/ivle/jailmounts/LOGIN`)
51
 
3. Backup the user's files (typically :file:`/var/lib/ivle/jails/LOGIN`) and 
52
 
   remove this directory.
53
 
4. Backup the user's repository (typically 
54
 
   :file:`/var/lib/ivle/svn/repositories/users/LOGIN` on the subversion 
55
 
   server) and remove this directory.
56
 
5. Make a backup of the IVLE database (``sudo -u postgres pg_dump ivle > 
57
 
   backup.sql``)
58
 
6. Either change the users login (``UPDATE login SET login='NEWLOGIN' WHERE 
59
 
   login='LOGIN'``) or remove all references to this login in the database
60
 
 
61
 
The following lines of SQL should remove all traces of a user ``LOGIN`` from 
62
 
the database::
63
 
 
64
 
    BEGIN TRANSACTION;
65
 
    DELETE FROM exercise_save USING login WHERE
66
 
        exercise_save.loginid = login.loginid AND login.login = 'LOGIN';
67
 
    DELETE FROM exercise_attempt USING login WHERE
68
 
        exercise_attempt.loginid = login.loginid AND login.login = 'LOGIN';
69
 
    DELETE FROM project_mark USING login WHERE marker = login.loginid AND
70
 
        login.login = 'LOGIN';
71
 
    DELETE FROM project_submission USING login WHERE
72
 
        submitter = login.loginid AND login.login = 'LOGIN';
73
 
    DELETE FROM project_extension USING login WHERE
74
 
        approver = login.loginid AND login.login = 'LOGIN';
75
 
    DELETE FROM assessed USING login WHERE
76
 
        assessed.loginid = login.loginid AND login.login = 'LOGIN';
77
 
    DELETE FROM enrolment USING login WHERE
78
 
        enrolment.loginid = login.loginid AND login.login = 'LOGIN';
79
 
    DELETE FROM group_member USING login WHERE
80
 
        group_member.loginid = login.loginid AND login.login = 'LOGIN';
81
 
    DELETE FROM group_invitation USING login WHERE
82
 
        (group_invitation.loginid = login.loginid OR
83
 
        inviter = login.loginid) AND login.login = 'LOGIN';
84
 
    DELETE FROM project_group USING login WHERE createdby = login.loginid AND
85
 
        login.login = 'LOGIN';
86
 
    DELETE FROM login WHERE login='LOGIN';
87
 
    COMMIT;
88
 
 
89
 
If you do not want to lose group data, a better option may be to reassign the 
90
 
user ``LOGIN``'s groups to ``NEWLOGIN`` (one possible option would be to 
91
 
create and use a 'nobody' account)::
92
 
 
93
 
    BEGIN TRANSACTION;
94
 
    DELETE FROM exercise_save USING login WHERE
95
 
        exercise_save.loginid = login.loginid AND login.login = 'LOGIN';
96
 
    DELETE FROM exercise_attempt USING login WHERE
97
 
        exercise_attempt.loginid = login.loginid AND login.login = 'LOGIN';
98
 
    UPDATE project_mark SET marker = l2.loginid FROM login AS l1, login AS l2
99
 
        WHERE marker = l1.loginid AND l1.login = 'LOGIN' AND l2.login = 
100
 
        'NEWLOGIN'
101
 
    DELETE FROM project_submission USING login WHERE
102
 
        submitter = login.loginid AND login.login = 'LOGIN';
103
 
    UPDATE project_extension SET approver = l2.loginid FROM
104
 
        login AS l1, login AS l2 WHERE approver = l1.loginid AND
105
 
        l1.login = 'LOGIN' AND l2.login='NEWLOGIN';
106
 
    DELETE FROM assessed USING login WHERE
107
 
        assessed.loginid = login.loginid AND login.login = 'LOGIN';
108
 
    DELETE FROM enrolment USING login WHERE
109
 
        enrolment.loginid = login.loginid AND login.login = 'LOGIN';
110
 
    DELETE FROM group_member USING login WHERE
111
 
        group_member.loginid = login.loginid AND login.login = 'LOGIN';
112
 
    DELETE FROM group_invitation USING login WHERE
113
 
        group_invitation.loginid = login.loginid AND login.login = 'LOGIN';
114
 
    UPDATE group_invitation SET inviter = l2.loginid FROM
115
 
        login AS l1, login AS l2 WHERE inviter = l1.loginid AND
116
 
        l1.login = 'LOGIN' AND l2.login='NEWLOGIN';
117
 
    UPDATE project_group SET createdby = l2.loginid FROM
118
 
        login AS l1, login AS l2 WHERE createdby = l1.loginid AND
119
 
        l1.login = 'LOGIN' AND l2.login = 'NEWLOGIN';
120
 
    DELETE FROM login WHERE login='LOGIN';
121
 
    COMMIT;
122
 
 
123
 
 
124
 
.. _ref-faq-why:
125
 
 
126
 
Why does...
127
 
===========
128
 
 
129
 
... Apache not restart?
130
 
-----------------------
131
 
 
132
 
Make sure no console processes are lying around (e.g. sudo killall
133
 
python), then restart with ``sudo /etc/init.d/apache2 restart``.  If the issue
134
 
persists, try stopping the server and starting it in two separate
135
 
steps, so you see the errors reported by the start script.
136
 
 
137
 
... IVLE dump me back to the login screen with no error when I try to login?
138
 
----------------------------------------------------------------------------
139
 
 
140
 
This is usually because IVLE can't save your session information. IVLE saves
141
 
sessions to a sessions directory on disk. Unfortunately, this is not currently
142
 
configurable in :file:`./setup.py` config. You need to edit the Apache config 
143
 
file.
144
 
 
145
 
Look for ``PythonOption mod_python.file_session.database_directory``. Make
146
 
sure it is set to the place you want. Then, you need to manually make sure
147
 
that directory exists. If you have multiple slaves, this directory will
148
 
need to be shared between them all.
149
 
 
150
 
The default is :file:`/var/lib/ivle/sessions`.
151
 
 
152
 
 
153
 
... ivle-buildjail fail with 'Error: Jail contains world writable path'
154
 
-----------------------------------------------------------------------
155
 
 
156
 
When running :program:`ivle-buildjail` you may occasionally see an error 
157
 
like::
158
 
 
159
 
    Error: Jail contains world writable path: 
160
 
    '/var/lib/ivle/jails/__base_build__/tmp/.ICE-unix'.
161
 
    This is a security vulnerability as jail template contents are shared 
162
 
    between users. Please either make this path world unwriteable or remove it 
163
 
    from the jail.
164
 
 
165
 
This means that writable files exist in the Jail template. If left in the jail 
166
 
then users would be able to edit a file that is shared between all jail 
167
 
instances. The usual solution is just to remove these file from the jail build 
168
 
directory and try again.
169
 
 
170
 
At present it is not possible to include world writable files outside a user's 
171
 
home directory so if this file is deliberately included you will need to 
172
 
ensure that it is not world writeable.
173
 
 
174
 
 
175
 
... the console return 'Console Restart' messages
176
 
-------------------------------------------------
177
 
 
178
 
There are three cases where a console may be restarted:
179
 
 
180
 
1. **Console Restart: The IVLE console has timed out due to inactivity**
181
 
 
182
 
    The Python console process is no longer running. This is most likey due to 
183
 
    the console process being automatically terminated due to no messages 
184
 
    being sent or received by the console in the previous 15 minutes.
185
 
 
186
 
    This message can also be triggered if the console is terminated for 
187
 
    another reason (such as being sent :const:`SIGKILL` from the system 
188
 
    command line or any other fatal signal).
189
 
 
190
 
2. **Console Restart: CPU Time Limit Exceeded**
191
 
 
192
 
   To prevent exhaustion of local system resources, Python console processes 
193
 
   are set with an CPU Time Limit of 25 seconds of user time (time executing 
194
 
   on the CPU rather than real "clock-on-the-wall" time).
195
 
 
196
 
   This setting can be configured by changing the values associated with 
197
 
   :const:`RLIMIT_CPU` in :file:`bin/trampoline/trampoline.c`.
198
 
 
199
 
3. **Console Restart: Communication to console process lost**
200
 
 
201
 
    IVLE was unable to understand a response from the console process. This 
202
 
    will only happen if the console sends a malformed response and quite 
203
 
    likely a bug.
204
 
 
205
 
4. **Console Restart: Communication to console process reset**
206
 
 
207
 
    IVLE's TCP connection to the console process was reset. May indicate 
208
 
    network issues.
209