← Back to branch summary

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

« back to all changes in this revision

Viewing changes to setup/configure.py

Merge from new-dispatch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
setup/configure.py
1
 
#!/usr/bin/python
2
1
# IVLE - Informatics Virtual Learning Environment
3
2
# Copyright (C) 2007-2009 The University of Melbourne
4
3
#
16
15
# along with this program; if not, write to the Free Software
17
16
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
18
17
 
 
18
# Module: setup/config
19
19
# Author: Matt Giuca, Refactored by David Coles
 
20
# Date:   03/07/2008
20
21
 
21
22
'''Configures IVLE with machine-specific details, most notably, various paths.
22
23
Either prompts the administrator for these details or accepts them as
23
24
command-line args.
24
25
 
25
 
Creates etc/ivle.conf
 
26
Creates ivle/conf/conf.py and bin/trampoline/trampoline/conf.h.
26
27
'''
27
28
 
28
29
import optparse
29
30
import getopt
30
31
import os
31
32
import sys
32
 
import stat
33
33
import hashlib
34
34
import uuid
35
35
 
36
 
import ivle.config
 
36
from setup.util import query_user
37
37
 
38
38
import configobj
39
39
 
 
40
# This dict maps legacy config option names to new config option paths
 
41
# ('section/option_name')
 
42
# NOTE: This is copied from ivle/conf/conf.py (because neither of these files
 
43
# can see each other).
 
44
CONFIG_OPTIONS = {
 
45
    'root_dir': 'urls/root',
 
46
    'prefix': 'paths/prefix',
 
47
    'data_path': 'paths/data',
 
48
    'log_path': 'paths/logs',
 
49
    'python_site_packages_override': 'paths/site_packages',
 
50
    'public_host': 'urls/public_host',
 
51
    'allowed_uids': 'os/allowed_uids',
 
52
    'db_host': 'database/host',
 
53
    'db_port': 'database/port',
 
54
    'db_dbname': 'database/name',
 
55
    'db_forumdbname': 'plugins/forum/dbname',
 
56
    'db_user': 'database/username',
 
57
    'db_password': 'database/password',
 
58
    'auth_modules': 'auth/modules',
 
59
    'ldap_url': 'auth/ldap_url',
 
60
    'ldap_format_string': 'auth/ldap_format_string',
 
61
    'subject_pulldown_modules': 'auth/subject_pulldown_modules',
 
62
    'svn_addr': 'urls/svn_addr',
 
63
    'usrmgt_host': 'usrmgt/host',
 
64
    'usrmgt_port': 'usrmgt/port',
 
65
    'usrmgt_magic': 'usrmgt/magic',
 
66
    'forum_secret': 'plugins/forum/secret',
 
67
}
 
68
 
40
69
class ConfigOption:
41
70
    """A configuration option; one of the things written to conf.py."""
42
71
    def __init__(self, option_name, default, prompt, comment, ask=True):
59
88
# Configuration options, defaults and descriptions
60
89
config_options = []
61
90
 
62
 
config_options.append(ConfigOption("urls/root", "/",
 
91
config_options.append(ConfigOption("root_dir", "/",
63
92
    """Root directory where IVLE is located (in URL space):""",
64
93
    """
65
94
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
66
95
# with this).
67
96
# eg. "/" or "/ivle".""", ask=False))
68
97
 
69
 
config_options.append(ConfigOption("paths/prefix", "/usr/local",
 
98
config_options.append(ConfigOption("prefix", "/usr/local",
70
99
    """In the local file system, the prefix to the system directory where IVLE
71
100
is installed. (This should either be /usr or /usr/local):""",
72
101
    """
75
104
# ('/usr/local' for the usual install, '/usr' for distribution packages)""",
76
105
    ask=False))
77
106
 
78
 
config_options.append(ConfigOption("paths/data",
 
107
config_options.append(ConfigOption("python_site_packages_override",
 
108
    None,
 
109
    """site-packages directory in Python, where Python libraries are to be
 
110
installed. May be left as the default, in which case the value will be
 
111
computed from prefix and the current Python version:""",
 
112
    """
 
113
# 'site-packages' directory in Python, where Python libraries are to be
 
114
# installed. May be None (recommended), in which case the value will be
 
115
# computed from prefix and the current Python version.""", ask=False))
 
116
 
 
117
config_options.append(ConfigOption("data_path",
79
118
    "/var/lib/ivle",
80
119
    "In the local file system, where user-modifiable data files should be "
81
120
    "located:",
83
122
# In the local file system, where user-modifiable data files should be
84
123
# located.""", ask=False))
85
124
 
86
 
config_options.append(ConfigOption("paths/logs",
 
125
config_options.append(ConfigOption("log_path",
87
126
    "/var/log/ivle",
88
127
    """Directory where IVLE log files are stored (on the local
89
128
file system). Note - this must be writable by the user the IVLE server 
92
131
# In the local file system, where IVLE error logs should be located.""",
93
132
    ask=False))
94
133
 
95
 
config_options.append(ConfigOption("urls/public_host",
96
 
    "public.ivle.localhost",
 
134
config_options.append(ConfigOption("public_host", "public.localhost",
97
135
    """Hostname which will cause the server to go into "public mode",
98
136
providing login-free access to student's published work:""",
99
137
    """
104
142
# Private mode (normal mode) requires login, and only serves files relevant to
105
143
# the logged-in user."""))
106
144
 
107
 
config_options.append(ConfigOption("media/version", None,
108
 
    """Version of IVLE media resources (must change on each upgrade):""",
 
145
config_options.append(ConfigOption("allowed_uids", "33",
 
146
    """UID of the web server process which will run IVLE.
 
147
Only this user may execute the trampoline. May specify multiple users as
 
148
a comma-separated list.
 
149
    (eg. "1002,78")""",
109
150
    """
110
 
# Version string for IVLE media resource URLs. When set, they are aggressively
111
 
# cached by the browser, so it must be either left unset or changed each time
112
 
# a media file is changed.""", ask=False))
 
151
# The User-ID of the web server process which will run IVLE, and any other
 
152
# users who are allowed to run the trampoline. This is stores as a string of
 
153
# comma-separated integers, simply because it is not used within Python, only
 
154
# used by the setup program to write to conf.h (see setup.py config).""",
 
155
    ask=False))
113
156
 
114
 
config_options.append(ConfigOption("database/host", "localhost",
 
157
config_options.append(ConfigOption("db_host", "localhost",
115
158
    """PostgreSQL Database config
116
159
==========================
117
160
Hostname of the DB server:""",
118
161
    """
119
162
# Database server hostname"""))
120
163
 
121
 
config_options.append(ConfigOption("database/port", "5432",
 
164
config_options.append(ConfigOption("db_port", "5432",
122
165
    """Port of the DB server:""",
123
166
    """
124
167
# Database server port"""))
125
168
 
126
 
config_options.append(ConfigOption("database/name", "ivle",
 
169
config_options.append(ConfigOption("db_dbname", "ivle",
127
170
    """Database name:""",
128
171
    """
129
172
# Database name"""))
130
173
 
131
 
config_options.append(ConfigOption("database/username", "postgres",
 
174
config_options.append(ConfigOption("db_forumdbname", "ivle_forum",
 
175
    """Forum Database name:""",
 
176
    """
 
177
# Forum Database name"""))
 
178
 
 
179
config_options.append(ConfigOption("db_user", "postgres",
132
180
    """Username for DB server login:""",
133
181
    """
134
182
# Database username"""))
135
183
 
136
 
config_options.append(ConfigOption("database/password", "",
 
184
config_options.append(ConfigOption("db_password", "",
137
185
    """Password for DB server login:
138
 
    (Caution: This password is stored in plaintext!)""",
 
186
    (Caution: This password is stored in plaintext in ivle/conf/conf.py)""",
139
187
    """
140
188
# Database password"""))
141
189
 
142
 
config_options.append(ConfigOption("auth/modules", "",
 
190
config_options.append(ConfigOption("auth_modules", "",
143
191
    """Authentication config
144
192
=====================
145
193
Comma-separated list of authentication modules.""",
153
201
# other modules may be plugged in to auth against organisation-specific
154
202
# auth backends.""", ask=False))
155
203
 
156
 
config_options.append(ConfigOption("auth/ldap_url", "ldaps://www.example.com",
 
204
config_options.append(ConfigOption("ldap_url", "ldaps://www.example.com",
157
205
    """(LDAP options are only relevant if "ldap" is included in the list of
158
206
auth modules).
159
207
URL for LDAP authentication server:""",
160
208
    """
161
209
# URL for LDAP authentication server""", ask=False))
162
210
 
163
 
config_options.append(ConfigOption("auth/ldap_format_string",
 
211
config_options.append(ConfigOption("ldap_format_string",
164
212
    "uid=%s,ou=users,o=example",
165
213
    """Format string for LDAP auth request:
166
214
    (Must contain a single "%s" for the user's login name)""",
168
216
# Format string for LDAP auth request
169
217
# (Must contain a single "%s" for the user's login name)""", ask=False))
170
218
 
171
 
config_options.append(ConfigOption("auth/subject_pulldown_modules", "",
 
219
config_options.append(ConfigOption("subject_pulldown_modules", "",
172
220
    """Comma-separated list of subject pulldown modules.
173
221
Add proprietary modules to automatically enrol students in subjects.""",
174
222
    """
178
226
# other modules may be plugged in to pulldown against organisation-specific
179
227
# pulldown backends.""", ask=False))
180
228
 
181
 
config_options.append(ConfigOption("urls/svn_addr",
182
 
    "http://svn.ivle.localhost/",
 
229
config_options.append(ConfigOption("svn_addr", "http://svn.localhost/",
183
230
    """Subversion config
184
231
=================
185
232
The base url for accessing subversion repositories:""",
186
233
    """
187
234
# The base url for accessing subversion repositories."""))
188
235
 
189
 
config_options.append(ConfigOption("usrmgt/host", "localhost",
 
236
config_options.append(ConfigOption("usrmgt_host", "localhost",
190
237
    """User Management Server config
191
238
============================
192
239
The hostname where the usrmgt-server runs:""",
193
240
    """
194
241
# The hostname where the usrmgt-server runs."""))
195
242
 
196
 
config_options.append(ConfigOption("usrmgt/port", "2178",
 
243
config_options.append(ConfigOption("usrmgt_port", "2178",
197
244
    """The port where the usrmgt-server runs:""",
198
245
    """
199
246
# The port where the usrmgt-server runs.""", ask=False))
200
247
 
201
 
config_options.append(ConfigOption("usrmgt/magic", None,
 
248
config_options.append(ConfigOption("usrmgt_magic", None,
202
249
    """The password for the usrmgt-server:""",
203
250
    """
204
251
# The password for the usrmgt-server.""", ask=False))
205
252
 
206
 
config_options.append(ConfigOption("jail/suite", "hardy",
207
 
    """The distribution release to use to build the jail:""",
208
 
    """
209
 
# The distribution release to use to build the jail.""", ask=True))
210
 
 
211
 
config_options.append(ConfigOption("jail/mirror", "archive.ubuntu.com",
212
 
    """The archive mirror to use to build the jail:""",
213
 
    """
214
 
# The archive mirror to use to build the jail.""", ask=True))
215
 
 
216
 
config_options.append(ConfigOption("jail/devmode", False,
217
 
    """Whether jail development mode be activated:""",
218
 
    """
219
 
# Should jail development mode be activated?""", ask=False))
220
 
 
221
 
# The password for the usrmgt-server.""", ask=False))
222
 
def query_user(default, prompt):
223
 
    """Prompts the user for a string, which is read from a line of stdin.
224
 
    Exits silently if EOF is encountered. Returns the string, with spaces
225
 
    removed from the beginning and end.
226
 
 
227
 
    Returns default if a 0-length line (after spaces removed) was read.
228
 
    """
229
 
    if default is None:
230
 
        # A default of None means the value will be computed specially, so we
231
 
        # can't really tell you what it is
232
 
        defaultstr = "computed"
233
 
    elif isinstance(default, basestring):
234
 
        defaultstr = '"%s"' % default
235
 
    else:
236
 
        defaultstr = repr(default)
237
 
    sys.stdout.write('%s\n    (default: %s)\n>' % (prompt, defaultstr))
238
 
    try:
239
 
        val = sys.stdin.readline()
240
 
    except KeyboardInterrupt:
241
 
        # Ctrl+C
242
 
        sys.stdout.write("\n")
243
 
        sys.exit(1)
244
 
    sys.stdout.write("\n")
245
 
    # If EOF, exit
246
 
    if val == '': sys.exit(1)
247
 
    # If empty line, return default
248
 
    val = val.strip()
249
 
    if val == '': return default
250
 
    return val
251
 
 
252
253
def configure(args):
 
254
    # Call the real function
 
255
    return __configure(args)
 
256
 
 
257
def __configure(args):
 
258
    global db_port, usrmgt_port
 
259
 
253
260
    # Try importing existing conf, but if we can't just set up defaults
254
261
    # The reason for this is that these settings are used by other phases
255
262
    # of setup besides conf, so we need to know them.
256
263
    # Also this allows you to hit Return to accept the existing value.
257
264
    try:
258
 
        conf = ivle.config.Config()
259
 
    except ivle.config.ConfigError:
260
 
        # Couldn't find a config file anywhere.
261
 
        # Create a new blank config object (not yet bound to a file)
262
 
        # All lookups (below) will fail, so it will be initialised with all
263
 
        # the default values.
264
 
        conf = ivle.config.Config(blank=True)
265
 
 
266
 
    # Check that all the options are present, and if not, load the default
267
 
    for opt in config_options:
268
 
        try:
269
 
            conf.get_by_path(opt.option_name)
270
 
        except KeyError:
271
 
            # If the default is None, omit it
272
 
            # Else ConfigObj will write the string 'None' to the conf file
273
 
            if opt.default is not None:
274
 
                conf.set_by_path(opt.option_name, opt.default)
275
 
 
276
 
    # Store comments in the conf object
277
 
    for opt in config_options:
278
 
        # Omitted if the key doesn't exist
279
 
        conf.set_by_path(opt.option_name, comment=opt.comment)
 
265
        confmodule = __import__("ivle/conf/conf")
 
266
        for opt in config_options:
 
267
            try:
 
268
                globals()[opt.option_name] = \
 
269
                confmodule.__dict__[opt.option_name]
 
270
            except:
 
271
                globals()[opt.option_name] = opt.default
 
272
    except ImportError:
 
273
        # Just set reasonable defaults
 
274
        for opt in config_options:
 
275
            globals()[opt.option_name] = opt.default
280
276
 
281
277
    # Set up some variables
282
278
    cwd = os.getcwd()
283
279
 
284
280
    # the files that will be created/overwritten
285
 
    try:
286
 
        confdir = os.environ['IVLECONF']
287
 
    except KeyError:
288
 
        confdir = '/etc/ivle'
289
 
 
290
 
    conffile = os.path.join(confdir, 'ivle.conf')
291
 
    plugindefaultfile = os.path.join(confdir, 'plugins.d/000default.conf')
 
281
    conffile = os.path.join(cwd, "etc/ivle.conf")
 
282
    conf_hfile = os.path.join(cwd, "bin/trampoline/conf.h")
 
283
    phpBBconffile = os.path.join(cwd, "www/php/phpBB3/config.php")
292
284
 
293
285
    # Get command-line arguments to avoid asking questions.
294
286
 
298
290
    (opts, args) = getopt.gnu_getopt(args, "", optnames)
299
291
 
300
292
    if args != []:
301
 
        print >>sys.stderr, "Invalid arguments:", ' '.join(args)
 
293
        print >>sys.stderr, "Invalid arguments:", string.join(args, ' ')
302
294
        return 2
303
295
 
304
296
    if opts == []:
305
297
        # Interactive mode. Prompt the user for all the values.
306
298
 
307
 
        print """This tool will create %s, prompting you for details about
308
 
your configuration. The file will be updated with modified options if it already
309
 
exists. If it does not already exist, it will be created with sane defaults and
310
 
restrictive permissions.
311
 
 
312
 
%s will also be overwritten with the default list of plugins.
 
299
        print """This tool will create the following files:
 
300
    %s
 
301
    %s
 
302
    %s
 
303
prompting you for details about your configuration. The file will be
 
304
overwritten if it already exists. It will *not* install or deploy IVLE.
313
305
 
314
306
Please hit Ctrl+C now if you do not wish to do this.
315
 
""" % (conffile, plugindefaultfile)
 
307
""" % (conffile, conf_hfile, phpBBconffile)
316
308
 
317
309
        # Get information from the administrator
318
310
        # If EOF is encountered at any time during the questioning, just exit
320
312
 
321
313
        for opt in config_options:
322
314
            if opt.ask:
323
 
                conf.set_by_path(opt.option_name,
324
 
                    query_user(conf.get_by_path(opt.option_name), opt.prompt))
 
315
                globals()[opt.option_name] = \
 
316
                    query_user(globals()[opt.option_name], opt.prompt)
325
317
    else:
326
318
        opts = dict(opts)
327
319
        # Non-interactive mode. Parse the options.
328
320
        for opt in config_options:
329
321
            if '--' + opt.option_name in opts:
330
 
                conf.set_by_path(opt.option_name,
331
 
                                 opts['--' + opt.option_name])
 
322
                globals()[opt.option_name] = opts['--' + opt.option_name]
332
323
 
333
324
    # Error handling on input values
334
325
    try:
335
 
        conf['database']['port'] = int(conf['database']['port'])
336
 
        if (conf['database']['port'] < 0
337
 
            or conf['database']['port'] >= 65536):
338
 
            raise ValueError()
339
 
    except ValueError:
340
 
        if conf['database']['port'] == '' or conf['database']['port'] is None:
341
 
            pass
342
 
        else:
343
 
            print >>sys.stderr, (
344
 
            "Invalid DB port (%s).\n"
345
 
            "Must be an integer between 0 and 65535." %
346
 
                repr(conf['database']['port']))
347
 
            return 1
348
 
    try:
349
 
        conf['usrmgt']['port'] = int(conf['usrmgt']['port'])
350
 
        if (conf['usrmgt']['port'] < 0 or conf['usrmgt']['port'] >= 65536):
351
 
            raise ValueError()
 
326
        allowed_uids_list = map(int, allowed_uids.split(','))
 
327
    except ValueError:
 
328
        print >>sys.stderr, (
 
329
        "Invalid UID list (%s).\n"
 
330
        "Must be a comma-separated list of integers." % allowed_uids)
 
331
        return 1
 
332
    try:
 
333
        db_port = int(db_port)
 
334
        if db_port < 0 or db_port >= 65536: raise ValueError()
 
335
    except ValueError:
 
336
        print >>sys.stderr, (
 
337
        "Invalid DB port (%s).\n"
 
338
        "Must be an integer between 0 and 65535." % repr(db_port))
 
339
        return 1
 
340
    try:
 
341
        usrmgt_port = int(usrmgt_port)
 
342
        if usrmgt_port < 0 or usrmgt_port >= 65536: raise ValueError()
352
343
    except ValueError:
353
344
        print >>sys.stderr, (
354
345
        "Invalid user management port (%s).\n"
355
 
        "Must be an integer between 0 and 65535." %
356
 
            repr(conf['usrmgt']['port']))
 
346
        "Must be an integer between 0 and 65535." % repr(usrmgt_port))
357
347
        return 1
358
348
 
359
349
    # By default we generate the magic randomly.
360
 
    try:
361
 
        conf['usrmgt']['magic']     # Throw away; just check for KeyError
362
 
    except KeyError:
363
 
        conf['usrmgt']['magic'] = hashlib.md5(uuid.uuid4().bytes).hexdigest()
364
 
 
365
 
    clobber_permissions = not os.path.exists(conffile)
366
 
 
367
 
    # Write ./etc/ivle.conf (even if we loaded from a different filename)
 
350
    if globals()['usrmgt_magic'] is None:
 
351
        globals()['usrmgt_magic'] = hashlib.md5(uuid.uuid4().bytes).hexdigest()
 
352
 
 
353
    # Generate the forum secret
 
354
    forum_secret = hashlib.md5(uuid.uuid4().bytes).hexdigest()
 
355
 
 
356
    # Write ./etc/ivle.conf
 
357
 
 
358
    conf = configobj.ConfigObj()
368
359
    conf.filename = conffile
 
360
 
369
361
    conf.initial_comment = ["# IVLE Configuration File"]
 
362
 
 
363
    # Add the forum secret to the config file (regenerated each config)
 
364
    config_options.append(ConfigOption('forum_secret', None, '', ''))
 
365
    globals()['forum_secret'] = forum_secret
 
366
 
 
367
    for legacyopt in config_options:
 
368
        newopt_path = CONFIG_OPTIONS[legacyopt.option_name].split('/')
 
369
        # Iterate over each segment of the path, and find the section in conf
 
370
        # file to insert the value into (use all but the last path segment)
 
371
        conf_section = conf
 
372
        for seg in newopt_path[:-1]:
 
373
            # Create the section if it isn't there
 
374
            if seg not in conf_section:
 
375
                conf_section[seg] = {}
 
376
            conf_section = conf_section[seg]
 
377
        # The final path segment names the key to insert into
 
378
        keyname = newopt_path[-1]
 
379
        value = globals()[legacyopt.option_name]
 
380
        if value is not None:
 
381
            conf_section[keyname] = value
 
382
            conf_section.comments[keyname] = legacyopt.comment.split('\n')
 
383
 
370
384
    conf.write()
371
385
 
372
 
    # We need to restrict permissions on a new file, as it contains
373
 
    # a nice database password.
374
 
    if clobber_permissions:
375
 
        os.chown(conffile, 33, 33) # chown to www-data
376
 
        os.chmod(conffile, stat.S_IRUSR | stat.S_IWUSR) # No g/o perms!
377
 
 
378
386
    print "Successfully wrote %s" % conffile
379
387
 
380
 
    plugindefault = open(plugindefaultfile, 'w')
381
 
    plugindefault.write("""# IVLE default plugin configuration file
382
 
[ivle.webapp.core#Plugin]
383
 
[ivle.webapp.admin.user#Plugin]
384
 
[ivle.webapp.tutorial#Plugin]
385
 
[ivle.webapp.admin.subject#Plugin]
386
 
[ivle.webapp.filesystem.browser#Plugin]
387
 
[ivle.webapp.filesystem.diff#Plugin]
388
 
[ivle.webapp.filesystem.svnlog#Plugin]
389
 
[ivle.webapp.filesystem.serve#Plugin]
390
 
[ivle.webapp.groups#Plugin]
391
 
[ivle.webapp.console#Plugin]
392
 
[ivle.webapp.security#Plugin]
393
 
[ivle.webapp.media#Plugin]
394
 
[ivle.webapp.help#Plugin]
395
 
[ivle.webapp.tos#Plugin]
396
 
[ivle.webapp.userservice#Plugin]
397
 
[ivle.webapp.fileservice#Plugin]
398
 
[ivle.webapp.submit#Plugin]
399
 
""")
400
 
    plugindefault.close()
401
 
    print "Successfully wrote %s" % plugindefaultfile
402
 
 
403
 
    print
404
 
    print "You may modify the configuration at any time by editing " + conffile
 
388
    # Write bin/trampoline/conf.h
 
389
 
 
390
    conf = open(conf_hfile, "w")
 
391
 
 
392
    # XXX Compute jail_base, jail_src_base and jail_system. These will
 
393
    # ALSO be done by the boilerplate code, but we need them here in order
 
394
    # to write to the C file.
 
395
    jail_base = os.path.join(data_path, 'jailmounts')
 
396
    jail_src_base = os.path.join(data_path, 'jails')
 
397
    jail_system = os.path.join(jail_src_base, '__base__')
 
398
 
 
399
    conf.write("""/* IVLE Configuration File
 
400
 * conf.h
 
401
 * Administrator settings required by trampoline.
 
402
 * Note: trampoline will have to be rebuilt in order for changes to this file
 
403
 * to take effect.
 
404
 */
 
405
 
 
406
#define IVLE_AUFS_JAILS
 
407
 
 
408
/* In the local file system, where are the jails located.
 
409
 * The trampoline does not allow the creation of a jail anywhere besides
 
410
 * jail_base or a subdirectory of jail_base.
 
411
 */
 
412
static const char* jail_base = "%s";
 
413
static const char* jail_src_base = "%s";
 
414
static const char* jail_system = "%s";
 
415
 
 
416
/* Which user IDs are allowed to run the trampoline.
 
417
 * This list should be limited to the web server user.
 
418
 * (Note that root is an implicit member of this list).
 
419
 */
 
420
static const int allowed_uids[] = { %s };
 
421
""" % (repr(jail_base)[1:-1], repr(jail_src_base)[1:-1],
 
422
       repr(jail_system)[1:-1], repr(allowed_uids_list)[1:-1]))
 
423
    # Note: The above uses PYTHON reprs, not C reprs
 
424
    # However they should be the same with the exception of the outer
 
425
    # characters, which are stripped off and replaced
 
426
 
 
427
    conf.close()
 
428
 
 
429
    print "Successfully wrote %s" % conf_hfile
 
430
 
 
431
    # Write www/php/phpBB3/config.php
 
432
 
 
433
    conf = open(phpBBconffile, "w")
 
434
    
 
435
    # php-pg work around
 
436
    if db_host == 'localhost':
 
437
        forumdb_host = '127.0.0.1'
 
438
    else:
 
439
        forumdb_host = db_host
 
440
 
 
441
    conf.write( """<?php
 
442
// phpBB 3.0.x auto-generated configuration file
 
443
// Do not change anything in this file!
 
444
$dbms = 'postgres';
 
445
$dbhost = '""" + forumdb_host + """';
 
446
$dbport = '""" + str(db_port) + """';
 
447
$dbname = '""" + db_forumdbname + """';
 
448
$dbuser = '""" + db_user + """';
 
449
$dbpasswd = '""" + db_password + """';
 
450
 
 
451
$table_prefix = 'phpbb_';
 
452
$acm_type = 'file';
 
453
$load_extensions = '';
 
454
@define('PHPBB_INSTALLED', true);
 
455
// @define('DEBUG', true);
 
456
//@define('DEBUG_EXTRA', true);
 
457
 
 
458
$forum_secret = '""" + forum_secret +"""';
 
459
?>"""   )
 
460
    
 
461
    conf.close()
 
462
 
 
463
    print "Successfully wrote %s" % phpBBconffile
 
464
 
 
465
    print
 
466
    print "You may modify the configuration at any time by editing"
 
467
    print conffile
 
468
    print conf_hfile
 
469
    print phpBBconffile
 
470
    print
405
471
    
406
472
    return 0
407
 
 
408
 
def main(argv=None):
409
 
    if argv is None:
410
 
        argv = sys.argv
411
 
 
412
 
    # Print the opening spiel including the GPL notice
413
 
 
414
 
    print """IVLE - Informatics Virtual Learning Environment Setup
415
 
Copyright (C) 2007-2009 The University of Melbourne
416
 
IVLE comes with ABSOLUTELY NO WARRANTY.
417
 
This is free software, and you are welcome to redistribute it
418
 
under certain conditions. See LICENSE.txt for details.
419
 
 
420
 
IVLE Configuration
421
 
"""
422
 
 
423
 
    return configure(argv[1:])
424
 
 
425
 
if __name__ == "__main__":
426
 
    sys.exit(main())