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

« back to all changes in this revision

Viewing changes to setup.py

  • Committer: mattgiuca
  • Date: 2008-01-25 01:21:03 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:301
tutorialservice: Now parses and executes the students code using the test
framework, and returns the test results as JSON.

Show diffs side-by-side

added added

removed removed

Lines of Context:
31
31
# cutting a distribution, and the listfile it generates should be included in
32
32
# the distribution, avoiding the administrator having to run it.
33
33
 
34
 
# setup.py config [args]
 
34
# setup.py conf [args]
35
35
# Configures IVLE with machine-specific details, most notably, various paths.
36
36
# Either prompts the administrator for these details or accepts them as
37
37
# command-line args.
38
 
# Creates lib/conf/conf.py and trampoline/conf.h.
 
38
# Creates www/conf/conf.py and trampoline/conf.h.
39
39
 
40
40
# setup.py build
41
41
# Compiles all files and sets up a jail template in the source directory.
70
70
 
71
71
# Import modules from the website is tricky since they're in the www
72
72
# directory.
73
 
sys.path.append(os.path.join(os.getcwd(), 'lib'))
 
73
sys.path.append(os.path.join(os.getcwd(), 'www'))
74
74
import conf
75
75
import common.makeuser
76
76
 
77
 
# Determine which Python version (2.4 or 2.5, for example) we are running,
78
 
# and use that as the filename to the Python directory.
79
 
# Just get the first 3 characters of sys.version.
80
 
PYTHON_VERSION = sys.version[0:3]
81
 
 
82
77
# Operating system files to copy over into the jail.
83
78
# These will be copied from the given place on the OS file system into the
84
79
# same place within the jail.
99
94
    '/bin/ls',
100
95
    '/bin/echo',
101
96
    # Needed by python
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',
108
 
    '/lib/librt.so.1',
109
 
    '/lib/libuuid.so.1',
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',
 
97
    '/usr/bin/python2.5',
142
98
    # Needed by matplotlib
143
99
    '/usr/lib/i686/cmov/libssl.so.0.9.8',
144
100
    '/usr/lib/i686/cmov/libcrypto.so.0.9.8',
162
118
]
163
119
# Symlinks to make within the jail. Src mapped to dst.
164
120
JAIL_LINKS = {
165
 
    'python%s' % PYTHON_VERSION: 'jail/usr/bin/python',
 
121
    'python2.5': 'jail/usr/bin/python',
166
122
}
167
123
# Trees to copy. Src mapped to dst (these will be passed to action_copytree).
168
124
JAIL_COPYTREES = {
169
 
    '/usr/lib/python%s' % PYTHON_VERSION:
170
 
        'jail/usr/lib/python%s' % PYTHON_VERSION,
 
125
    '/usr/lib/python2.5': 'jail/usr/lib/python2.5',
171
126
    '/usr/share/matplotlib': 'jail/usr/share/matplotlib',
172
127
    '/etc/ld.so.conf.d': 'jail/etc/ld.so.conf.d',
173
128
}
174
129
 
175
 
class ConfigOption:
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
183
 
            setup.py conf.
184
 
        comment: (Long) comment string stored in conf.py. Each line of this
185
 
            string should begin with a '#'.
186
 
        """
187
 
        self.option_name = option_name
188
 
        self.default = default
189
 
        self.prompt = prompt
190
 
        self.comment = comment
191
 
 
192
 
# Configuration options, defaults and descriptions
193
 
config_options = []
194
 
config_options.append(ConfigOption("root_dir", "/ivle",
195
 
    """Root directory where IVLE is located (in URL space):""",
196
 
    """
197
 
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
198
 
# with this).
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 '
202
 
    'system):',
203
 
    """
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):""",
209
 
    """
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):""",
217
 
    """
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
225
 
system):""",
226
 
    """
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:""",
232
 
    """
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.
243
 
    (eg. "1002,78")""",
244
 
    """
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:""",
253
 
    """
254
 
### PostgreSQL Database config ###
255
 
# Database server hostname"""))
256
 
config_options.append(ConfigOption("db_port", "5432",
257
 
    """Port of the DB server:""",
258
 
    """
259
 
# Database server port"""))
260
 
config_options.append(ConfigOption("db_dbname", "ivle",
261
 
    """Database name:""",
262
 
    """
263
 
# Database name"""))
264
 
config_options.append(ConfigOption("db_user", "postgres",
265
 
    """Username for DB server login:""",
266
 
    """
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)""",
271
 
    """
272
 
# Database password"""))
273
 
 
274
130
# Try importing existing conf, but if we can't just set up defaults
275
131
# The reason for this is that these settings are used by other phases
276
132
# of setup besides conf, so we need to know them.
277
133
# Also this allows you to hit Return to accept the existing value.
278
134
try:
279
 
    confmodule = __import__("lib/conf/conf")
280
 
    for opt in config_options:
281
 
        try:
282
 
            globals()[opt.option_name] = confmodule.__dict__[opt.option_name]
283
 
        except:
284
 
            globals()[opt.option_name] = opt.default
 
135
    confmodule = __import__("www/conf/conf")
 
136
    try:
 
137
        root_dir = confmodule.root_dir
 
138
    except:
 
139
        root_dir = "/ivle"
 
140
    try:
 
141
        ivle_install_dir = confmodule.ivle_install_dir
 
142
    except:
 
143
        ivle_install_dir = "/opt/ivle"
 
144
    try:
 
145
        public_host = confmodule.public_host
 
146
    except:
 
147
        public_host = "public.localhost"
 
148
    try:
 
149
        jail_base = confmodule.jail_base
 
150
    except:
 
151
        jail_base = "/home/informatics/jails"
 
152
    try:
 
153
        subjects_base = confmodule.subjects_base
 
154
    except:
 
155
        subjects_base = "/home/informatics/subjects"
285
156
except ImportError:
286
157
    # Just set reasonable defaults
287
 
    for opt in config_options:
288
 
        globals()[opt.option_name] = opt.default
 
158
    root_dir = "/ivle"
 
159
    ivle_install_dir = "/opt/ivle"
 
160
    public_host = "public.localhost"
 
161
    jail_base = "/home/informatics/jails"
 
162
    subjects_base = "/home/informatics/subjects"
 
163
# Always defaults
 
164
allowed_uids = "0"
289
165
 
290
166
# Try importing install_list, but don't fail if we can't, because listmake can
291
167
# function without it.
300
176
# as necessary, and include it in the distribution.
301
177
listmake_mimetypes = ['text/x-python', 'text/html',
302
178
    'application/x-javascript', 'application/javascript',
303
 
    'text/css', 'image/png', 'application/xml']
 
179
    'text/css', 'image/png']
304
180
 
305
181
# Main function skeleton from Guido van Rossum
306
182
# http://www.artima.com/weblogs/viewpost.jsp?thread=4829
338
214
    try:
339
215
        oper_func = {
340
216
            'help' : help,
341
 
            'config' : conf,
 
217
            'conf' : conf,
342
218
            'build' : build,
343
219
            'listmake' : listmake,
344
220
            'install' : install,
359
235
Operation (and args) can be:
360
236
    help [operation]
361
237
    listmake (developer use only)
362
 
    config [args]
 
238
    conf [args]
363
239
    build
364
 
    install [--nojail] [--nosubjects] [-n|--dry]
 
240
    install [--nojail] [-n|--dry]
365
241
"""
366
242
        return 1
367
243
    elif len(args) != 1:
380
256
be copied upon installation. This should be run by the developer before
381
257
cutting a distribution, and the listfile it generates should be included in
382
258
the distribution, avoiding the administrator having to run it."""
383
 
    elif operation == 'config':
384
 
        print """python setup.py config [args]
 
259
    elif operation == 'conf':
 
260
        print """python setup.py conf [args]
385
261
Configures IVLE with machine-specific details, most notably, various paths.
386
262
Either prompts the administrator for these details or accepts them as
387
263
command-line args. Will be interactive only if there are no arguments given.
391
267
to rebuild/install), just provide ivle_install_dir as the IVLE trunk
392
268
directory, and run build/install one time.
393
269
 
394
 
Creates lib/conf/conf.py and trampoline/conf.h.
 
270
Creates www/conf/conf.py and trampoline/conf.h.
395
271
 
396
 
Args are:"""
397
 
        for opt in config_options:
398
 
            print "    --" + opt.option_name
399
 
        print """As explained in the interactive prompt or conf.py.
 
272
Args are:
 
273
    --root_dir
 
274
    --ivle_install_dir
 
275
    --public_host
 
276
    --jail_base
 
277
    --subjects_base
 
278
    --allowed_uids
 
279
As explained in the interactive prompt or conf.py.
400
280
"""
401
281
    elif operation == 'build':
402
282
        print """python -O setup.py build [--dry|-n]
413
293
 
414
294
--dry | -n  Print out the actions but don't do anything."""
415
295
    elif operation == 'install':
416
 
        print """sudo python setup.py install [--nojail] [--nosubjects][--dry|-n]
 
296
        print """sudo python setup.py install [--nojail] [--dry|-n]
417
297
(Requires root)
418
298
Create target install directory ($target).
419
299
Create $target/bin.
421
301
chown and chmod the installed trampoline.
422
302
Copy www/ to $target.
423
303
Copy jail/ to jails template directory (unless --nojail specified).
424
 
Copy subjects/ to subjects directory (unless --nosubjects specified).
425
304
 
426
 
--nojail        Do not copy the jail.
427
 
--nosubjects    Do not copy the subjects and problems directories.
 
305
--nojail    Do not copy the jail.
428
306
--dry | -n  Print out the actions but don't do anything."""
429
307
    elif operation == 'updatejails':
430
308
        print """sudo python setup.py updatejails [--dry|-n]
441
319
def listmake(args):
442
320
    # We build two separate lists, by walking www and console
443
321
    list_www = build_list_py_files('www')
444
 
    list_lib = build_list_py_files('lib')
445
 
    list_scripts = build_list_py_files('scripts')
446
 
    list_subjects = build_list_py_files('subjects', no_top_level=True)
447
 
    list_problems = build_list_py_files('problems', no_top_level=True)
 
322
    list_console = build_list_py_files('console')
448
323
    # Make sure that the files generated by conf are in the list
449
324
    # (since listmake is typically run before conf)
450
 
    if "lib/conf/conf.py" not in list_lib:
451
 
        list_lib.append("lib/conf/conf.py")
 
325
    if "www/conf/conf.py" not in list_www:
 
326
        list_www.append("www/conf/conf.py")
452
327
    # Make sure that console/python-console is in the list
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")
 
328
    if "console/python-console" not in list_console:
 
329
        list_console.append("console/python-console")
457
330
    # Write these out to a file
458
331
    cwd = os.getcwd()
459
332
    # the files that will be created/overwritten
473
346
list_www = """)
474
347
        writelist_pretty(file, list_www)
475
348
        file.write("""
476
 
# List of all installable files in lib directory.
477
 
list_lib = """)
478
 
        writelist_pretty(file, list_lib)
479
 
        file.write("""
480
 
# List of all installable files in scripts directory.
481
 
list_scripts = """)
482
 
        writelist_pretty(file, list_scripts)
483
 
        file.write("""
484
 
# List of all installable files in subjects directory.
485
 
# This is to install sample subjects and material.
486
 
list_subjects = """)
487
 
        writelist_pretty(file, list_subjects)
488
 
        file.write("""
489
 
# List of all installable files in problems directory.
490
 
# This is to install sample exercise material.
491
 
list_problems = """)
492
 
        writelist_pretty(file, list_problems)
 
349
# List of all installable files in console directory.
 
350
list_console = """)
 
351
        writelist_pretty(file, list_console)
493
352
 
494
353
        file.close()
495
354
    except IOError, (errno, strerror):
506
365
 
507
366
    return 0
508
367
 
509
 
def build_list_py_files(dir, no_top_level=False):
 
368
def build_list_py_files(dir):
510
369
    """Builds a list of all py files found in a directory and its
511
 
    subdirectories. Returns this as a list of strings.
512
 
    no_top_level=True means the file paths will not include the top-level
513
 
    directory.
514
 
    """
 
370
    subdirectories. Returns this as a list of strings."""
515
371
    pylist = []
516
372
    for (dirpath, dirnames, filenames) in os.walk(dir):
517
373
        # Exclude directories beginning with a '.' (such as '.svn')
519
375
        # All *.py files are added to the list
520
376
        pylist += [os.path.join(dirpath, item) for item in filenames
521
377
            if mimetypes.guess_type(item)[0] in listmake_mimetypes]
522
 
    if no_top_level:
523
 
        for i in range(0, len(pylist)):
524
 
            _, pylist[i] = pylist[i].split(os.sep, 1)
525
378
    return pylist
526
379
 
527
380
def writelist_pretty(file, list):
535
388
        file.write(']\n')
536
389
 
537
390
def conf(args):
538
 
    global db_port
 
391
    global root_dir, ivle_install_dir, jail_base, subjects_base
 
392
    global public_host, allowed_uids
539
393
    # Set up some variables
540
394
 
541
395
    cwd = os.getcwd()
542
396
    # the files that will be created/overwritten
543
 
    conffile = os.path.join(cwd, "lib/conf/conf.py")
544
 
    jailconffile = os.path.join(cwd, "lib/conf/jailconf.py")
 
397
    conffile = os.path.join(cwd, "www/conf/conf.py")
545
398
    conf_hfile = os.path.join(cwd, "trampoline/conf.h")
546
399
 
547
400
    # Get command-line arguments to avoid asking questions.
548
401
 
549
 
    optnames = []
550
 
    for opt in config_options:
551
 
        optnames.append(opt.option_name + "=")
552
 
    (opts, args) = getopt.gnu_getopt(args, "", optnames)
 
402
    (opts, args) = getopt.gnu_getopt(args, "", ['root_dir=',
 
403
                    'ivle_install_dir=', 'jail_base=', 'allowed_uids='])
553
404
 
554
405
    if args != []:
555
406
        print >>sys.stderr, "Invalid arguments:", string.join(args, ' ')
561
412
        print """This tool will create the following files:
562
413
    %s
563
414
    %s
564
 
    %s
565
415
prompting you for details about your configuration. The file will be
566
416
overwritten if it already exists. It will *not* install or deploy IVLE.
567
417
 
568
418
Please hit Ctrl+C now if you do not wish to do this.
569
 
""" % (conffile, jailconffile, conf_hfile)
 
419
""" % (conffile, conf_hfile)
570
420
 
571
421
        # Get information from the administrator
572
422
        # If EOF is encountered at any time during the questioning, just exit
573
423
        # silently
574
424
 
575
 
        for opt in config_options:
576
 
            globals()[opt.option_name] = \
577
 
                query_user(globals()[opt.option_name], opt.prompt)
 
425
        root_dir = query_user(root_dir,
 
426
        """Root directory where IVLE is located (in URL space):""")
 
427
        ivle_install_dir = query_user(ivle_install_dir,
 
428
        'Root directory where IVLE will be installed (on the local file '
 
429
        'system):')
 
430
        jail_base = query_user(jail_base,
 
431
        """Root directory where the jails (containing user files) are stored
 
432
(on the local file system):""")
 
433
        subjects_base = query_user(subjects_base,
 
434
        """Root directory where the subject directories (containing worksheets
 
435
and other per-subject files) are stored (on the local file system):""")
 
436
        public_host = query_user(public_host,
 
437
        """Hostname which will cause the server to go into "public mode",
 
438
providing login-free access to student's published work:""")
 
439
        allowed_uids = query_user(allowed_uids,
 
440
        """UID of the web server process which will run IVLE.
 
441
Only this user may execute the trampoline. May specify multiple users as
 
442
a comma-separated list.
 
443
    (eg. "1002,78")""")
 
444
 
578
445
    else:
579
446
        opts = dict(opts)
580
447
        # Non-interactive mode. Parse the options.
581
 
        for opt in config_options:
582
 
            if '--' + opt.option_name in opts:
583
 
                globals()[opt.option_name] = opts['--' + opt.option_name]
 
448
        if '--root_dir' in opts:
 
449
            root_dir = opts['--root_dir']
 
450
        if '--ivle_install_dir' in opts:
 
451
            ivle_install_dir = opts['--ivle_install_dir']
 
452
        if '--jail_base' in opts:
 
453
            jail_base = opts['--jail_base']
 
454
        if '--subjects_base' in opts:
 
455
            jail_base = opts['--subjects_base']
 
456
        if '--public_host' in opts:
 
457
            public_host = opts['--public_host']
 
458
        if '--allowed_uids' in opts:
 
459
            allowed_uids = opts['--allowed_uids']
584
460
 
585
461
    # Error handling on input values
586
462
    try:
587
 
        allowed_uids_list = map(int, allowed_uids.split(','))
 
463
        allowed_uids = map(int, allowed_uids.split(','))
588
464
    except ValueError:
589
465
        print >>sys.stderr, (
590
466
        "Invalid UID list (%s).\n"
591
467
        "Must be a comma-separated list of integers." % allowed_uids)
592
468
        return 1
593
 
    try:
594
 
        db_port = int(db_port)
595
 
        if db_port < 0 or db_port >= 65536: raise ValueError()
596
 
    except ValueError:
597
 
        print >>sys.stderr, (
598
 
        "Invalid DB port (%s).\n"
599
 
        "Must be an integer between 0 and 65535." % repr(db_port))
600
 
        return 1
601
469
 
602
 
    # Write lib/conf/conf.py
 
470
    # Write www/conf/conf.py
603
471
 
604
472
    try:
605
473
        conf = open(conffile, "w")
608
476
# conf.py
609
477
# Miscellaneous application settings
610
478
 
611
 
""")
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])))
615
 
 
616
 
        conf.close()
617
 
    except IOError, (errno, strerror):
618
 
        print "IO error(%s): %s" % (errno, strerror)
619
 
        sys.exit(1)
620
 
 
621
 
    print "Successfully wrote lib/conf/conf.py"
622
 
 
623
 
    # Write conf/jailconf.py
624
 
 
625
 
    try:
626
 
        conf = open(jailconffile, "w")
627
 
 
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
634
 
# conf.py
635
 
# Miscellaneous application settings
636
 
# (User jail version)
637
 
 
638
479
 
639
480
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
640
481
# with this).
641
482
# eg. "/" or "/ivle".
642
 
root_dir = %s
 
483
root_dir = "%s"
 
484
 
 
485
# In the local file system, where IVLE is actually installed.
 
486
# This directory should contain the "www" and "bin" directories.
 
487
ivle_install_dir = "%s"
 
488
 
 
489
# The server goes into "public mode" if the browser sends a request with this
 
490
# host. This is for security reasons - we only serve public student files on a
 
491
# separate domain to the main IVLE site.
 
492
# Public mode does not use cookies, and serves only public content.
 
493
# Private mode (normal mode) requires login, and only serves files relevant to
 
494
# the logged-in user.
 
495
public_host = "%s"
643
496
 
644
497
# In the local file system, where are the student/user file spaces located.
645
498
# The user jails are expected to be located immediately in subdirectories of
646
499
# this location.
647
 
jail_base = '/'
 
500
jail_base = "%s"
648
501
 
649
 
# The hostname for serving publicly accessible pages
650
 
public_host = %s
651
 
""" % (repr(root_dir),repr(public_host)))
 
502
# In the local file system, where are the per-subject file spaces located.
 
503
# The individual subject directories are expected to be located immediately
 
504
# in subdirectories of this location.
 
505
subjects_base = "%s"
 
506
""" % (root_dir, ivle_install_dir, public_host, jail_base, subjects_base))
652
507
 
653
508
        conf.close()
654
509
    except IOError, (errno, strerror):
655
510
        print "IO error(%s): %s" % (errno, strerror)
656
511
        sys.exit(1)
657
512
 
658
 
    print "Successfully wrote lib/conf/jailconf.py"
 
513
    print "Successfully wrote www/conf/conf.py"
659
514
 
660
515
    # Write trampoline/conf.h
661
516
 
680
535
 * (Note that root is an implicit member of this list).
681
536
 */
682
537
static const int allowed_uids[] = { %s };
683
 
""" % (repr(jail_base)[1:-1], repr(allowed_uids_list)[1:-1]))
684
 
    # Note: The above uses PYTHON reprs, not C reprs
685
 
    # However they should be the same with the exception of the outer
686
 
    # characters, which are stripped off and replaced
 
538
""" % (jail_base, repr(allowed_uids)[1:-1]))
687
539
 
688
540
        conf.close()
689
541
    except IOError, (errno, strerror):
695
547
    print
696
548
    print "You may modify the configuration at any time by editing"
697
549
    print conffile
698
 
    print jailconffile
699
550
    print conf_hfile
700
551
    print
701
552
    return 0
710
561
        print "Dry run (no actions will be executed\n"
711
562
 
712
563
    # Compile the trampoline
713
 
    curdir = os.getcwd()
714
 
    os.chdir('trampoline')
715
 
    action_runprog('make', [], dry)
716
 
    os.chdir(curdir)
 
564
    action_runprog('gcc', ['-Wall', '-o', 'trampoline/trampoline',
 
565
        'trampoline/trampoline.c'], dry)
717
566
 
718
567
    # Create the jail and its subdirectories
719
568
    # Note: Other subdirs will be made by copying files
722
571
    action_mkdir('jail/tmp', dry)
723
572
 
724
573
    # Copy all console and operating system files into the jail
725
 
    action_copylist(install_list.list_scripts, 'jail/opt/ivle', dry)
 
574
    action_copylist(install_list.list_console, 'jail/opt/ivle', dry)
726
575
    copy_os_files_jail(dry)
727
576
    # Chmod the python console
728
 
    action_chmod_x('jail/opt/ivle/scripts/python-console', dry)
729
 
    action_chmod_x('jail/opt/ivle/scripts/fileservice', dry)
 
577
    action_chmod_x('jail/opt/ivle/console/python-console', dry)
730
578
    
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
736
 
    # password).
737
 
    # The "safe" version is in jailconf.py. Delete conf.py and replace it with
738
 
    # jailconf.py.
739
 
    action_copyfile('lib/conf/jailconf.py',
740
 
        'jail/opt/ivle/lib/conf/conf.py', dry)
741
579
 
742
580
    # Compile .py files into .pyc or .pyo files
743
581
    compileall.compile_dir('www', 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)
747
 
 
748
 
    # Set up ivle.pth inside the jail
749
 
    # Need to set /opt/ivle/lib to be on the import path
750
 
    ivle_pth = \
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')
754
 
    f.close()
 
582
    compileall.compile_dir('console', quiet=True)
755
583
 
756
584
    return 0
757
585
 
774
602
 
775
603
def install(args):
776
604
    # Get "dry" and "nojail" variables from command line
777
 
    (opts, args) = getopt.gnu_getopt(args, "n",
778
 
        ['dry', 'nojail', 'nosubjects'])
 
605
    (opts, args) = getopt.gnu_getopt(args, "n", ['dry', 'nojail'])
779
606
    opts = dict(opts)
780
607
    dry = '-n' in opts or '--dry' in opts
781
608
    nojail = '--nojail' in opts
782
 
    nosubjects = '--nosubjects' in opts
783
609
 
784
610
    if dry:
785
611
        print "Dry run (no actions will be executed\n"
799
625
    # chown trampoline to root and set setuid bit
800
626
    action_chown_setuid(tramppath, dry)
801
627
 
802
 
    # Copy the www and lib directories using the list
 
628
    # Copy the www directory using the list
803
629
    action_copylist(install_list.list_www, ivle_install_dir, dry)
804
 
    action_copylist(install_list.list_lib, ivle_install_dir, dry)
805
630
 
806
631
    if not nojail:
807
632
        # Copy the local jail directory built by the build action
808
633
        # to the jails template directory (it will be used as a template
809
634
        # for all the students' jails).
810
635
        action_copytree('jail', os.path.join(jail_base, 'template'), dry)
811
 
    if not nosubjects:
812
 
        # Copy the subjects and problems directories across
813
 
        action_copylist(install_list.list_subjects, subjects_base, dry,
814
 
            srcdir="./subjects")
815
 
        action_copylist(install_list.list_problems, problems_base, dry,
816
 
            srcdir="./problems")
817
636
 
818
637
    # Append IVLE path to ivle.pth in python site packages
819
638
    # (Unless it's already there)
820
639
    ivle_pth = os.path.join(sys.prefix,
821
 
        "lib/python%s/site-packages/ivle.pth" % PYTHON_VERSION)
 
640
        "lib/python2.5/site-packages/ivle.pth")
822
641
    ivle_www = os.path.join(ivle_install_dir, "www")
823
 
    ivle_lib = os.path.join(ivle_install_dir, "lib")
824
642
    write_ivle_pth = True
825
 
    write_ivle_lib_pth = True
826
643
    try:
827
644
        file = open(ivle_pth, 'r')
828
645
        for line in file:
829
646
            if line.strip() == ivle_www:
830
647
                write_ivle_pth = False
831
 
            elif line.strip() == ivle_lib:
832
 
                write_ivle_lib_pth = False
833
 
        file.close()
 
648
                break
834
649
    except (IOError, OSError):
835
650
        pass
836
651
    if write_ivle_pth:
837
652
        action_append(ivle_pth, ivle_www)
838
 
    if write_ivle_lib_pth:
839
 
        action_append(ivle_pth, ivle_lib)
840
653
 
841
654
    return 0
842
655
 
904
717
    if ret != 0:
905
718
        raise RunError(prog, ret)
906
719
 
907
 
def action_remove(path, dry):
908
 
    """Calls rmtree, deleting the target file if it exists."""
909
 
    try:
910
 
        print "rm -r", path
911
 
        if not dry:
912
 
            shutil.rmtree(path, True)
913
 
    except OSError, (err, msg):
914
 
        if err != errno.EEXIST:
915
 
            raise
916
 
        # Otherwise, didn't exist, so we don't care
917
 
 
918
720
def action_rename(src, dst, dry):
919
721
    """Calls rename. Deletes the target if it already exists."""
920
 
    action_remove(dst, dry)
 
722
    if os.access(dst, os.F_OK):
 
723
        print "rm -r", dst
 
724
        if not dry:
 
725
            shutil.rmtree(dst, True)
921
726
    print "mv ", src, dst
922
727
    if dry: return
923
728
    try:
943
748
    directories as necessary.
944
749
 
945
750
    See shutil.copytree."""
946
 
    action_remove(dst, dry)
 
751
    if os.access(dst, os.F_OK):
 
752
        print "rm -r", dst
 
753
        if not dry:
 
754
            shutil.rmtree(dst, True)
947
755
    print "cp -r", src, dst
948
756
    if dry: return
949
757
    shutil.copytree(src, dst, True)
952
760
    """Hard-links an entire directory tree. Same as copytree but the created
953
761
    files are hard-links not actual copies. Removes the existing destination.
954
762
    """
955
 
    action_remove(dst, dry)
 
763
    if os.access(dst, os.F_OK):
 
764
        print "rm -r", dst
 
765
        if not dry:
 
766
            shutil.rmtree(dst, True)
956
767
    print "<cp with hardlinks> -r", src, dst
957
768
    if dry: return
958
769
    common.makeuser.linktree(src, dst)
959
770
 
960
 
def action_copylist(srclist, dst, dry, srcdir="."):
 
771
def action_copylist(srclist, dst, dry):
961
772
    """Copies all files in a list to a new location. The files in the list
962
773
    are read relative to the current directory, and their destinations are the
963
774
    same paths relative to dst. Creates all parent directories as necessary.
964
 
    srcdir is "." by default, can be overridden.
965
775
    """
966
776
    for srcfile in srclist:
967
777
        dstfile = os.path.join(dst, srcfile)
968
 
        srcfile = os.path.join(srcdir, srcfile)
969
778
        dstdir = os.path.split(dstfile)[0]
970
779
        if not os.path.isdir(dstdir):
971
780
            action_mkdir(dstdir, dry)
980
789
def action_copyfile(src, dst, dry):
981
790
    """Copies one file to a new location. Creates all parent directories
982
791
    as necessary.
983
 
    Warn if file not found.
984
792
    """
985
793
    dstdir = os.path.split(dst)[0]
986
794
    if not os.path.isdir(dstdir):
990
798
        try:
991
799
            shutil.copyfile(src, dst)
992
800
            shutil.copymode(src, dst)
993
 
        except (shutil.Error, IOError), e:
994
 
            print "Warning: " + str(e)
 
801
        except shutil.Error:
 
802
            pass
995
803
 
996
804
def action_symlink(src, dst, dry):
997
805
    """Creates a symlink in a given location. Creates all parent directories
1027
835
            | stat.S_ISUID | stat.S_IRUSR | stat.S_IWUSR)
1028
836
 
1029
837
def action_chmod_x(file, dry):
1030
 
    """Chmod 755 a file (sets permissions to rwxr-xr-x)."""
1031
 
    print "chmod 755", file
 
838
    """Chmod +xs a file (sets execute permission)."""
 
839
    print "chmod u+rwx", file
1032
840
    if not dry:
1033
 
        os.chmod(file, stat.S_IXUSR | stat.S_IRUSR | stat.S_IWUSR
1034
 
            | stat.S_IXGRP | stat.S_IRGRP | stat.S_IXOTH | stat.S_IROTH)
 
841
        os.chmod(file, stat.S_IXUSR | stat.S_IRUSR | stat.S_IWUSR)
1035
842
 
1036
843
def query_user(default, prompt):
1037
844
    """Prompts the user for a string, which is read from a line of stdin.