Table of Contents
Marmoset has two major components: the SubmitServer is a Java based web application that supports the efforts of instructors and students, and the BuildServer is the backend process that compiles submissions and tests them against a corresponding test setup. SubmitServer should be installed on one machine that can be access via http(s), while BuildServers can be installed on multiple machines. Both applications can also be installed on the same machine.
Other optional Marmoset components including a submission plugin for the Eclipse IDE and a command-line submission utility are available from the University of Maryland.
Table 2.1. Parts of the Marmoset Distribution
| Files/Folders | Description |
|---|---|
| SubmitServer.jar |
Source for the SubmitServer component. The contents of
this archive will be referred to in this manual as the
SubmitServer Module.
This module is also available for checkout from a
University of Maryland CVS repository.
|
| BuildServer.jar |
Source for the BuildServer component. The contents of
this archive will be referred to in this manual as the
BuildServer Module.
This module is also available for checkout from a
University of Maryland CVS repository.
|
| SubmitServerModelClasses.jar |
Source for SubmitServer utility classes and database
interaction components. This package is used in both
the SubmitServer and the BuildServer installations.
The contents of this archive will be referred to in
this manual as the
SubmitServerModelClasses Module.
This module is also available for checkout from a
University of Maryland CVS repository.
|
| doc/ | Directory containing this help manual and any other documentation. The entire doc will also be available through the submit server once it is installed. |
| doc/samples/ | Directory containing sample configuration and archive files useful to administrators and instructors. |
| examples/ | Directory containing source for some sample Java and C projects. |
Marmoset was designed for use on Linux machines and has not been tested on Windows, Mac, or Unix OS. For more info, please contact the engineers by email: submit-help [at] cs.umd.edu.
Other software requirements are:
JDK 1.5 (a.k.a. 5.0) or later ( Download Java ).
Ant 1.6 or later ( Download Ant )
-
MySQL 4.1.16 or later (
Download MySQL
). Section 3, “Installing MySQL and the database for Marmoset” will describe the MySQL installation process.
Marmoset has been tested successfully using mysql-standard-4.1.16-pc-linux-gnu-i686-glibc23 and mysql-standard-5.0.22-linux-i686-glibc23.
Jakarta Tomcat 5.5.9 or later ( Download Tomcat ). Section 5, “Installing Jakarta Tomcat” will describe the Tomcat installation and configuration process.
![[Note]](note.png)
Note When configuring Tomcat to use SSL with a self-signed certificate, you will need write access to some parts of your Java (JRE) installation. See Section 5.3, “Configuring SSL” for more information. - Perl 5 or later ( Download Perl )
The next two sections describe the installation process for the SubmitServer ( Part II, “SubmitServer Installation” ) and the BuildServer ( Part III, “BuildServer Installation” ) respectively. The next section describes how to configure and use SubmitServer to manage courses and projects ( Part IV, “SubmitServer Users Guide” ).
| Note |
|---|---|
| SubmitServer and BuildServer can be installed and run independently. However, if your goal is to create projects with submissions that are compiled and tested by the BuildServer, you should install the SubmitServer first and then install one or more BuildServers to connect to this SubmitServer. |