101
101
# Needed by python
102
102
'/usr/bin/python%s' % PYTHON_VERSION,
103
# Needed by fileservice
104
'/lib/libcom_err.so.2',
105
'/lib/libcrypt.so.1',
106
'/lib/libkeyutils.so.1',
107
'/lib/libresolv.so.2',
110
'/usr/lib/libapr-1.so.0',
111
'/usr/lib/libaprutil-1.so.0',
112
'/usr/lib/libdb-4.4.so',
113
'/usr/lib/libexpat.so.1',
114
'/usr/lib/libgcrypt.so.11',
115
'/usr/lib/libgnutls.so.13',
116
'/usr/lib/libgpg-error.so.0',
117
'/usr/lib/libgssapi_krb5.so.2',
118
'/usr/lib/libk5crypto.so.3',
119
'/usr/lib/libkrb5.so.3',
120
'/usr/lib/libkrb5support.so.0',
121
'/usr/lib/liblber.so.2',
122
'/usr/lib/libldap_r.so.2',
123
'/usr/lib/libneon.so.26',
124
'/usr/lib/libpq.so.5',
125
'/usr/lib/libsasl2.so.2',
126
'/usr/lib/libsqlite3.so.0',
127
'/usr/lib/libsvn_client-1.so.1',
128
'/usr/lib/libsvn_delta-1.so.1',
129
'/usr/lib/libsvn_diff-1.so.1',
130
'/usr/lib/libsvn_fs-1.so.1',
131
'/usr/lib/libsvn_fs_base-1.so.1',
132
'/usr/lib/libsvn_fs_fs-1.so.1',
133
'/usr/lib/libsvn_ra-1.so.1',
134
'/usr/lib/libsvn_ra_dav-1.so.1',
135
'/usr/lib/libsvn_ra_local-1.so.1',
136
'/usr/lib/libsvn_ra_svn-1.so.1',
137
'/usr/lib/libsvn_repos-1.so.1',
138
'/usr/lib/libsvn_subr-1.so.1',
139
'/usr/lib/libsvn_wc-1.so.1',
140
'/usr/lib/libtasn1.so.3',
141
'/usr/lib/libxml2.so.2',
142
103
# Needed by matplotlib
143
104
'/usr/lib/i686/cmov/libssl.so.0.9.8',
144
105
'/usr/lib/i686/cmov/libcrypto.so.0.9.8',
172
133
'/etc/ld.so.conf.d': 'jail/etc/ld.so.conf.d',
176
"""A configuration option; one of the things written to conf.py."""
177
def __init__(self, option_name, default, prompt, comment):
178
"""Creates a configuration option.
179
option_name: Name of the variable in conf.py. Also name of the
180
command-line argument to setup.py conf.
181
default: Default value for this variable.
182
prompt: (Short) string presented during the interactive prompt in
184
comment: (Long) comment string stored in conf.py. Each line of this
185
string should begin with a '#'.
187
self.option_name = option_name
188
self.default = default
190
self.comment = comment
192
# Configuration options, defaults and descriptions
194
config_options.append(ConfigOption("root_dir", "/",
195
"""Root directory where IVLE is located (in URL space):""",
197
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
199
# eg. "/" or "/ivle"."""))
200
config_options.append(ConfigOption("ivle_install_dir", "/opt/ivle",
201
'Root directory where IVLE will be installed (on the local file '
204
# In the local file system, where IVLE is actually installed.
205
# This directory should contain the "www" and "bin" directories."""))
206
config_options.append(ConfigOption("jail_base", "/home/informatics/jails",
207
"""Root directory where the jails (containing user files) are stored
208
(on the local file system):""",
210
# In the local file system, where are the student/user file spaces located.
211
# The user jails are expected to be located immediately in subdirectories of
212
# this location."""))
213
config_options.append(ConfigOption("subjects_base",
214
"/home/informatics/subjects",
215
"""Root directory where the subject directories (containing worksheets
216
and other per-subject files) are stored (on the local file system):""",
218
# In the local file system, where are the per-subject file spaces located.
219
# The individual subject directories are expected to be located immediately
220
# in subdirectories of this location."""))
221
config_options.append(ConfigOption("problems_base",
222
"/home/informatics/problems",
223
"""Root directory where the problem directories (containing
224
subject-independent problem sheets) are stored (on the local file
227
# In the local file system, where are the subject-independent problem sheet
228
# file spaces located."""))
229
config_options.append(ConfigOption("public_host", "public.localhost",
230
"""Hostname which will cause the server to go into "public mode",
231
providing login-free access to student's published work:""",
233
# The server goes into "public mode" if the browser sends a request with this
234
# host. This is for security reasons - we only serve public student files on a
235
# separate domain to the main IVLE site.
236
# Public mode does not use cookies, and serves only public content.
237
# Private mode (normal mode) requires login, and only serves files relevant to
238
# the logged-in user."""))
239
config_options.append(ConfigOption("allowed_uids", "33",
240
"""UID of the web server process which will run IVLE.
241
Only this user may execute the trampoline. May specify multiple users as
242
a comma-separated list.
245
# The User-ID of the web server process which will run IVLE, and any other
246
# users who are allowed to run the trampoline. This is stores as a string of
247
# comma-separated integers, simply because it is not used within Python, only
248
# used by the setup program to write to conf.h (see setup.py config)."""))
249
config_options.append(ConfigOption("db_host", "localhost",
250
"""PostgreSQL Database config
251
==========================
252
Hostname of the DB server:""",
254
### PostgreSQL Database config ###
255
# Database server hostname"""))
256
config_options.append(ConfigOption("db_port", "5432",
257
"""Port of the DB server:""",
259
# Database server port"""))
260
config_options.append(ConfigOption("db_dbname", "ivle",
261
"""Database name:""",
264
config_options.append(ConfigOption("db_user", "postgres",
265
"""Username for DB server login:""",
267
# Database username"""))
268
config_options.append(ConfigOption("db_password", "",
269
"""Password for DB server login:
270
(Caution: This password is stored in plaintext in lib/conf/conf.py)""",
272
# Database password"""))
273
config_options.append(ConfigOption("svn_conf", "/opt/ivle/svn/svn.conf",
274
"""The location of the subversion configuration file used by apache
275
to host the user repositories:""",
277
# The location of the subversion configuration file used by
278
# apache to host the user repositories."""))
279
config_options.append(ConfigOption("svn_repo_path", "/home/informatics/repositories",
280
"""The root directory for the subversion repositories:""",
282
# The root directory for the subversion repositories."""))
283
config_options.append(ConfigOption("svn_auth_ivle", "/opt/ivle/svn/ivle.auth",
284
"""The location of the password file used to authenticate users
285
of the subversion repository from the ivle server:""",
287
# The location of the password file used to authenticate users
288
# of the subversion repository from the ivle server."""))
289
config_options.append(ConfigOption("svn_auth_local", "/opt/ivle/svn/local.auth",
290
"""The location of the password file used to authenticate local users
291
of the subversion repository:""",
293
# The location of the password file used to authenticate local users
294
# of the subversion repository."""))
295
config_options.append(ConfigOption("usrmgt_host", "localhost",
296
"""The hostname where the usrmgt-server runs:""",
298
# The hostname where the usrmgt-server runs."""))
299
config_options.append(ConfigOption("usrmgt_port", "2178",
300
"""The port where the usrmgt-server runs:""",
302
# The port where the usrmgt-server runs."""))
303
config_options.append(ConfigOption("usrmgt_magic", "",
304
"""The password for the usrmgt-server:""",
306
# The password for the usrmgt-server."""))
308
136
# Try importing existing conf, but if we can't just set up defaults
309
137
# The reason for this is that these settings are used by other phases
310
138
# of setup besides conf, so we need to know them.
311
139
# Also this allows you to hit Return to accept the existing value.
313
confmodule = __import__("lib/conf/conf")
314
for opt in config_options:
316
globals()[opt.option_name] = confmodule.__dict__[opt.option_name]
318
globals()[opt.option_name] = opt.default
141
confmodule = __import__("www/conf/conf")
143
root_dir = confmodule.root_dir
147
ivle_install_dir = confmodule.ivle_install_dir
149
ivle_install_dir = "/opt/ivle"
151
public_host = confmodule.public_host
153
public_host = "public.localhost"
155
jail_base = confmodule.jail_base
157
jail_base = "/home/informatics/jails"
159
subjects_base = confmodule.subjects_base
161
subjects_base = "/home/informatics/subjects"
319
162
except ImportError:
320
163
# Just set reasonable defaults
321
for opt in config_options:
322
globals()[opt.option_name] = opt.default
165
ivle_install_dir = "/opt/ivle"
166
public_host = "public.localhost"
167
jail_base = "/home/informatics/jails"
168
subjects_base = "/home/informatics/subjects"
324
172
# Try importing install_list, but don't fail if we can't, because listmake can
325
173
# function without it.
594
432
print """This tool will create the following files:
598
435
prompting you for details about your configuration. The file will be
599
436
overwritten if it already exists. It will *not* install or deploy IVLE.
601
438
Please hit Ctrl+C now if you do not wish to do this.
602
""" % (conffile, jailconffile, conf_hfile)
439
""" % (conffile, conf_hfile)
604
441
# Get information from the administrator
605
442
# If EOF is encountered at any time during the questioning, just exit
608
for opt in config_options:
609
globals()[opt.option_name] = \
610
query_user(globals()[opt.option_name], opt.prompt)
445
root_dir = query_user(root_dir,
446
"""Root directory where IVLE is located (in URL space):""")
447
ivle_install_dir = query_user(ivle_install_dir,
448
'Root directory where IVLE will be installed (on the local file '
450
jail_base = query_user(jail_base,
451
"""Root directory where the jails (containing user files) are stored
452
(on the local file system):""")
453
subjects_base = query_user(subjects_base,
454
"""Root directory where the subject directories (containing worksheets
455
and other per-subject files) are stored (on the local file system):""")
456
public_host = query_user(public_host,
457
"""Hostname which will cause the server to go into "public mode",
458
providing login-free access to student's published work:""")
459
allowed_uids = query_user(allowed_uids,
460
"""UID of the web server process which will run IVLE.
461
Only this user may execute the trampoline. May specify multiple users as
462
a comma-separated list.
612
466
opts = dict(opts)
613
467
# Non-interactive mode. Parse the options.
614
for opt in config_options:
615
if '--' + opt.option_name in opts:
616
globals()[opt.option_name] = opts['--' + opt.option_name]
468
if '--root_dir' in opts:
469
root_dir = opts['--root_dir']
470
if '--ivle_install_dir' in opts:
471
ivle_install_dir = opts['--ivle_install_dir']
472
if '--jail_base' in opts:
473
jail_base = opts['--jail_base']
474
if '--subjects_base' in opts:
475
jail_base = opts['--subjects_base']
476
if '--public_host' in opts:
477
public_host = opts['--public_host']
478
if '--allowed_uids' in opts:
479
allowed_uids = opts['--allowed_uids']
618
481
# Error handling on input values
620
allowed_uids_list = map(int, allowed_uids.split(','))
483
allowed_uids = map(int, allowed_uids.split(','))
621
484
except ValueError:
622
485
print >>sys.stderr, (
623
486
"Invalid UID list (%s).\n"
624
487
"Must be a comma-separated list of integers." % allowed_uids)
627
db_port = int(db_port)
628
if db_port < 0 or db_port >= 65536: raise ValueError()
630
print >>sys.stderr, (
631
"Invalid DB port (%s).\n"
632
"Must be an integer between 0 and 65535." % repr(db_port))
635
usrmgt_port = int(usrmgt_port)
636
if usrmgt_port < 0 or usrmgt_port >= 65536: raise ValueError()
638
print >>sys.stderr, (
639
"Invalid user management port (%s).\n"
640
"Must be an integer between 0 and 65535." % repr(usrmgt_port))
643
# Write lib/conf/conf.py
490
# Write www/conf/conf.py
646
493
conf = open(conffile, "w")
650
497
# Miscellaneous application settings
653
for opt in config_options:
654
conf.write('%s\n%s = %s\n' % (opt.comment, opt.option_name,
655
repr(globals()[opt.option_name])))
658
except IOError, (errno, strerror):
659
print "IO error(%s): %s" % (errno, strerror)
662
print "Successfully wrote lib/conf/conf.py"
664
# Write conf/jailconf.py
667
conf = open(jailconffile, "w")
669
# In the "in-jail" version of conf, we don't need MOST of the details
670
# (it would be a security risk to have them here).
671
# So we just write root_dir, and jail_base is "/".
672
# (jail_base being "/" means "jail-relative" paths are relative to "/"
673
# when inside the jail.)
674
conf.write("""# IVLE Configuration File
676
# Miscellaneous application settings
677
# (User jail version)
680
500
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
682
502
# eg. "/" or "/ivle".
505
# In the local file system, where IVLE is actually installed.
506
# This directory should contain the "www" and "bin" directories.
507
ivle_install_dir = "%s"
509
# The server goes into "public mode" if the browser sends a request with this
510
# host. This is for security reasons - we only serve public student files on a
511
# separate domain to the main IVLE site.
512
# Public mode does not use cookies, and serves only public content.
513
# Private mode (normal mode) requires login, and only serves files relevant to
514
# the logged-in user.
685
517
# In the local file system, where are the student/user file spaces located.
686
518
# The user jails are expected to be located immediately in subdirectories of
690
# The hostname for serving publicly accessible pages
692
""" % (repr(root_dir),repr(public_host)))
522
# In the local file system, where are the per-subject file spaces located.
523
# The individual subject directories are expected to be located immediately
524
# in subdirectories of this location.
526
""" % (root_dir, ivle_install_dir, public_host, jail_base, subjects_base))
695
529
except IOError, (errno, strerror):
696
530
print "IO error(%s): %s" % (errno, strerror)
699
print "Successfully wrote lib/conf/jailconf.py"
533
print "Successfully wrote www/conf/conf.py"
701
535
# Write trampoline/conf.h
763
591
action_mkdir('jail/tmp', dry)
765
593
# Copy all console and operating system files into the jail
766
action_copylist(install_list.list_scripts, 'jail/opt/ivle', dry)
594
action_copylist(install_list.list_console, 'jail/opt/ivle', dry)
767
595
copy_os_files_jail(dry)
768
596
# Chmod the python console
769
action_chmod_x('jail/opt/ivle/scripts/python-console', dry)
770
action_chmod_x('jail/opt/ivle/scripts/fileservice', dry)
597
action_chmod_x('jail/opt/ivle/console/python-console', dry)
772
# Also copy the IVLE lib directory into the jail
773
# This is necessary for running certain scripts
774
action_copylist(install_list.list_lib, 'jail/opt/ivle', dry)
775
# IMPORTANT: The file jail/opt/ivle/lib/conf/conf.py contains details
776
# which could compromise security if left in the jail (such as the DB
778
# The "safe" version is in jailconf.py. Delete conf.py and replace it with
780
action_copyfile('lib/conf/jailconf.py',
781
'jail/opt/ivle/lib/conf/conf.py', dry)
783
600
# Compile .py files into .pyc or .pyo files
784
601
compileall.compile_dir('www', quiet=True)
785
compileall.compile_dir('lib', quiet=True)
786
compileall.compile_dir('scripts', quiet=True)
787
compileall.compile_dir('jail/opt/ivle/lib', quiet=True)
789
# Set up ivle.pth inside the jail
790
# Need to set /opt/ivle/lib to be on the import path
792
"jail/usr/lib/python%s/site-packages/ivle.pth" % PYTHON_VERSION
793
f = open(ivle_pth, 'w')
794
f.write('/opt/ivle/lib\n')
602
compileall.compile_dir('console', quiet=True)