← Back to branch summary

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

« back to all changes in this revision

Viewing changes to bin/ivle-config

Merge setup-stuff.

phpBB is gone, configuration, setup and jail building are completely redone.

Please read doc/setup/install_proc.txt, or you'll not get far.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bin/ivle-config
 
1
#!/usr/bin/python
1
2
# IVLE - Informatics Virtual Learning Environment
2
 
# Copyright (C) 2007-2008 The University of Melbourne
 
3
# Copyright (C) 2007-2009 The University of Melbourne
3
4
#
4
5
# This program is free software; you can redistribute it and/or modify
5
6
# it under the terms of the GNU General Public License as published by
15
16
# along with this program; if not, write to the Free Software
16
17
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
17
18
 
18
 
# Module: setup/config
19
19
# Author: Matt Giuca, Refactored by David Coles
20
 
# Date:   03/07/2008
21
 
 
22
 
# setup/config.py
23
 
# Configures IVLE with machine-specific details, most notably, various paths.
24
 
# Either prompts the administrator for these details or accepts them as
25
 
# command-line args.
26
 
# Creates lib/conf/conf.py and trampoline/conf.h.
 
20
 
 
21
'''Configures IVLE with machine-specific details, most notably, various paths.
 
22
Either prompts the administrator for these details or accepts them as
 
23
command-line args.
 
24
 
 
25
Creates etc/ivle.conf
 
26
'''
27
27
 
28
28
import optparse
29
29
import getopt
30
30
import os
31
31
import sys
 
32
import stat
32
33
import hashlib
33
34
import uuid
34
 
from setup.setuputil import query_user
 
35
 
 
36
import ivle.config
 
37
 
 
38
import configobj
35
39
 
36
40
class ConfigOption:
37
41
    """A configuration option; one of the things written to conf.py."""
38
 
    def __init__(self, option_name, default, prompt, comment):
 
42
    def __init__(self, option_name, default, prompt, comment, ask=True):
39
43
        """Creates a configuration option.
40
44
        option_name: Name of the variable in conf.py. Also name of the
41
45
            command-line argument to setup.py conf.
44
48
            setup.py conf.
45
49
        comment: (Long) comment string stored in conf.py. Each line of this
46
50
            string should begin with a '#'.
 
51
        ask: Whether to ask the question in the default config run.
47
52
        """
48
53
        self.option_name = option_name
49
54
        self.default = default
50
55
        self.prompt = prompt
51
56
        self.comment = comment
 
57
        self.ask = ask
52
58
 
53
59
# Configuration options, defaults and descriptions
54
60
config_options = []
55
 
config_options.append(ConfigOption("root_dir", "/",
 
61
 
 
62
config_options.append(ConfigOption("urls/root", "/",
56
63
    """Root directory where IVLE is located (in URL space):""",
57
64
    """
58
65
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
59
66
# with this).
60
 
# eg. "/" or "/ivle"."""))
61
 
config_options.append(ConfigOption("ivle_install_dir", "/opt/ivle",
62
 
    'Root directory where IVLE will be installed (on the local file '
63
 
    'system):',
64
 
    """
65
 
# In the local file system, where IVLE is actually installed.
66
 
# This directory should contain the "www" and "bin" directories."""))
67
 
config_options.append(ConfigOption("jail_base", "/home/informatics/jails",
68
 
    """Location of jail mountpoints
69
 
============================
70
 
Root directory where the user jails will be mounted, and the non-user
71
 
components of the jails will be stored (on the local file system):""",
72
 
    """
73
 
# In the local file system, where the student/user jails will be mounted.
74
 
# Only a single copy of the jail's system components will be stored here -
75
 
# all user jails will be virtually mounted here."""))
76
 
config_options.append(ConfigOption("jail_system", "/home/informatics/jails/__base__",
77
 
    """Location of system jail components
78
 
==================================
79
 
Directory where the template system jail will be stored.""",
80
 
    """
81
 
# In the local file system, where the template system jail will be stored."""))
82
 
config_options.append(ConfigOption("jail_src_base", "/home/informatics/jailssrc",
83
 
    """Location of user jail components
84
 
================================
85
 
Root directory where the user components of the jails will be stored (on the
86
 
local file system):""",
87
 
    """
88
 
# In the local file system, where are the student/user file spaces located.
89
 
# The user jails are expected to be located immediately in subdirectories of
90
 
# this location. Note that no complete jails reside here - only user
91
 
# modifications."""))
92
 
config_options.append(ConfigOption("subjects_base",
93
 
    "/home/informatics/subjects",
94
 
    """Root directory where the subject directories (containing worksheets
95
 
and other per-subject files) are stored (on the local file system):""",
96
 
    """
97
 
# In the local file system, where are the per-subject file spaces located.
98
 
# The individual subject directories are expected to be located immediately
99
 
# in subdirectories of this location."""))
100
 
config_options.append(ConfigOption("exercises_base",
101
 
    "/home/informatics/exercises",
102
 
    """Root directory where the exercise directories (containing
103
 
subject-independent exercise sheets) are stored (on the local file
104
 
system):""",
105
 
    """
106
 
# In the local file system, where are the subject-independent exercise sheet
107
 
# file spaces located."""))
108
 
config_options.append(ConfigOption("tos_path",
109
 
    "/home/informatics/tos.html",
110
 
    """Location where the Terms of Service document is stored (on the local
111
 
    file system):""",
112
 
    """
113
 
# In the local file system, where is the Terms of Service document located."""))
114
 
config_options.append(ConfigOption("motd_path",
115
 
    "/home/informatics/motd.html",
116
 
    """Location where the Message of the Day document is stored (on the local
117
 
    file system):""",
118
 
    """
119
 
# In the local file system, where is the Message of the Day document
120
 
# located. This is an HTML file (just the body fragment), which will
121
 
# be displayed on the login page. It is optional."""))
122
 
config_options.append(ConfigOption("public_host", "public.localhost",
 
67
# eg. "/" or "/ivle".""", ask=False))
 
68
 
 
69
config_options.append(ConfigOption("paths/prefix", "/usr/local",
 
70
    """In the local file system, the prefix to the system directory where IVLE
 
71
is installed. (This should either be /usr or /usr/local):""",
 
72
    """
 
73
# In the local file system, the prefix to the system directory where IVLE is
 
74
# installed. This should either be '/usr' or '/usr/local'.
 
75
# ('/usr/local' for the usual install, '/usr' for distribution packages)""",
 
76
    ask=False))
 
77
 
 
78
config_options.append(ConfigOption("paths/site_packages",
 
79
    None,
 
80
    """site-packages directory in Python, where Python libraries are to be
 
81
installed. May be left as the default, in which case the value will be
 
82
computed from prefix and the current Python version:""",
 
83
    """
 
84
# 'site-packages' directory in Python, where Python libraries are to be
 
85
# installed. May be omitted (recommended), in which case the value will be
 
86
# computed from prefix and the current Python version.""", ask=False))
 
87
 
 
88
config_options.append(ConfigOption("paths/data",
 
89
    "/var/lib/ivle",
 
90
    "In the local file system, where user-modifiable data files should be "
 
91
    "located:",
 
92
    """
 
93
# In the local file system, where user-modifiable data files should be
 
94
# located.""", ask=False))
 
95
 
 
96
config_options.append(ConfigOption("paths/logs",
 
97
    "/var/log/ivle",
 
98
    """Directory where IVLE log files are stored (on the local
 
99
file system). Note - this must be writable by the user the IVLE server 
 
100
process runs as (usually www-data):""",
 
101
    """
 
102
# In the local file system, where IVLE error logs should be located.""",
 
103
    ask=False))
 
104
 
 
105
config_options.append(ConfigOption("urls/public_host", "public.localhost",
123
106
    """Hostname which will cause the server to go into "public mode",
124
107
providing login-free access to student's published work:""",
125
108
    """
129
112
# Public mode does not use cookies, and serves only public content.
130
113
# Private mode (normal mode) requires login, and only serves files relevant to
131
114
# the logged-in user."""))
132
 
config_options.append(ConfigOption("allowed_uids", "33",
133
 
    """UID of the web server process which will run IVLE.
134
 
Only this user may execute the trampoline. May specify multiple users as
135
 
a comma-separated list.
136
 
    (eg. "1002,78")""",
137
 
    """
138
 
# The User-ID of the web server process which will run IVLE, and any other
139
 
# users who are allowed to run the trampoline. This is stores as a string of
140
 
# comma-separated integers, simply because it is not used within Python, only
141
 
# used by the setup program to write to conf.h (see setup.py config)."""))
142
 
config_options.append(ConfigOption("db_host", "localhost",
 
115
 
 
116
config_options.append(ConfigOption("database/host", "localhost",
143
117
    """PostgreSQL Database config
144
118
==========================
145
119
Hostname of the DB server:""",
146
120
    """
147
 
### PostgreSQL Database config ###
148
121
# Database server hostname"""))
149
 
config_options.append(ConfigOption("db_port", "5432",
 
122
 
 
123
config_options.append(ConfigOption("database/port", "5432",
150
124
    """Port of the DB server:""",
151
125
    """
152
126
# Database server port"""))
153
 
config_options.append(ConfigOption("db_dbname", "ivle",
 
127
 
 
128
config_options.append(ConfigOption("database/name", "ivle",
154
129
    """Database name:""",
155
130
    """
156
131
# Database name"""))
157
 
config_options.append(ConfigOption("db_forumdbname", "ivle_forum",
158
 
    """Forum Database name:""",
159
 
    """
160
 
# Forum Database name"""))
161
 
config_options.append(ConfigOption("db_user", "postgres",
 
132
 
 
133
config_options.append(ConfigOption("database/username", "postgres",
162
134
    """Username for DB server login:""",
163
135
    """
164
136
# Database username"""))
165
 
config_options.append(ConfigOption("db_password", "",
 
137
 
 
138
config_options.append(ConfigOption("database/password", "",
166
139
    """Password for DB server login:
167
 
    (Caution: This password is stored in plaintext in lib/conf/conf.py)""",
 
140
    (Caution: This password is stored in plaintext!)""",
168
141
    """
169
142
# Database password"""))
170
 
config_options.append(ConfigOption("auth_modules", "ldap_auth",
 
143
 
 
144
config_options.append(ConfigOption("auth/modules", "",
171
145
    """Authentication config
172
146
=====================
173
 
Comma-separated list of authentication modules. Only "ldap" is available
174
 
by default.""",
 
147
Comma-separated list of authentication modules.""",
175
148
    """
176
149
# Comma-separated list of authentication modules.
 
150
# Note that auth is always enabled against the local database, and NO OTHER
 
151
# auth is enabled by default. This section is for specifying additional auth
 
152
# modules.
177
153
# These refer to importable Python modules in the www/auth directory.
178
 
# Modules "ldap" and "guest" are available in the source tree, but
 
154
# Modules "ldap_auth" and "guest" are available in the source tree, but
179
155
# other modules may be plugged in to auth against organisation-specific
180
 
# auth backends."""))
181
 
config_options.append(ConfigOption("ldap_url", "ldaps://www.example.com",
 
156
# auth backends.""", ask=False))
 
157
 
 
158
config_options.append(ConfigOption("auth/ldap_url", "ldaps://www.example.com",
182
159
    """(LDAP options are only relevant if "ldap" is included in the list of
183
160
auth modules).
184
161
URL for LDAP authentication server:""",
185
162
    """
186
 
# URL for LDAP authentication server"""))
187
 
config_options.append(ConfigOption("ldap_format_string",
 
163
# URL for LDAP authentication server""", ask=False))
 
164
 
 
165
config_options.append(ConfigOption("auth/ldap_format_string",
188
166
    "uid=%s,ou=users,o=example",
189
167
    """Format string for LDAP auth request:
190
168
    (Must contain a single "%s" for the user's login name)""",
191
169
    """
192
170
# Format string for LDAP auth request
193
 
# (Must contain a single "%s" for the user's login name)"""))
194
 
config_options.append(ConfigOption("subject_pulldown_modules", "",
 
171
# (Must contain a single "%s" for the user's login name)""", ask=False))
 
172
 
 
173
config_options.append(ConfigOption("auth/subject_pulldown_modules", "",
195
174
    """Comma-separated list of subject pulldown modules.
196
175
Add proprietary modules to automatically enrol students in subjects.""",
197
176
    """
199
178
# These refer to importable Python modules in the lib/pulldown_subj directory.
200
179
# Only "dummy_subj" is available in the source tree (an example), but
201
180
# other modules may be plugged in to pulldown against organisation-specific
202
 
# pulldown backends."""))
203
 
config_options.append(ConfigOption("svn_addr", "http://svn.localhost/",
 
181
# pulldown backends.""", ask=False))
 
182
 
 
183
config_options.append(ConfigOption("urls/svn_addr", "http://svn.localhost/",
204
184
    """Subversion config
205
185
=================
206
186
The base url for accessing subversion repositories:""",
207
187
    """
208
188
# The base url for accessing subversion repositories."""))
209
 
config_options.append(ConfigOption("svn_conf", "/opt/ivle/svn/svn.conf",
210
 
    """The location of the subversion configuration file used by apache
211
 
to host the user repositories:""",
212
 
    """
213
 
# The location of the subversion configuration file used by
214
 
# apache to host the user repositories."""))
215
 
config_options.append(ConfigOption("svn_repo_path", "/home/informatics/repositories",
216
 
    """The root directory for the subversion repositories:""",
217
 
    """
218
 
# The root directory for the subversion repositories."""))
219
 
config_options.append(ConfigOption("svn_auth_ivle", "/opt/ivle/svn/ivle.auth",
220
 
    """The location of the password file used to authenticate users
221
 
of the subversion repository from the ivle server:""",
222
 
    """
223
 
# The location of the password file used to authenticate users
224
 
# of the subversion repository from the ivle server."""))
225
 
config_options.append(ConfigOption("svn_auth_local", "/opt/ivle/svn/local.auth",
226
 
    """The location of the password file used to authenticate local users
227
 
of the subversion repository:""",
228
 
    """
229
 
# The location of the password file used to authenticate local users
230
 
# of the subversion repository."""))
231
 
config_options.append(ConfigOption("usrmgt_host", "localhost",
 
189
 
 
190
config_options.append(ConfigOption("usrmgt/host", "localhost",
232
191
    """User Management Server config
233
192
============================
234
193
The hostname where the usrmgt-server runs:""",
235
194
    """
236
195
# The hostname where the usrmgt-server runs."""))
237
 
config_options.append(ConfigOption("usrmgt_port", "2178",
 
196
 
 
197
config_options.append(ConfigOption("usrmgt/port", "2178",
238
198
    """The port where the usrmgt-server runs:""",
239
199
    """
240
 
# The port where the usrmgt-server runs."""))
241
 
config_options.append(ConfigOption("usrmgt_magic", "",
 
200
# The port where the usrmgt-server runs.""", ask=False))
 
201
 
 
202
config_options.append(ConfigOption("usrmgt/magic", None,
242
203
    """The password for the usrmgt-server:""",
243
204
    """
244
 
# The password for the usrmgt-server."""))
 
205
# The password for the usrmgt-server.""", ask=False))
 
206
 
 
207
def query_user(default, prompt):
 
208
    """Prompts the user for a string, which is read from a line of stdin.
 
209
    Exits silently if EOF is encountered. Returns the string, with spaces
 
210
    removed from the beginning and end.
 
211
 
 
212
    Returns default if a 0-length line (after spaces removed) was read.
 
213
    """
 
214
    if default is None:
 
215
        # A default of None means the value will be computed specially, so we
 
216
        # can't really tell you what it is
 
217
        defaultstr = "computed"
 
218
    elif isinstance(default, basestring):
 
219
        defaultstr = '"%s"' % default
 
220
    else:
 
221
        defaultstr = repr(default)
 
222
    sys.stdout.write('%s\n    (default: %s)\n>' % (prompt, defaultstr))
 
223
    try:
 
224
        val = sys.stdin.readline()
 
225
    except KeyboardInterrupt:
 
226
        # Ctrl+C
 
227
        sys.stdout.write("\n")
 
228
        sys.exit(1)
 
229
    sys.stdout.write("\n")
 
230
    # If EOF, exit
 
231
    if val == '': sys.exit(1)
 
232
    # If empty line, return default
 
233
    val = val.strip()
 
234
    if val == '': return default
 
235
    return val
245
236
 
246
237
def configure(args):
247
 
    usage = """usage: %prog build [options]
248
 
(requires root)
249
 
Compiles all files and sets up a jail template in the source directory.
250
 
-O is recommended to cause compilation to be optimised.
251
 
Details:
252
 
Compiles (GCC) trampoline/trampoline.c to trampoline/trampoline.
253
 
Creates jail with system and student packages installed from MIRROR.
254
 
Copies console/ to a location within the jail.
255
 
Copies OS programs and files to corresponding locations within the jail
256
 
  (eg. python and Python libs, ld.so, etc).
257
 
Generates .pyc or .pyo files for all the IVLE .py files."""
258
 
 
259
 
    # Parse arguments
260
 
    parser = optparse.OptionParser(usage)
261
 
    (options, args) = parser.parse_args(args)
262
 
 
263
 
    # Call the real function
264
 
    __configure(args)
265
 
 
266
 
def __configure(args):
267
 
    global db_port, usrmgt_port
268
 
 
269
238
    # Try importing existing conf, but if we can't just set up defaults
270
239
    # The reason for this is that these settings are used by other phases
271
240
    # of setup besides conf, so we need to know them.
272
241
    # Also this allows you to hit Return to accept the existing value.
273
242
    try:
274
 
        confmodule = __import__("lib/conf/conf")
275
 
        for opt in config_options:
276
 
            try:
277
 
                globals()[opt.option_name] = \
278
 
                confmodule.__dict__[opt.option_name]
279
 
            except:
280
 
                globals()[opt.option_name] = opt.default
281
 
    except ImportError:
282
 
        # Just set reasonable defaults
283
 
        for opt in config_options:
284
 
            globals()[opt.option_name] = opt.default
 
243
        conf = ivle.config.Config()
 
244
    except ivle.config.ConfigError:
 
245
        # Couldn't find a config file anywhere.
 
246
        # Create a new blank config object (not yet bound to a file)
 
247
        # All lookups (below) will fail, so it will be initialised with all
 
248
        # the default values.
 
249
        conf = ivle.config.Config(blank=True)
 
250
 
 
251
    # Check that all the options are present, and if not, load the default
 
252
    for opt in config_options:
 
253
        try:
 
254
            conf.get_by_path(opt.option_name)
 
255
        except KeyError:
 
256
            # If the default is None, omit it
 
257
            # Else ConfigObj will write the string 'None' to the conf file
 
258
            if opt.default is not None:
 
259
                conf.set_by_path(opt.option_name, opt.default)
 
260
 
 
261
    # Store comments in the conf object
 
262
    for opt in config_options:
 
263
        # Omitted if the key doesn't exist
 
264
        conf.set_by_path(opt.option_name, comment=opt.comment)
285
265
 
286
266
    # Set up some variables
287
267
    cwd = os.getcwd()
288
268
 
289
269
    # the files that will be created/overwritten
290
 
    conffile = os.path.join(cwd, "lib/conf/conf.py")
291
 
    jailconffile = os.path.join(cwd, "lib/conf/jailconf.py")
292
 
    conf_hfile = os.path.join(cwd, "trampoline/conf.h")
293
 
    phpBBconffile = os.path.join(cwd, "www/php/phpBB3/config.php")
294
 
    usrmgtserver_initdfile = os.path.join(cwd, "doc/setup/usrmgt-server.init")
 
270
    try:
 
271
        confdir = os.environ['IVLECONF']
 
272
    except KeyError:
 
273
        confdir = '/etc/ivle'
 
274
 
 
275
    conffile = os.path.join(confdir, 'ivle.conf')
 
276
    plugindefaultfile = os.path.join(confdir, 'plugins.d/000default.conf')
295
277
 
296
278
    # Get command-line arguments to avoid asking questions.
297
279
 
307
289
    if opts == []:
308
290
        # Interactive mode. Prompt the user for all the values.
309
291
 
310
 
        print """This tool will create the following files:
311
 
    %s
312
 
    %s
313
 
    %s
314
 
    %s
315
 
    %s
316
 
prompting you for details about your configuration. The file will be
317
 
overwritten if it already exists. It will *not* install or deploy IVLE.
 
292
        print """This tool will create %s, prompting you for details about
 
293
your configuration. The file will be updated with modified options if it already
 
294
exists. If it does not already exist, it will be created with sane defaults and
 
295
restrictive permissions.
 
296
 
 
297
%s will also be overwritten with the default list of plugins.
318
298
 
319
299
Please hit Ctrl+C now if you do not wish to do this.
320
 
""" % (conffile, jailconffile, conf_hfile, phpBBconffile, usrmgtserver_initdfile)
 
300
""" % (conffile, plugindefaultfile)
321
301
 
322
302
        # Get information from the administrator
323
303
        # If EOF is encountered at any time during the questioning, just exit
324
304
        # silently
325
305
 
326
306
        for opt in config_options:
327
 
            globals()[opt.option_name] = \
328
 
                query_user(globals()[opt.option_name], opt.prompt)
 
307
            if opt.ask:
 
308
                conf.set_by_path(opt.option_name,
 
309
                    query_user(conf.get_by_path(opt.option_name), opt.prompt))
329
310
    else:
330
311
        opts = dict(opts)
331
312
        # Non-interactive mode. Parse the options.
332
313
        for opt in config_options:
333
314
            if '--' + opt.option_name in opts:
334
 
                globals()[opt.option_name] = opts['--' + opt.option_name]
 
315
                conf.set_by_path(opt.option_name,
 
316
                                 opts['--' + opt.option_name])
335
317
 
336
318
    # Error handling on input values
337
319
    try:
338
 
        allowed_uids_list = map(int, allowed_uids.split(','))
339
 
    except ValueError:
340
 
        print >>sys.stderr, (
341
 
        "Invalid UID list (%s).\n"
342
 
        "Must be a comma-separated list of integers." % allowed_uids)
343
 
        return 1
344
 
    try:
345
 
        db_port = int(db_port)
346
 
        if db_port < 0 or db_port >= 65536: raise ValueError()
 
320
        conf['database']['port'] = int(conf['database']['port'])
 
321
        if (conf['database']['port'] < 0
 
322
            or conf['database']['port'] >= 65536):
 
323
            raise ValueError()
347
324
    except ValueError:
348
325
        print >>sys.stderr, (
349
326
        "Invalid DB port (%s).\n"
350
 
        "Must be an integer between 0 and 65535." % repr(db_port))
 
327
        "Must be an integer between 0 and 65535." %
 
328
            repr(conf['database']['port']))
351
329
        return 1
352
330
    try:
353
 
        usrmgt_port = int(usrmgt_port)
354
 
        if usrmgt_port < 0 or usrmgt_port >= 65536: raise ValueError()
 
331
        conf['usrmgt']['port'] = int(conf['usrmgt']['port'])
 
332
        if (conf['usrmgt']['port'] < 0 or conf['usrmgt']['port'] >= 65536):
 
333
            raise ValueError()
355
334
    except ValueError:
356
335
        print >>sys.stderr, (
357
336
        "Invalid user management port (%s).\n"
358
 
        "Must be an integer between 0 and 65535." % repr(usrmgt_port))
 
337
        "Must be an integer between 0 and 65535." %
 
338
            repr(conf['usrmgt']['port']))
359
339
        return 1
360
340
 
361
 
    # Generate the forum secret
362
 
    forum_secret = hashlib.md5(uuid.uuid4().bytes).hexdigest()
363
 
 
364
 
    # Write lib/conf/conf.py
365
 
 
 
341
    # By default we generate the magic randomly.
366
342
    try:
367
 
        conf = open(conffile, "w")
368
 
 
369
 
        conf.write("""# IVLE Configuration File
370
 
# conf.py
371
 
# Miscellaneous application settings
372
 
 
 
343
        conf['usrmgt']['magic']     # Throw away; just check for KeyError
 
344
    except KeyError:
 
345
        conf['usrmgt']['magic'] = hashlib.md5(uuid.uuid4().bytes).hexdigest()
 
346
 
 
347
    clobber_permissions = not os.path.exists(conffile)
 
348
 
 
349
    # Write ./etc/ivle.conf (even if we loaded from a different filename)
 
350
    conf.filename = conffile
 
351
    conf.initial_comment = ["# IVLE Configuration File"]
 
352
    conf.write()
 
353
 
 
354
    # We need to restrict permissions on a new file, as it contains
 
355
    # a nice database password.
 
356
    if clobber_permissions:
 
357
        os.chown(conffile, 33, 33) # chown to www-data
 
358
        os.chmod(conffile, stat.S_IRUSR | stat.S_IWUSR) # No g/o perms!
 
359
 
 
360
    print "Successfully wrote %s" % conffile
 
361
 
 
362
    plugindefault = open(plugindefaultfile, 'w')
 
363
    plugindefault.write("""# IVLE default plugin configuration file
 
364
[ivle.webapp.core#Plugin]
 
365
[ivle.webapp.admin.user#Plugin]
 
366
[ivle.webapp.tutorial#Plugin]
 
367
[ivle.webapp.admin.subject#Plugin]
 
368
[ivle.webapp.filesystem.browser#Plugin]
 
369
[ivle.webapp.filesystem.diff#Plugin]
 
370
[ivle.webapp.filesystem.svnlog#Plugin]
 
371
[ivle.webapp.filesystem.serve#Plugin]
 
372
[ivle.webapp.groups#Plugin]
 
373
[ivle.webapp.console#Plugin]
 
374
[ivle.webapp.security#Plugin]
 
375
[ivle.webapp.media#Plugin]
 
376
[ivle.webapp.help#Plugin]
 
377
[ivle.webapp.tos#Plugin]
 
378
[ivle.webapp.userservice#Plugin]
373
379
""")
374
 
        for opt in config_options:
375
 
            conf.write('%s\n%s = %s\n' % (opt.comment, opt.option_name,
376
 
                repr(globals()[opt.option_name])))
377
 
 
378
 
        # Add the forum secret to the config file (regenerated each config)
379
 
        conf.write('forum_secret = "%s"\n' % (forum_secret))
380
 
 
381
 
        conf.close()
382
 
    except IOError, (errno, strerror):
383
 
        print "IO error(%s): %s" % (errno, strerror)
384
 
        sys.exit(1)
385
 
 
386
 
    print "Successfully wrote lib/conf/conf.py"
387
 
 
388
 
    # Write conf/jailconf.py
389
 
 
390
 
    try:
391
 
        conf = open(jailconffile, "w")
392
 
 
393
 
        # In the "in-jail" version of conf, we don't need MOST of the details
394
 
        # (it would be a security risk to have them here).
395
 
        # So we just write root_dir, and jail_base is "/".
396
 
        # (jail_base being "/" means "jail-relative" paths are relative to "/"
397
 
        # when inside the jail.)
398
 
        conf.write("""# IVLE Configuration File
399
 
# conf.py
400
 
# Miscellaneous application settings
401
 
# (User jail version)
402
 
 
403
 
 
404
 
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
405
 
# with this).
406
 
# eg. "/" or "/ivle".
407
 
root_dir = %s
408
 
 
409
 
# In the local file system, where are the student/user file spaces located.
410
 
# The user jails are expected to be located immediately in subdirectories of
411
 
# this location.
412
 
jail_base = '/'
413
 
 
414
 
# The hostname for serving publicly accessible pages
415
 
public_host = %s
416
 
""" % (repr(root_dir),repr(public_host)))
417
 
 
418
 
        conf.close()
419
 
    except IOError, (errno, strerror):
420
 
        print "IO error(%s): %s" % (errno, strerror)
421
 
        sys.exit(1)
422
 
 
423
 
    print "Successfully wrote lib/conf/jailconf.py"
424
 
 
425
 
    # Write trampoline/conf.h
426
 
 
427
 
    try:
428
 
        conf = open(conf_hfile, "w")
429
 
 
430
 
        conf.write("""/* IVLE Configuration File
431
 
 * conf.h
432
 
 * Administrator settings required by trampoline.
433
 
 * Note: trampoline will have to be rebuilt in order for changes to this file
434
 
 * to take effect.
435
 
 */
436
 
 
437
 
#define IVLE_AUFS_JAILS
438
 
 
439
 
/* In the local file system, where are the jails located.
440
 
 * The trampoline does not allow the creation of a jail anywhere besides
441
 
 * jail_base or a subdirectory of jail_base.
442
 
 */
443
 
static const char* jail_base = "%s";
444
 
static const char* jail_src_base = "%s";
445
 
static const char* jail_system = "%s";
446
 
 
447
 
/* Which user IDs are allowed to run the trampoline.
448
 
 * This list should be limited to the web server user.
449
 
 * (Note that root is an implicit member of this list).
450
 
 */
451
 
static const int allowed_uids[] = { %s };
452
 
""" % (repr(jail_base)[1:-1], repr(jail_src_base)[1:-1],
453
 
       repr(jail_system)[1:-1], repr(allowed_uids_list)[1:-1]))
454
 
    # Note: The above uses PYTHON reprs, not C reprs
455
 
    # However they should be the same with the exception of the outer
456
 
    # characters, which are stripped off and replaced
457
 
 
458
 
        conf.close()
459
 
    except IOError, (errno, strerror):
460
 
        print "IO error(%s): %s" % (errno, strerror)
461
 
        sys.exit(1)
462
 
 
463
 
    print "Successfully wrote trampoline/conf.h"
464
 
 
465
 
    # Write www/php/phpBB3/config.php
466
 
 
467
 
    try:
468
 
        conf = open(phpBBconffile, "w")
469
 
        
470
 
        # php-pg work around
471
 
        if db_host == 'localhost':
472
 
            forumdb_host = '127.0.0.1'
473
 
        else:
474
 
            forumdb_host = db_host
475
 
 
476
 
        conf.write( """<?php
477
 
// phpBB 3.0.x auto-generated configuration file
478
 
// Do not change anything in this file!
479
 
$dbms = 'postgres';
480
 
$dbhost = '""" + forumdb_host + """';
481
 
$dbport = '""" + str(db_port) + """';
482
 
$dbname = '""" + db_forumdbname + """';
483
 
$dbuser = '""" + db_user + """';
484
 
$dbpasswd = '""" + db_password + """';
485
 
 
486
 
$table_prefix = 'phpbb_';
487
 
$acm_type = 'file';
488
 
$load_extensions = '';
489
 
@define('PHPBB_INSTALLED', true);
490
 
// @define('DEBUG', true);
491
 
//@define('DEBUG_EXTRA', true);
492
 
 
493
 
$forum_secret = '""" + forum_secret +"""';
494
 
?>"""   )
495
 
    
496
 
        conf.close()
497
 
    except IOError, (errno, strerror):
498
 
        print "IO error(%s): %s" % (errno, strerror)
499
 
        sys.exit(1)
500
 
 
501
 
    print "Successfully wrote www/php/phpBB3/config.php"
502
 
 
503
 
    # Write lib/conf/usrmgt-server.init
504
 
 
505
 
    try:
506
 
        conf = open(usrmgtserver_initdfile, "w")
507
 
 
508
 
        conf.write( '''#! /bin/sh
509
 
 
510
 
# Works for Ubuntu. Check before using on other distributions
511
 
 
512
 
### BEGIN INIT INFO
513
 
# Provides:          usrmgt-server
514
 
# Required-Start:    $syslog $networking $urandom
515
 
# Required-Stop:     $syslog
516
 
# Default-Start:     2 3 4 5
517
 
# Default-Stop:      1
518
 
# Short-Description: IVLE user management server
519
 
# Description:       Daemon connecting to the IVLE user management database.
520
 
### END INIT INFO
521
 
 
522
 
PATH=/sbin:/bin:/usr/sbin:/usr/bin
523
 
DESC="IVLE user management server"
524
 
NAME=usrmgt-server
525
 
DAEMON=/opt/ivle/scripts/$NAME
526
 
DAEMON_ARGS="''' + str(usrmgt_port) + ''' ''' + usrmgt_magic + '''"
527
 
PIDFILE=/var/run/$NAME.pid
528
 
SCRIPTNAME=/etc/init.d/usrmgt-server
529
 
 
530
 
# Exit if the daemon does not exist 
531
 
test -f $DAEMON || exit 0
532
 
 
533
 
# Load the VERBOSE setting and other rcS variables
534
 
[ -f /etc/default/rcS ] && . /etc/default/rcS
535
 
 
536
 
# Define LSB log_* functions.
537
 
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
538
 
. /lib/lsb/init-functions
539
 
 
540
 
#
541
 
# Function that starts the daemon/service
542
 
#
543
 
do_start()
544
 
{
545
 
        # Return
546
 
        #   0 if daemon has been started
547
 
        #   1 if daemon was already running
548
 
        #   2 if daemon could not be started
549
 
        start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
550
 
                || return 1
551
 
        start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON -- \
552
 
                $DAEMON_ARGS \
553
 
                || return 2
554
 
        # Add code here, if necessary, that waits for the process to be ready
555
 
        # to handle requests from services started subsequently which depend
556
 
        # on this one.  As a last resort, sleep for some time.
557
 
}
558
 
 
559
 
#
560
 
# Function that stops the daemon/service
561
 
#
562
 
do_stop()
563
 
{
564
 
        # Return
565
 
        #   0 if daemon has been stopped
566
 
        #   1 if daemon was already stopped
567
 
        #   2 if daemon could not be stopped
568
 
        #   other if a failure occurred
569
 
        start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
570
 
        RETVAL="$?"
571
 
        [ "$RETVAL" = 2 ] && return 2
572
 
        # Wait for children to finish too if this is a daemon that forks
573
 
        # and if the daemon is only ever run from this initscript.
574
 
        # If the above conditions are not satisfied then add some other code
575
 
        # that waits for the process to drop all resources that could be
576
 
        # needed by services started subsequently.  A last resort is to
577
 
        # sleep for some time.
578
 
        start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
579
 
        [ "$?" = 2 ] && return 2
580
 
        # Many daemons don't delete their pidfiles when they exit.
581
 
        rm -f $PIDFILE
582
 
        return "$RETVAL"
583
 
}
584
 
 
585
 
#
586
 
# Function that sends a SIGHUP to the daemon/service
587
 
#
588
 
do_reload() {
589
 
        #
590
 
        # If the daemon can reload its configuration without
591
 
        # restarting (for example, when it is sent a SIGHUP),
592
 
        # then implement that here.
593
 
        #
594
 
        start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
595
 
        return 0
596
 
}
597
 
 
598
 
case "$1" in
599
 
  start)
600
 
    [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
601
 
        do_start
602
 
        case "$?" in
603
 
                0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
604
 
                2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
605
 
        esac
606
 
        ;;
607
 
  stop)
608
 
        [ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
609
 
        do_stop
610
 
        case "$?" in
611
 
                0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
612
 
                2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
613
 
        esac
614
 
        ;;
615
 
  #reload|force-reload)
616
 
        #
617
 
        # If do_reload() is not implemented then leave this commented out
618
 
        # and leave 'force-reload' as an alias for 'restart'.
619
 
        #
620
 
        #log_daemon_msg "Reloading $DESC" "$NAME"
621
 
        #do_reload
622
 
        #log_end_msg $?
623
 
        #;;
624
 
  restart|force-reload)
625
 
        #
626
 
        # If the "reload" option is implemented then remove the
627
 
        # 'force-reload' alias
628
 
        #
629
 
        log_daemon_msg "Restarting $DESC" "$NAME"
630
 
        do_stop
631
 
        case "$?" in
632
 
          0|1)
633
 
                do_start
634
 
                case "$?" in
635
 
                        0) log_end_msg 0 ;;
636
 
                        1) log_end_msg 1 ;; # Old process is still running
637
 
                        *) log_end_msg 1 ;; # Failed to start
638
 
                esac
639
 
                ;;
640
 
          *)
641
 
                # Failed to stop
642
 
                log_end_msg 1
643
 
                ;;
644
 
        esac
645
 
        ;;
646
 
  *)
647
 
        #echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
648
 
        echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
649
 
        exit 3
650
 
        ;;
651
 
esac
652
 
 
653
 
:
654
 
''')
655
 
        
656
 
        conf.close()
657
 
    except IOError, (errno, strerror):
658
 
        print "IO error(%s): %s" % (errno, strerror)
659
 
        sys.exit(1)
660
 
 
661
 
    # fix permissions as the file contains the database password
662
 
    try:
663
 
        os.chmod('doc/setup/usrmgt-server.init', 0600)
664
 
    except OSError, (errno, strerror):
665
 
        print "WARNING: Couldn't chmod doc/setup/usrmgt-server.init:"
666
 
        print "OS error(%s): %s" % (errno, strerror)
667
 
 
668
 
    print "Successfully wrote lib/conf/usrmgt-server.init"
669
 
 
670
 
    print
671
 
    print "You may modify the configuration at any time by editing"
672
 
    print conffile
673
 
    print jailconffile
674
 
    print conf_hfile
675
 
    print phpBBconffile
676
 
    print usrmgtserver_initdfile
677
 
    print
 
380
    plugindefault.close()
 
381
    print "Successfully wrote %s" % plugindefaultfile
 
382
 
 
383
    print
 
384
    print "You may modify the configuration at any time by editing " + conffile
678
385
    
679
386
    return 0
 
387
 
 
388
def main(argv=None):
 
389
    if argv is None:
 
390
        argv = sys.argv
 
391
 
 
392
    # Print the opening spiel including the GPL notice
 
393
 
 
394
    print """IVLE - Informatics Virtual Learning Environment Setup
 
395
Copyright (C) 2007-2009 The University of Melbourne
 
396
IVLE comes with ABSOLUTELY NO WARRANTY.
 
397
This is free software, and you are welcome to redistribute it
 
398
under certain conditions. See LICENSE.txt for details.
 
399
 
 
400
IVLE Configuration
 
401
"""
 
402
 
 
403
    return configure(argv[1:])
 
404
 
 
405
if __name__ == "__main__":
 
406
    sys.exit(main())