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',
103
142
# Needed by matplotlib
104
143
'/usr/lib/i686/cmov/libssl.so.0.9.8',
105
144
'/usr/lib/i686/cmov/libcrypto.so.0.9.8',
133
172
'/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", "/ivle",
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"""))
136
274
# Try importing existing conf, but if we can't just set up defaults
137
275
# The reason for this is that these settings are used by other phases
138
276
# of setup besides conf, so we need to know them.
139
277
# Also this allows you to hit Return to accept the existing value.
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"
279
confmodule = __import__("lib/conf/conf")
280
for opt in config_options:
282
globals()[opt.option_name] = confmodule.__dict__[opt.option_name]
284
globals()[opt.option_name] = opt.default
162
285
except ImportError:
163
286
# Just set reasonable defaults
165
ivle_install_dir = "/opt/ivle"
166
public_host = "public.localhost"
167
jail_base = "/home/informatics/jails"
168
subjects_base = "/home/informatics/subjects"
287
for opt in config_options:
288
globals()[opt.option_name] = opt.default
172
290
# Try importing install_list, but don't fail if we can't, because listmake can
173
291
# function without it.
327
441
def listmake(args):
328
442
# We build two separate lists, by walking www and console
329
443
list_www = build_list_py_files('www')
330
list_console = build_list_py_files('console')
444
list_lib = build_list_py_files('lib')
445
list_scripts = build_list_py_files('scripts')
331
446
list_subjects = build_list_py_files('subjects', no_top_level=True)
447
list_problems = build_list_py_files('problems', no_top_level=True)
332
448
# Make sure that the files generated by conf are in the list
333
449
# (since listmake is typically run before conf)
334
if "www/conf/conf.py" not in list_www:
335
list_www.append("www/conf/conf.py")
450
if "lib/conf/conf.py" not in list_lib:
451
list_lib.append("lib/conf/conf.py")
336
452
# Make sure that console/python-console is in the list
337
if "console/python-console" not in list_console:
338
list_console.append("console/python-console")
453
if "scripts/python-console" not in list_scripts:
454
list_scripts.append("scripts/python-console")
455
if "scripts/fileservice" not in list_scripts:
456
list_scripts.append("scripts/fileservice")
339
457
# Write these out to a file
340
458
cwd = os.getcwd()
341
459
# the files that will be created/overwritten
408
535
file.write(']\n')
411
global root_dir, ivle_install_dir, jail_base, subjects_base
412
global public_host, allowed_uids
413
539
# Set up some variables
415
541
cwd = os.getcwd()
416
542
# the files that will be created/overwritten
417
conffile = os.path.join(cwd, "www/conf/conf.py")
543
conffile = os.path.join(cwd, "lib/conf/conf.py")
544
jailconffile = os.path.join(cwd, "lib/conf/jailconf.py")
418
545
conf_hfile = os.path.join(cwd, "trampoline/conf.h")
420
547
# Get command-line arguments to avoid asking questions.
422
(opts, args) = getopt.gnu_getopt(args, "", ['root_dir=',
423
'ivle_install_dir=', 'jail_base=', 'allowed_uids='])
550
for opt in config_options:
551
optnames.append(opt.option_name + "=")
552
(opts, args) = getopt.gnu_getopt(args, "", optnames)
426
555
print >>sys.stderr, "Invalid arguments:", string.join(args, ' ')
432
561
print """This tool will create the following files:
435
565
prompting you for details about your configuration. The file will be
436
566
overwritten if it already exists. It will *not* install or deploy IVLE.
438
568
Please hit Ctrl+C now if you do not wish to do this.
439
""" % (conffile, conf_hfile)
569
""" % (conffile, jailconffile, conf_hfile)
441
571
# Get information from the administrator
442
572
# If EOF is encountered at any time during the questioning, just exit
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.
575
for opt in config_options:
576
globals()[opt.option_name] = \
577
query_user(globals()[opt.option_name], opt.prompt)
466
579
opts = dict(opts)
467
580
# Non-interactive mode. Parse the options.
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']
581
for opt in config_options:
582
if '--' + opt.option_name in opts:
583
globals()[opt.option_name] = opts['--' + opt.option_name]
481
585
# Error handling on input values
483
allowed_uids = map(int, allowed_uids.split(','))
587
allowed_uids_list = map(int, allowed_uids.split(','))
484
588
except ValueError:
485
589
print >>sys.stderr, (
486
590
"Invalid UID list (%s).\n"
487
591
"Must be a comma-separated list of integers." % allowed_uids)
594
db_port = int(db_port)
595
if db_port < 0 or db_port >= 65536: raise ValueError()
597
print >>sys.stderr, (
598
"Invalid DB port (%s).\n"
599
"Must be an integer between 0 and 65535." % repr(db_port))
490
# Write www/conf/conf.py
602
# Write lib/conf/conf.py
493
605
conf = open(conffile, "w")
497
609
# Miscellaneous application settings
612
for opt in config_options:
613
conf.write('%s\n%s = %s\n' % (opt.comment, opt.option_name,
614
repr(globals()[opt.option_name])))
617
except IOError, (errno, strerror):
618
print "IO error(%s): %s" % (errno, strerror)
621
print "Successfully wrote lib/conf/conf.py"
623
# Write conf/jailconf.py
626
conf = open(jailconffile, "w")
628
# In the "in-jail" version of conf, we don't need MOST of the details
629
# (it would be a security risk to have them here).
630
# So we just write root_dir, and jail_base is "/".
631
# (jail_base being "/" means "jail-relative" paths are relative to "/"
632
# when inside the jail.)
633
conf.write("""# IVLE Configuration File
635
# Miscellaneous application settings
636
# (User jail version)
500
639
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
502
641
# 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.
517
644
# In the local file system, where are the student/user file spaces located.
518
645
# The user jails are expected to be located immediately in subdirectories of
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))
649
# The hostname for serving publicly accessible pages
651
""" % (repr(root_dir),repr(public_host)))
529
654
except IOError, (errno, strerror):
530
655
print "IO error(%s): %s" % (errno, strerror)
533
print "Successfully wrote www/conf/conf.py"
658
print "Successfully wrote lib/conf/jailconf.py"
535
660
# Write trampoline/conf.h
591
722
action_mkdir('jail/tmp', dry)
593
724
# Copy all console and operating system files into the jail
594
action_copylist(install_list.list_console, 'jail/opt/ivle', dry)
725
action_copylist(install_list.list_scripts, 'jail/opt/ivle', dry)
595
726
copy_os_files_jail(dry)
596
727
# Chmod the python console
597
action_chmod_x('jail/opt/ivle/console/python-console', dry)
728
action_chmod_x('jail/opt/ivle/scripts/python-console', dry)
729
action_chmod_x('jail/opt/ivle/scripts/fileservice', dry)
731
# Also copy the IVLE lib directory into the jail
732
# This is necessary for running certain scripts
733
action_copylist(install_list.list_lib, 'jail/opt/ivle', dry)
734
# IMPORTANT: The file jail/opt/ivle/lib/conf/conf.py contains details
735
# which could compromise security if left in the jail (such as the DB
737
# The "safe" version is in jailconf.py. Delete conf.py and replace it with
739
action_copyfile('lib/conf/jailconf.py',
740
'jail/opt/ivle/lib/conf/conf.py', dry)
600
742
# Compile .py files into .pyc or .pyo files
601
743
compileall.compile_dir('www', quiet=True)
602
compileall.compile_dir('console', quiet=True)
744
compileall.compile_dir('lib', quiet=True)
745
compileall.compile_dir('scripts', quiet=True)
746
compileall.compile_dir('jail/opt/ivle/lib', quiet=True)
748
# Set up ivle.pth inside the jail
749
# Need to set /opt/ivle/lib to be on the import path
751
"jail/usr/lib/python%s/site-packages/ivle.pth" % PYTHON_VERSION
752
f = open(ivle_pth, 'w')
753
f.write('/opt/ivle/lib\n')
656
809
# for all the students' jails).
657
810
action_copytree('jail', os.path.join(jail_base, 'template'), dry)
658
811
if not nosubjects:
659
# Copy the subjects directory across
812
# Copy the subjects and problems directories across
660
813
action_copylist(install_list.list_subjects, subjects_base, dry,
661
814
srcdir="./subjects")
815
action_copylist(install_list.list_problems, problems_base, dry,
663
818
# Append IVLE path to ivle.pth in python site packages
664
819
# (Unless it's already there)
665
820
ivle_pth = os.path.join(sys.prefix,
666
821
"lib/python%s/site-packages/ivle.pth" % PYTHON_VERSION)
667
822
ivle_www = os.path.join(ivle_install_dir, "www")
823
ivle_lib = os.path.join(ivle_install_dir, "lib")
668
824
write_ivle_pth = True
825
write_ivle_lib_pth = True
670
827
file = open(ivle_pth, 'r')
671
828
for line in file:
672
829
if line.strip() == ivle_www:
673
830
write_ivle_pth = False
831
elif line.strip() == ivle_lib:
832
write_ivle_lib_pth = False
675
834
except (IOError, OSError):
677
836
if write_ivle_pth:
678
837
action_append(ivle_pth, ivle_www)
838
if write_ivle_lib_pth:
839
action_append(ivle_pth, ivle_lib)