46
45
comment: (Long) comment string stored in conf.py. Each line of this
47
46
string should begin with a '#'.
48
ask: Whether to ask the question in the default config run.
50
48
self.option_name = option_name
51
49
self.default = default
52
50
self.prompt = prompt
53
51
self.comment = comment
56
53
# Configuration options, defaults and descriptions
57
54
config_options = []
59
55
config_options.append(ConfigOption("root_dir", "/",
60
56
"""Root directory where IVLE is located (in URL space):""",
62
58
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
64
# eg. "/" or "/ivle".""", ask=False))
66
config_options.append(ConfigOption("prefix", "/usr/local",
67
"""In the local file system, the prefix to the system directory where IVLE
68
is installed. (This should either be /usr or /usr/local):""",
70
# In the local file system, the prefix to the system directory where IVLE is
71
# installed. This should either be '/usr' or '/usr/local'.
72
# ('/usr/local' for the usual install, '/usr' for distribution packages)""",
75
config_options.append(ConfigOption("python_site_packages_override",
77
"""site-packages directory in Python, where Python libraries are to be
78
installed. May be left as the default, in which case the value will be
79
computed from prefix and the current Python version:""",
81
# 'site-packages' directory in Python, where Python libraries are to be
82
# installed. May be None (recommended), in which case the value will be
83
# computed from prefix and the current Python version.""", ask=False))
85
config_options.append(ConfigOption("data_path",
87
"In the local file system, where user-modifiable data files should be "
90
# In the local file system, where user-modifiable data files should be
91
# located.""", ask=False))
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."""))
93
122
config_options.append(ConfigOption("log_path",
123
"/home/informatics/logs",
95
124
"""Directory where IVLE log files are stored (on the local
96
file system). Note - this must be writable by the user the IVLE server
97
process runs as (usually www-data):""",
125
file system). Note - this must be writable by the user the IVLE server
126
process runs as (usually www-data).:""",
99
# In the local file system, where IVLE error logs should be located.""",
128
# In the local file system, where IVLE error logs should be located."""))
102
129
config_options.append(ConfigOption("public_host", "public.localhost",
103
130
"""Hostname which will cause the server to go into "public mode",
104
131
providing login-free access to student's published work:""",
130
154
### PostgreSQL Database config ###
131
155
# Database server hostname"""))
133
156
config_options.append(ConfigOption("db_port", "5432",
134
157
"""Port of the DB server:""",
136
159
# Database server port"""))
138
160
config_options.append(ConfigOption("db_dbname", "ivle",
139
161
"""Database name:""",
141
163
# Database name"""))
143
164
config_options.append(ConfigOption("db_forumdbname", "ivle_forum",
144
165
"""Forum Database name:""",
146
167
# Forum Database name"""))
148
168
config_options.append(ConfigOption("db_user", "postgres",
149
169
"""Username for DB server login:""",
151
171
# Database username"""))
153
172
config_options.append(ConfigOption("db_password", "",
154
173
"""Password for DB server login:
155
(Caution: This password is stored in plaintext in ivle/conf/conf.py)""",
174
(Caution: This password is stored in plaintext in lib/conf/conf.py)""",
157
176
# Database password"""))
159
config_options.append(ConfigOption("auth_modules", "",
177
config_options.append(ConfigOption("auth_modules", "ldap_auth",
160
178
"""Authentication config
161
179
=====================
162
Comma-separated list of authentication modules.""",
180
Comma-separated list of authentication modules. Only "ldap" is available
164
183
# Comma-separated list of authentication modules.
165
# Note that auth is always enabled against the local database, and NO OTHER
166
# auth is enabled by default. This section is for specifying additional auth
168
184
# These refer to importable Python modules in the www/auth directory.
169
# Modules "ldap_auth" and "guest" are available in the source tree, but
185
# Modules "ldap" and "guest" are available in the source tree, but
170
186
# other modules may be plugged in to auth against organisation-specific
171
# auth backends.""", ask=False))
187
# auth backends."""))
173
188
config_options.append(ConfigOption("ldap_url", "ldaps://www.example.com",
174
189
"""(LDAP options are only relevant if "ldap" is included in the list of
176
191
URL for LDAP authentication server:""",
178
# URL for LDAP authentication server""", ask=False))
193
# URL for LDAP authentication server"""))
180
194
config_options.append(ConfigOption("ldap_format_string",
181
195
"uid=%s,ou=users,o=example",
182
196
"""Format string for LDAP auth request:
183
197
(Must contain a single "%s" for the user's login name)""",
185
199
# Format string for LDAP auth request
186
# (Must contain a single "%s" for the user's login name)""", ask=False))
200
# (Must contain a single "%s" for the user's login name)"""))
188
201
config_options.append(ConfigOption("subject_pulldown_modules", "",
189
202
"""Comma-separated list of subject pulldown modules.
190
203
Add proprietary modules to automatically enrol students in subjects.""",
193
206
# These refer to importable Python modules in the lib/pulldown_subj directory.
194
207
# Only "dummy_subj" is available in the source tree (an example), but
195
208
# other modules may be plugged in to pulldown against organisation-specific
196
# pulldown backends.""", ask=False))
209
# pulldown backends."""))
198
210
config_options.append(ConfigOption("svn_addr", "http://svn.localhost/",
199
211
"""Subversion config
200
212
=================
201
213
The base url for accessing subversion repositories:""",
203
215
# 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_group_conf",
223
"/opt/ivle/svn/svn-group.conf",
224
"""The location of the subversion configuration file used by apache
225
to host group repositories:""",
227
# The location of the subversion configuration file used by
228
# apache to host the user repositories."""))
229
config_options.append(ConfigOption("svn_repo_path", "/home/informatics/repositories",
230
"""The root directory for the subversion repositories:""",
232
# The root directory for the subversion repositories."""))
233
config_options.append(ConfigOption("svn_auth_ivle", "/opt/ivle/svn/ivle.auth",
234
"""The location of the password file used to authenticate users
235
of the subversion repository from the ivle server:""",
237
# The location of the password file used to authenticate users
238
# of the subversion repository from the ivle server."""))
239
config_options.append(ConfigOption("svn_auth_local", "/opt/ivle/svn/local.auth",
240
"""The location of the password file used to authenticate local users
241
of the subversion repository:""",
243
# The location of the password file used to authenticate local users
244
# of the subversion repository."""))
205
245
config_options.append(ConfigOption("usrmgt_host", "localhost",
206
246
"""User Management Server config
207
247
============================
208
248
The hostname where the usrmgt-server runs:""",
210
250
# The hostname where the usrmgt-server runs."""))
212
251
config_options.append(ConfigOption("usrmgt_port", "2178",
213
252
"""The port where the usrmgt-server runs:""",
215
# The port where the usrmgt-server runs.""", ask=False))
217
config_options.append(ConfigOption("usrmgt_magic", None,
254
# The port where the usrmgt-server runs."""))
255
config_options.append(ConfigOption("usrmgt_magic", "",
218
256
"""The password for the usrmgt-server:""",
220
# The password for the usrmgt-server.""", ask=False))
258
# The password for the usrmgt-server."""))
222
260
def configure(args):
223
usage = """usage: %prog config [options]
224
Creates lib/conf/conf.py (and a few other config files).
225
Interactively asks questions to set this up."""
261
usage = """usage: %prog build [options]
263
Compiles all files and sets up a jail template in the source directory.
264
-O is recommended to cause compilation to be optimised.
266
Compiles (GCC) trampoline/trampoline.c to trampoline/trampoline.
267
Creates jail with system and student packages installed from MIRROR.
268
Copies console/ to a location within the jail.
269
Copies OS programs and files to corresponding locations within the jail
270
(eg. python and Python libs, ld.so, etc).
271
Generates .pyc or .pyo files for all the IVLE .py files."""
227
273
# Parse arguments
228
274
parser = optparse.OptionParser(usage)
229
275
(options, args) = parser.parse_args(args)
231
277
# Call the real function
232
return __configure(args)
234
280
def __configure(args):
235
281
global db_port, usrmgt_port
483
515
print "IO error(%s): %s" % (errno, strerror)
486
print "Successfully wrote %s" % phpBBconffile
518
print "Successfully wrote www/php/phpBB3/config.php"
520
# Write lib/conf/usrmgt-server.init
523
conf = open(usrmgtserver_initdfile, "w")
525
conf.write( '''#! /bin/sh
527
# Works for Ubuntu. Check before using on other distributions
530
# Provides: usrmgt-server
531
# Required-Start: $syslog $networking $urandom
532
# Required-Stop: $syslog
533
# Default-Start: 2 3 4 5
535
# Short-Description: IVLE user management server
536
# Description: Daemon connecting to the IVLE user management database.
539
PATH=/sbin:/bin:/usr/sbin:/usr/bin
540
DESC="IVLE user management server"
542
DAEMON=/opt/ivle/services/$NAME
543
PIDFILE=/var/run/$NAME.pid
544
SCRIPTNAME=/etc/init.d/usrmgt-server
546
# Exit if the daemon does not exist
547
test -f $DAEMON || exit 0
549
# Load the VERBOSE setting and other rcS variables
550
[ -f /etc/default/rcS ] && . /etc/default/rcS
552
# Define LSB log_* functions.
553
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
554
. /lib/lsb/init-functions
557
# Function that starts the daemon/service
562
# 0 if daemon has been started
563
# 1 if daemon was already running
564
# 2 if daemon could not be started
565
start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
567
start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON \
569
# Add code here, if necessary, that waits for the process to be ready
570
# to handle requests from services started subsequently which depend
571
# on this one. As a last resort, sleep for some time.
575
# Function that stops the daemon/service
580
# 0 if daemon has been stopped
581
# 1 if daemon was already stopped
582
# 2 if daemon could not be stopped
583
# other if a failure occurred
584
start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
586
[ "$RETVAL" = 2 ] && return 2
587
# Wait for children to finish too if this is a daemon that forks
588
# and if the daemon is only ever run from this initscript.
589
# If the above conditions are not satisfied then add some other code
590
# that waits for the process to drop all resources that could be
591
# needed by services started subsequently. A last resort is to
592
# sleep for some time.
593
start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
594
[ "$?" = 2 ] && return 2
595
# Many daemons don't delete their pidfiles when they exit.
601
# Function that sends a SIGHUP to the daemon/service
605
# If the daemon can reload its configuration without
606
# restarting (for example, when it is sent a SIGHUP),
607
# then implement that here.
609
start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
615
[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
618
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
619
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
623
[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
626
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
627
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
630
#reload|force-reload)
632
# If do_reload() is not implemented then leave this commented out
633
# and leave 'force-reload' as an alias for 'restart'.
635
#log_daemon_msg "Reloading $DESC" "$NAME"
639
restart|force-reload)
641
# If the "reload" option is implemented then remove the
642
# 'force-reload' alias
644
log_daemon_msg "Restarting $DESC" "$NAME"
651
1) log_end_msg 1 ;; # Old process is still running
652
*) log_end_msg 1 ;; # Failed to start
662
#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
663
echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
672
except IOError, (errno, strerror):
673
print "IO error(%s): %s" % (errno, strerror)
676
# fix permissions as the file contains the database password
678
os.chmod('doc/setup/usrmgt-server.init', 0600)
679
except OSError, (errno, strerror):
680
print "WARNING: Couldn't chmod doc/setup/usrmgt-server.init:"
681
print "OS error(%s): %s" % (errno, strerror)
683
print "Successfully wrote lib/conf/usrmgt-server.init"
489
686
print "You may modify the configuration at any time by editing"
491
688
print jailconffile
493
690
print phpBBconffile
691
print usrmgtserver_initdfile
498
def write_conf_file_boilerplate(conf_file):
500
### Below is boilerplate code, appended by ./setup.py config ###
502
# Path where architecture-dependent data (including non-user-executable
503
# binaries) is installed.
504
lib_path = os.path.join(prefix, 'lib/ivle')
506
# Path where arch-independent data is installed.
507
share_path = os.path.join(prefix, 'share/ivle')
509
# Path where user-executable binaries are installed.
510
bin_path = os.path.join(prefix, 'bin')
512
# 'site-packages' directory in Python, where Python libraries are to be
514
if python_site_packages_override is None:
515
PYTHON_VERSION = sys.version[0:3] # eg. "2.5"
516
python_site_packages = os.path.join(prefix,
517
'lib/python%s/site-packages' % PYTHON_VERSION)
519
python_site_packages = python_site_packages_override
521
# In the local file system, where the student/user jails will be mounted.
522
# Only a single copy of the jail's system components will be stored here -
523
# all user jails will be virtually mounted here.
524
jail_base = os.path.join(data_path, 'jailmounts')
526
# In the local file system, where are the student/user file spaces located.
527
# The user jails are expected to be located immediately in subdirectories of
528
# this location. Note that no complete jails reside here - only user
530
jail_src_base = os.path.join(data_path, 'jails')
532
# In the local file system, where the template system jail will be stored.
533
jail_system = os.path.join(jail_src_base, '__base__')
535
# In the local file system, where the subject content files are located.
536
# (The 'subjects' and 'exercises' directories).
537
content_path = os.path.join(data_path, 'content')
539
# In the local file system, where are the per-subject file spaces located.
540
# The individual subject directories are expected to be located immediately
541
# in subdirectories of this location.
542
subjects_base = os.path.join(content_path, 'subjects')
544
# In the local file system, where are the subject-independent exercise sheet
545
# file spaces located.
546
exercises_base = os.path.join(content_path, 'exercises')
548
# In the local file system, where the system notices are stored (such as terms
549
# of service and MOTD).
550
notices_path = os.path.join(data_path, 'notices')
552
# In the local file system, where is the Terms of Service document located.
553
tos_path = os.path.join(notices_path, 'tos.html')
555
# In the local file system, where is the Message of the Day document
556
# located. This is an HTML file (just the body fragment), which will
557
# be displayed on the login page. It is optional.
558
motd_path = os.path.join(notices_path, 'motd.html')
560
# The location of all the subversion config and repositories.
561
svn_path = os.path.join(data_path, 'svn')
563
# The location of the subversion configuration file used by
564
# apache to host the user repositories.
565
svn_conf = os.path.join(svn_path, 'svn.conf')
567
# The location of the subversion configuration file used by
568
# apache to host the user repositories.
569
svn_group_conf = os.path.join(svn_path, 'svn-group.conf')
571
# The root directory for the subversion repositories.
572
svn_repo_path = os.path.join(svn_path, 'repositories')
574
# The location of the password file used to authenticate users
575
# of the subversion repository from the ivle server.
576
svn_auth_ivle = os.path.join(svn_path, 'ivle.auth')