Configuring Tie In Programs

It is possible to configure Submitty to use various third party programs to run student code. This page details any special configuration steps necessary to set up such programs.

Matlab

Executing Matlab scripts necessitates one or more Matlab installation keys (one per Matlab assignment you want to grade in parallel.)

RPI Developers

Getting a key from RPI

Navigate to the Division of the Chief Information Officer webpage.
Launch the Software Licensing Tool.
Login using your RCS ID and password.
Select Student_Matlab
Request a License.

Acquiring Necessary Files

If you don’t have a MathWorks account, create one.
After getting access to your matlab installation, download it as a zip file.
Unpack the zip somewhere safe on your submitty installation.
Go to your MathWorks Account and login.
Select your license.
Navigate to the “Install and Activate” page.
On the right beneath related tasks, select “Activate to retrieve license file.”
Next, select activate a computer, and follow the steps to activate your machine.
NOTE: make sure that your computer login name matches the name of the user you want to have access to matlab. (eg. at RPI, use untrusted00)
Select “Get License File” from the activated computers list. Answer that the software is not installed and then continue.
Download Your license file and put it in a safe place on your Submitty installation.
Copy your file installation key. You will need it in the next step.

Semi-Automated Install

Navigate to /usr/local/submitty/GIT_CHECKOUT/Submitty/.setup/bin/
Open MatlabInstall.sh with your favorite text editor.
Set the ABSOLUTE_PATH_TO_INSTALLATION_FILES variable to which you moved the files in step 3 above.
Set the INSTALLATION_KEY variable to be equal to the key you copied in step 11 above.
Add the path to the license file you downloaded in step 10 above to the PATHS_TO_LICENSE_FILES array.
Execute the script as root.
To ensure that the script installed correctly, su to the user to which the license belongs (step 8 above) and execute “matlab” in the terminal.

Running Matlab Programs

Matlab applications should be treated as Java programs and the associated RLIMITS should be set. Ex.

"resource_limits" : {
   "RLIMIT_NOFILE" :     1000000, //number of file descriptors
   "RLIMIT_LOCKS" :      1000000,  //number of files open
   "RLIMIT_CPU" : 60,
   "RLIMIT_NPROC" : 100,
   "RLIMIT_AS" : "RLIM_INFINITY"
  },
  "autograding" : {
   "submission_to_runner" : [ "*.m"],
   "work_to_details" : ["*.png"]
  },
  "allow_system_calls" : [
     "ALLOW_SYSTEM_CALL_CATEGORY_COMMUNICATIONS_AND_NETWORKING_INTERPROCESS_COMMUNICATION",
     "ALLOW_SYSTEM_CALL_CATEGORY_COMMUNICATIONS_AND_NETWORKING_SIGNALS",
     "ALLOW_SYSTEM_CALL_CATEGORY_FILE_MANAGEMENT_MOVE_DELETE_RENAME_FILE_DIRECTORY",
     "ALLOW_SYSTEM_CALL_CATEGORY_FILE_MANAGEMENT_RARE",
     "ALLOW_SYSTEM_CALL_CATEGORY_PROCESS_CONTROL_NEW_PROCESS_THREAD",
     "ALLOW_SYSTEM_CALL_CATEGORY_PROCESS_CONTROL_SCHEDULING",
     "ALLOW_SYSTEM_CALL_CATEGORY_UNKNOWN"
 ],

Developer > Development Instructions > Advanced Development