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.
48
53
self.option_name = option_name
49
54
self.default = default
50
55
self.prompt = prompt
51
56
self.comment = comment
53
59
# Configuration options, defaults and descriptions
54
60
config_options = []
55
config_options.append(ConfigOption("root_dir", "/",
62
config_options.append(ConfigOption("urls/root", "/",
56
63
"""Root directory where IVLE is located (in URL space):""",
58
65
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
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 '
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):""",
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.""",
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):""",
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
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):""",
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
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
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
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("log_path",
123
"/home/informatics/logs/",
67
# eg. "/" or "/ivle".""", ask=False))
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):""",
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)""",
78
config_options.append(ConfigOption("paths/data",
80
"In the local file system, where user-modifiable data files should be "
83
# In the local file system, where user-modifiable data files should be
84
# located.""", ask=False))
86
config_options.append(ConfigOption("paths/logs",
124
88
"""Directory where IVLE log files are stored (on the local
125
file system). Note - this must be writable by the user the IVLE server
126
process runs as (usually www-data).:""",
89
file system). Note - this must be writable by the user the IVLE server
90
process runs as (usually www-data):""",
128
# In the local file system, where is the Terms of Service document located."""))
129
config_options.append(ConfigOption("public_host", "public.localhost",
92
# In the local file system, where IVLE error logs should be located.""",
95
config_options.append(ConfigOption("urls/public_host", "public.localhost",
130
96
"""Hostname which will cause the server to go into "public mode",
131
97
providing login-free access to student's published work:""",
136
102
# Public mode does not use cookies, and serves only public content.
137
103
# Private mode (normal mode) requires login, and only serves files relevant to
138
104
# the logged-in user."""))
139
config_options.append(ConfigOption("allowed_uids", "33",
140
"""UID of the web server process which will run IVLE.
141
Only this user may execute the trampoline. May specify multiple users as
142
a comma-separated list.
106
config_options.append(ConfigOption("media/version", None,
107
"""Version of IVLE media resources (must change on each upgrade):""",
145
# The User-ID of the web server process which will run IVLE, and any other
146
# users who are allowed to run the trampoline. This is stores as a string of
147
# comma-separated integers, simply because it is not used within Python, only
148
# used by the setup program to write to conf.h (see setup.py config)."""))
149
config_options.append(ConfigOption("db_host", "localhost",
109
# Version string for IVLE media resource URLs. When set, they are aggressively
110
# cached by the browser, so it must be either left unset or changed each time
111
# a media file is changed.""", ask=False))
113
config_options.append(ConfigOption("database/host", "localhost",
150
114
"""PostgreSQL Database config
151
115
==========================
152
116
Hostname of the DB server:""",
154
### PostgreSQL Database config ###
155
118
# Database server hostname"""))
156
config_options.append(ConfigOption("db_port", "5432",
120
config_options.append(ConfigOption("database/port", "5432",
157
121
"""Port of the DB server:""",
159
123
# Database server port"""))
160
config_options.append(ConfigOption("db_dbname", "ivle",
125
config_options.append(ConfigOption("database/name", "ivle",
161
126
"""Database name:""",
163
128
# Database name"""))
164
config_options.append(ConfigOption("db_forumdbname", "ivle_forum",
165
"""Forum Database name:""",
167
# Forum Database name"""))
168
config_options.append(ConfigOption("db_user", "postgres",
130
config_options.append(ConfigOption("database/username", "postgres",
169
131
"""Username for DB server login:""",
171
133
# Database username"""))
172
config_options.append(ConfigOption("db_password", "",
135
config_options.append(ConfigOption("database/password", "",
173
136
"""Password for DB server login:
174
(Caution: This password is stored in plaintext in lib/conf/conf.py)""",
137
(Caution: This password is stored in plaintext!)""",
176
139
# Database password"""))
177
config_options.append(ConfigOption("auth_modules", "ldap_auth",
141
config_options.append(ConfigOption("auth/modules", "",
178
142
"""Authentication config
179
143
=====================
180
Comma-separated list of authentication modules. Only "ldap" is available
144
Comma-separated list of authentication modules.""",
183
146
# Comma-separated list of authentication modules.
147
# Note that auth is always enabled against the local database, and NO OTHER
148
# auth is enabled by default. This section is for specifying additional auth
184
150
# These refer to importable Python modules in the www/auth directory.
185
# Modules "ldap" and "guest" are available in the source tree, but
151
# Modules "ldap_auth" and "guest" are available in the source tree, but
186
152
# other modules may be plugged in to auth against organisation-specific
187
# auth backends."""))
188
config_options.append(ConfigOption("ldap_url", "ldaps://www.example.com",
153
# auth backends.""", ask=False))
155
config_options.append(ConfigOption("auth/ldap_url", "ldaps://www.example.com",
189
156
"""(LDAP options are only relevant if "ldap" is included in the list of
191
158
URL for LDAP authentication server:""",
193
# URL for LDAP authentication server"""))
194
config_options.append(ConfigOption("ldap_format_string",
160
# URL for LDAP authentication server""", ask=False))
162
config_options.append(ConfigOption("auth/ldap_format_string",
195
163
"uid=%s,ou=users,o=example",
196
164
"""Format string for LDAP auth request:
197
165
(Must contain a single "%s" for the user's login name)""",
199
167
# Format string for LDAP auth request
200
# (Must contain a single "%s" for the user's login name)"""))
201
config_options.append(ConfigOption("subject_pulldown_modules", "",
168
# (Must contain a single "%s" for the user's login name)""", ask=False))
170
config_options.append(ConfigOption("auth/subject_pulldown_modules", "",
202
171
"""Comma-separated list of subject pulldown modules.
203
172
Add proprietary modules to automatically enrol students in subjects.""",
206
175
# These refer to importable Python modules in the lib/pulldown_subj directory.
207
176
# Only "dummy_subj" is available in the source tree (an example), but
208
177
# other modules may be plugged in to pulldown against organisation-specific
209
# pulldown backends."""))
210
config_options.append(ConfigOption("svn_addr", "http://svn.localhost/",
178
# pulldown backends.""", ask=False))
180
config_options.append(ConfigOption("urls/svn_addr", "http://svn.localhost/",
211
181
"""Subversion config
212
182
=================
213
183
The base url for accessing subversion repositories:""",
215
185
# The base url for accessing subversion repositories."""))
216
config_options.append(ConfigOption("svn_conf", "/opt/ivle/svn/svn.conf",
217
"""The location of the subversion configuration file used by apache
218
to host the user repositories:""",
220
# The location of the subversion configuration file used by
221
# apache to host the user repositories."""))
222
config_options.append(ConfigOption("svn_repo_path", "/home/informatics/repositories",
223
"""The root directory for the subversion repositories:""",
225
# The root directory for the subversion repositories."""))
226
config_options.append(ConfigOption("svn_auth_ivle", "/opt/ivle/svn/ivle.auth",
227
"""The location of the password file used to authenticate users
228
of the subversion repository from the ivle server:""",
230
# The location of the password file used to authenticate users
231
# of the subversion repository from the ivle server."""))
232
config_options.append(ConfigOption("svn_auth_local", "/opt/ivle/svn/local.auth",
233
"""The location of the password file used to authenticate local users
234
of the subversion repository:""",
236
# The location of the password file used to authenticate local users
237
# of the subversion repository."""))
238
config_options.append(ConfigOption("usrmgt_host", "localhost",
187
config_options.append(ConfigOption("usrmgt/host", "localhost",
239
188
"""User Management Server config
240
189
============================
241
190
The hostname where the usrmgt-server runs:""",
243
192
# The hostname where the usrmgt-server runs."""))
244
config_options.append(ConfigOption("usrmgt_port", "2178",
194
config_options.append(ConfigOption("usrmgt/port", "2178",
245
195
"""The port where the usrmgt-server runs:""",
247
# The port where the usrmgt-server runs."""))
248
config_options.append(ConfigOption("usrmgt_magic", "",
197
# The port where the usrmgt-server runs.""", ask=False))
199
config_options.append(ConfigOption("usrmgt/magic", None,
249
200
"""The password for the usrmgt-server:""",
251
# The password for the usrmgt-server."""))
202
# The password for the usrmgt-server.""", ask=False))
204
def query_user(default, prompt):
205
"""Prompts the user for a string, which is read from a line of stdin.
206
Exits silently if EOF is encountered. Returns the string, with spaces
207
removed from the beginning and end.
209
Returns default if a 0-length line (after spaces removed) was read.
212
# A default of None means the value will be computed specially, so we
213
# can't really tell you what it is
214
defaultstr = "computed"
215
elif isinstance(default, basestring):
216
defaultstr = '"%s"' % default
218
defaultstr = repr(default)
219
sys.stdout.write('%s\n (default: %s)\n>' % (prompt, defaultstr))
221
val = sys.stdin.readline()
222
except KeyboardInterrupt:
224
sys.stdout.write("\n")
226
sys.stdout.write("\n")
228
if val == '': sys.exit(1)
229
# If empty line, return default
231
if val == '': return default
253
234
def configure(args):
254
usage = """usage: %prog build [options]
256
Compiles all files and sets up a jail template in the source directory.
257
-O is recommended to cause compilation to be optimised.
259
Compiles (GCC) trampoline/trampoline.c to trampoline/trampoline.
260
Creates jail with system and student packages installed from MIRROR.
261
Copies console/ to a location within the jail.
262
Copies OS programs and files to corresponding locations within the jail
263
(eg. python and Python libs, ld.so, etc).
264
Generates .pyc or .pyo files for all the IVLE .py files."""
267
parser = optparse.OptionParser(usage)
268
(options, args) = parser.parse_args(args)
270
# Call the real function
273
def __configure(args):
274
global db_port, usrmgt_port
276
235
# Try importing existing conf, but if we can't just set up defaults
277
236
# The reason for this is that these settings are used by other phases
278
237
# of setup besides conf, so we need to know them.
279
238
# Also this allows you to hit Return to accept the existing value.
281
confmodule = __import__("lib/conf/conf")
282
for opt in config_options:
284
globals()[opt.option_name] = \
285
confmodule.__dict__[opt.option_name]
287
globals()[opt.option_name] = opt.default
289
# Just set reasonable defaults
290
for opt in config_options:
291
globals()[opt.option_name] = opt.default
240
conf = ivle.config.Config()
241
except ivle.config.ConfigError:
242
# Couldn't find a config file anywhere.
243
# Create a new blank config object (not yet bound to a file)
244
# All lookups (below) will fail, so it will be initialised with all
245
# the default values.
246
conf = ivle.config.Config(blank=True)
248
# Check that all the options are present, and if not, load the default
249
for opt in config_options:
251
conf.get_by_path(opt.option_name)
253
# If the default is None, omit it
254
# Else ConfigObj will write the string 'None' to the conf file
255
if opt.default is not None:
256
conf.set_by_path(opt.option_name, opt.default)
258
# Store comments in the conf object
259
for opt in config_options:
260
# Omitted if the key doesn't exist
261
conf.set_by_path(opt.option_name, comment=opt.comment)
293
263
# Set up some variables
294
264
cwd = os.getcwd()
296
266
# the files that will be created/overwritten
297
conffile = os.path.join(cwd, "lib/conf/conf.py")
298
jailconffile = os.path.join(cwd, "lib/conf/jailconf.py")
299
conf_hfile = os.path.join(cwd, "trampoline/conf.h")
300
phpBBconffile = os.path.join(cwd, "www/php/phpBB3/config.php")
301
usrmgtserver_initdfile = os.path.join(cwd, "doc/setup/usrmgt-server.init")
268
confdir = os.environ['IVLECONF']
270
confdir = '/etc/ivle'
272
conffile = os.path.join(confdir, 'ivle.conf')
273
plugindefaultfile = os.path.join(confdir, 'plugins.d/000default.conf')
303
275
# Get command-line arguments to avoid asking questions.
315
287
# Interactive mode. Prompt the user for all the values.
317
print """This tool will create the following files:
323
prompting you for details about your configuration. The file will be
324
overwritten if it already exists. It will *not* install or deploy IVLE.
289
print """This tool will create %s, prompting you for details about
290
your configuration. The file will be updated with modified options if it already
291
exists. If it does not already exist, it will be created with sane defaults and
292
restrictive permissions.
294
%s will also be overwritten with the default list of plugins.
326
296
Please hit Ctrl+C now if you do not wish to do this.
327
""" % (conffile, jailconffile, conf_hfile, phpBBconffile, usrmgtserver_initdfile)
297
""" % (conffile, plugindefaultfile)
329
299
# Get information from the administrator
330
300
# If EOF is encountered at any time during the questioning, just exit
333
303
for opt in config_options:
334
globals()[opt.option_name] = \
335
query_user(globals()[opt.option_name], opt.prompt)
305
conf.set_by_path(opt.option_name,
306
query_user(conf.get_by_path(opt.option_name), opt.prompt))
337
308
opts = dict(opts)
338
309
# Non-interactive mode. Parse the options.
339
310
for opt in config_options:
340
311
if '--' + opt.option_name in opts:
341
globals()[opt.option_name] = opts['--' + opt.option_name]
312
conf.set_by_path(opt.option_name,
313
opts['--' + opt.option_name])
343
315
# Error handling on input values
345
allowed_uids_list = map(int, allowed_uids.split(','))
347
print >>sys.stderr, (
348
"Invalid UID list (%s).\n"
349
"Must be a comma-separated list of integers." % allowed_uids)
352
db_port = int(db_port)
353
if db_port < 0 or db_port >= 65536: raise ValueError()
355
print >>sys.stderr, (
356
"Invalid DB port (%s).\n"
357
"Must be an integer between 0 and 65535." % repr(db_port))
360
usrmgt_port = int(usrmgt_port)
361
if usrmgt_port < 0 or usrmgt_port >= 65536: raise ValueError()
317
conf['database']['port'] = int(conf['database']['port'])
318
if (conf['database']['port'] < 0
319
or conf['database']['port'] >= 65536):
322
if conf['database']['port'] == '' or conf['database']['port'] is None:
325
print >>sys.stderr, (
326
"Invalid DB port (%s).\n"
327
"Must be an integer between 0 and 65535." %
328
repr(conf['database']['port']))
331
conf['usrmgt']['port'] = int(conf['usrmgt']['port'])
332
if (conf['usrmgt']['port'] < 0 or conf['usrmgt']['port'] >= 65536):
362
334
except ValueError:
363
335
print >>sys.stderr, (
364
336
"Invalid user management port (%s).\n"
365
"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']))
368
# Generate the forum secret
369
forum_secret = hashlib.md5(uuid.uuid4().bytes).hexdigest()
371
# Write lib/conf/conf.py
341
# By default we generate the magic randomly.
374
conf = open(conffile, "w")
376
conf.write("""# IVLE Configuration File
378
# Miscellaneous application settings
343
conf['usrmgt']['magic'] # Throw away; just check for KeyError
345
conf['usrmgt']['magic'] = hashlib.md5(uuid.uuid4().bytes).hexdigest()
347
clobber_permissions = not os.path.exists(conffile)
349
# Write ./etc/ivle.conf (even if we loaded from a different filename)
350
conf.filename = conffile
351
conf.initial_comment = ["# IVLE Configuration File"]
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!
360
print "Successfully wrote %s" % conffile
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]
379
[ivle.webapp.fileservice#Plugin]
380
[ivle.webapp.submit#Plugin]
381
for opt in config_options:
382
conf.write('%s\n%s = %s\n' % (opt.comment, opt.option_name,
383
repr(globals()[opt.option_name])))
385
# Add the forum secret to the config file (regenerated each config)
386
conf.write('forum_secret = "%s"\n' % (forum_secret))
389
except IOError, (errno, strerror):
390
print "IO error(%s): %s" % (errno, strerror)
393
print "Successfully wrote lib/conf/conf.py"
395
# Write conf/jailconf.py
398
conf = open(jailconffile, "w")
400
# In the "in-jail" version of conf, we don't need MOST of the details
401
# (it would be a security risk to have them here).
402
# So we just write root_dir, and jail_base is "/".
403
# (jail_base being "/" means "jail-relative" paths are relative to "/"
404
# when inside the jail.)
405
conf.write("""# IVLE Configuration File
407
# Miscellaneous application settings
408
# (User jail version)
411
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
413
# eg. "/" or "/ivle".
416
# In the local file system, where are the student/user file spaces located.
417
# The user jails are expected to be located immediately in subdirectories of
421
# The hostname for serving publicly accessible pages
423
""" % (repr(root_dir),repr(public_host)))
426
except IOError, (errno, strerror):
427
print "IO error(%s): %s" % (errno, strerror)
430
print "Successfully wrote lib/conf/jailconf.py"
432
# Write trampoline/conf.h
435
conf = open(conf_hfile, "w")
437
conf.write("""/* IVLE Configuration File
439
* Administrator settings required by trampoline.
440
* Note: trampoline will have to be rebuilt in order for changes to this file
444
#define IVLE_AUFS_JAILS
446
/* In the local file system, where are the jails located.
447
* The trampoline does not allow the creation of a jail anywhere besides
448
* jail_base or a subdirectory of jail_base.
450
static const char* jail_base = "%s";
451
static const char* jail_src_base = "%s";
452
static const char* jail_system = "%s";
454
/* Which user IDs are allowed to run the trampoline.
455
* This list should be limited to the web server user.
456
* (Note that root is an implicit member of this list).
458
static const int allowed_uids[] = { %s };
459
""" % (repr(jail_base)[1:-1], repr(jail_src_base)[1:-1],
460
repr(jail_system)[1:-1], repr(allowed_uids_list)[1:-1]))
461
# Note: The above uses PYTHON reprs, not C reprs
462
# However they should be the same with the exception of the outer
463
# characters, which are stripped off and replaced
466
except IOError, (errno, strerror):
467
print "IO error(%s): %s" % (errno, strerror)
470
print "Successfully wrote trampoline/conf.h"
472
# Write www/php/phpBB3/config.php
475
conf = open(phpBBconffile, "w")
478
if db_host == 'localhost':
479
forumdb_host = '127.0.0.1'
481
forumdb_host = db_host
484
// phpBB 3.0.x auto-generated configuration file
485
// Do not change anything in this file!
487
$dbhost = '""" + forumdb_host + """';
488
$dbport = '""" + str(db_port) + """';
489
$dbname = '""" + db_forumdbname + """';
490
$dbuser = '""" + db_user + """';
491
$dbpasswd = '""" + db_password + """';
493
$table_prefix = 'phpbb_';
495
$load_extensions = '';
496
@define('PHPBB_INSTALLED', true);
497
// @define('DEBUG', true);
498
//@define('DEBUG_EXTRA', true);
500
$forum_secret = '""" + forum_secret +"""';
504
except IOError, (errno, strerror):
505
print "IO error(%s): %s" % (errno, strerror)
508
print "Successfully wrote www/php/phpBB3/config.php"
510
# Write lib/conf/usrmgt-server.init
513
conf = open(usrmgtserver_initdfile, "w")
515
conf.write( '''#! /bin/sh
517
# Works for Ubuntu. Check before using on other distributions
520
# Provides: usrmgt-server
521
# Required-Start: $syslog $networking $urandom
522
# Required-Stop: $syslog
523
# Default-Start: 2 3 4 5
525
# Short-Description: IVLE user management server
526
# Description: Daemon connecting to the IVLE user management database.
529
PATH=/sbin:/bin:/usr/sbin:/usr/bin
530
DESC="IVLE user management server"
532
DAEMON=/opt/ivle/scripts/$NAME
533
DAEMON_ARGS="''' + str(usrmgt_port) + ''' ''' + usrmgt_magic + '''"
534
PIDFILE=/var/run/$NAME.pid
535
SCRIPTNAME=/etc/init.d/usrmgt-server
537
# Exit if the daemon does not exist
538
test -f $DAEMON || exit 0
540
# Load the VERBOSE setting and other rcS variables
541
[ -f /etc/default/rcS ] && . /etc/default/rcS
543
# Define LSB log_* functions.
544
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
545
. /lib/lsb/init-functions
548
# Function that starts the daemon/service
553
# 0 if daemon has been started
554
# 1 if daemon was already running
555
# 2 if daemon could not be started
556
start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
558
start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON -- \
561
# Add code here, if necessary, that waits for the process to be ready
562
# to handle requests from services started subsequently which depend
563
# on this one. As a last resort, sleep for some time.
567
# Function that stops the daemon/service
572
# 0 if daemon has been stopped
573
# 1 if daemon was already stopped
574
# 2 if daemon could not be stopped
575
# other if a failure occurred
576
start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
578
[ "$RETVAL" = 2 ] && return 2
579
# Wait for children to finish too if this is a daemon that forks
580
# and if the daemon is only ever run from this initscript.
581
# If the above conditions are not satisfied then add some other code
582
# that waits for the process to drop all resources that could be
583
# needed by services started subsequently. A last resort is to
584
# sleep for some time.
585
start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
586
[ "$?" = 2 ] && return 2
587
# Many daemons don't delete their pidfiles when they exit.
593
# Function that sends a SIGHUP to the daemon/service
597
# If the daemon can reload its configuration without
598
# restarting (for example, when it is sent a SIGHUP),
599
# then implement that here.
601
start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
607
[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
610
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
611
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
615
[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
618
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
619
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
622
#reload|force-reload)
624
# If do_reload() is not implemented then leave this commented out
625
# and leave 'force-reload' as an alias for 'restart'.
627
#log_daemon_msg "Reloading $DESC" "$NAME"
631
restart|force-reload)
633
# If the "reload" option is implemented then remove the
634
# 'force-reload' alias
636
log_daemon_msg "Restarting $DESC" "$NAME"
643
1) log_end_msg 1 ;; # Old process is still running
644
*) log_end_msg 1 ;; # Failed to start
654
#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
655
echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
664
except IOError, (errno, strerror):
665
print "IO error(%s): %s" % (errno, strerror)
668
# fix permissions as the file contains the database password
670
os.chmod('doc/setup/usrmgt-server.init', 0600)
671
except OSError, (errno, strerror):
672
print "WARNING: Couldn't chmod doc/setup/usrmgt-server.init:"
673
print "OS error(%s): %s" % (errno, strerror)
675
print "Successfully wrote lib/conf/usrmgt-server.init"
678
print "You may modify the configuration at any time by editing"
683
print usrmgtserver_initdfile
382
plugindefault.close()
383
print "Successfully wrote %s" % plugindefaultfile
386
print "You may modify the configuration at any time by editing " + conffile
394
# Print the opening spiel including the GPL notice
396
print """IVLE - Informatics Virtual Learning Environment Setup
397
Copyright (C) 2007-2009 The University of Melbourne
398
IVLE comes with ABSOLUTELY NO WARRANTY.
399
This is free software, and you are welcome to redistribute it
400
under certain conditions. See LICENSE.txt for details.
405
return configure(argv[1:])
407
if __name__ == "__main__":
added
removed
bin/ivle-config
