Submitting an Assignment from Your Windows Computer at Home

To submit your assignment from home, you will first need to copy your files from your home machine to the GAUL network. Once you have done so, you will remotely connect to GAUL from your home computer via SSH, and execute a command to submit your assignment for marking.

Section 0: Prerequisites

Before completing this tutorial, make sure you have first completed the following tutorials:

Section 1: Copying Your Source Code Files to GAUL

  1. Start WinSCP by selecting Start > All Programs > WinSCP > WinSCP. If you do not have WinSCP installed, please see Installing and Configuring WinSCP.
  2. In the Stored sessions pane, select the profile you created in the Installing and Configuring WinSCP tutorial, and click Login.

  3. If this is the first time you are connecting to GAUL from WinSCP, you will receive a warning concerning the server's host key. This is normal, and you should click Yes.

  4. When prompted, enter your GAUL password, and click OK. You should have received your password via email when you took your first Computer Science course. Click here if you do not remember your password or are having difficulty logging in. If problems persist, fill out a problem report to notify the Systems Group of your account issues.

  5. Once logged in, the WinSCP window will appear similar to that shown below. In the left pane, files and directories on your local computer are displayed. In the right pane, the files and directories in your home directory on GAUL are displayed.

  6. To find your assignment directory on your computer, click the Open Directory icon in the toolbar above the local pane (left pane). This directory is highlighted in red below.

  7. In the Open Directory field, enter the path to the directory containing your assignment source code files, or click Browse to select this path. When finished, click OK.

  8. You should now see your assignment files in the left pane. We now wish to create a directory in your home directory on GAUL to store these files. To do this, right-click in an empty area (white space) in the right pane, and select New > Directory.

  9. In the New folder name field, enter a descriptive name for your assignment directory. Click OK.

  10. You should now see your newly-created folder in the right pane. Double click on this folder to enter it.

  11. In the left pane, select all source code files that you wish to upload.

    IMPORTANT: Upload only your source code files (.java files). To be eligible for full marks for your assignment, you should ensure that your submission directory does NOT contain any of the following:
    • .class files
    • Subdirectories, such as src or bin
    • Javadoc files (.html, .css, etc.)
    • Any files or directories other than your source code files (.java files)
    When you have selected all of your source code files, drag them to the right pane, and drop them there.

  12. In the Copy dialog that appears, click Copy to begin the transfer

  13. Your source code files should now be visible in the right pane. This means that they are now stored on the GAUL network, but they have not yet been submitted for grading. Once again, you should ensure that only source code files are listed in the right pane, and no subdirectories or other files are listed. In the next section, you will actually submit these files for marking.

Section 2: Submitting Your Assignment

In this section, you will establish an SSH connection to the primary GAUL compute server, obelix. From there, you will submit your assignment for grading.

  1. Start PuTTY by double-clicking the putty.exe file that you downloaded in the Installing and Configuring PuTTY tutorial.
  2. In the stored sessions list, double-click the profile you created in the Installing and Configuring PuTTY tutorial.

  3. If this is the first time you are connecting to GAUL from PuTTY, you will receive a security warning concerning the server's host key. This is normal, and you should click Yes.

  4. When prompted, enter your GAUL password, and press Enter. Note that, for security purposes, you will not see the password characters that you are typing. You should have received your password via email when you took your first Computer Science course. Click here if you do not remember your password or are having difficulty logging in. If problems persist, fill out a problem report to notify the Systems Group of your account issues.

  5. After logging in, you will be presented with a prompt at which you can enter commands. Each command that you enter at the prompt must be terminated by pressing Enter, which will then execute the command on the remote server.

  6. Change to the directory in which you placed your source code files in Section 1 using the cd (change directory) command. For example, if you placed your code in a directory named cs2210_asn5, then you would use the following command to change to this directory:
    cd cs2210_asn5
    
  7. Enter the command ls and press Enter to list the contents of your assignment directory. Verify that it contains only source code files, and NO subdirectories (such as src or bin), class files (.class), Javadoc files, or any other files that do not have the extension .java.

  8. Enter the following command to change to the parent directory (the directory containing your assignment directory), and press Enter:
    cd ..
    
  9. To submit your assignment, you will use the submit command. Enter submit and press Enter to display a screen describing the usage of the command.

  10. When ready to submit, enter the appropriate command to submit your assignment. For example, if you are submitting for CS 2210, and your assignment is stored in the directory cs2210_asn5, you should use the following command:
    submit cs2210 cs2210_asn5
    
    As another example, if you are submitting for CS 2211, and your assignment is stored in the directory asn4, you should use the following command:
    submit cs2211 asn4
    
  11. The output of the submit command will list the files being submitted for grading, and should include the line, "Assignment submission was completed successfully".

Section 3: Verifying Receipt of Your Assignment

This section details two ways in which you can verify that your assignment was successfully submitted for grading. Note that it is your responsibility to ensure that your assignment is properly submitted.

  1. Check your UWO email within 10-15 minutes of submitting your assignment. You should receive an email from Line Printer Admin, which lists all of the files you submitted for grading. If any files are missing, or no files are listed, you should resubmit your assignment, as discussed in the next section.

    A sample email from the Line Printer Admin is shown below. If you do not receive this email within 10-15 minutes, check your spam folder or skip to the next step for an alternative way to check that your assignment was submitted successfully.

    From:    Line Printer Admin 
    To:      You
    Subject: CS2210 Assignment Submission
    Date:    Tue, 07 Dec 2010 05:01:31 -0500 (EST)
    
    Your Submission to the cs2210 queue, received from obelix.gaul.csd.uwo.ca,
    was submitted for marking with sequence number 137 at 05:01:31 on Tue Dec 07
    2010. You appear to have handed in an unknown file. (Probably as a tar
    archive.)
    
    Keep this message; it is your receipt.
    
    Please be advised that you can now check your submissions on line at
    http://www.csd.uwo.ca/undergrad/Courses/ereceipt.shtml
    
    We believe you handed in the following files in a tarball:
        drwx------ 14647/2002      0 Dec  7 01:59 2010 cs2210_asn5/
        -rw------- 14647/2002    253 Dec  7 01:55 2010 cs2210_asn5/GraphException.java
        -rw------- 14647/2002    196 Dec  7 01:55 2010 cs2210_asn5/Board.java
        -rw------- 14647/2002  17683 Dec  7 01:55 2010 cs2210_asn5/DrawMap.java
        -rw------- 14647/2002    863 Dec  7 01:55 2010 cs2210_asn5/Edge.java
        -rw------- 14647/2002   1497 Dec  7 01:55 2010 cs2210_asn5/GraphADT.java
        -rw------- 14647/2002   6144 Dec  7 01:55 2010 cs2210_asn5/TestGraph.java
        -rw------- 14647/2002   9253 Dec  7 01:55 2010 cs2210_asn5/Map.java
        -rw------- 14647/2002    249 Dec  7 01:55 2010 cs2210_asn5/MapException.java
        -rw------- 14647/2002   3270 Dec  7 01:55 2010 cs2210_asn5/Graph.java
        -rw------- 14647/2002   1411 Dec  7 01:55 2010 cs2210_asn5/Solve.java
        -rw------- 14647/2002    563 Dec  7 01:55 2010 cs2210_asn5/Node.java
    

  2. Visit http://www.csd.uwo.ca/undergrad/Courses/ereceipt.shtml. When prompted, select the course for which you submitted your assignment, enter your GAUL username (do not include @uwo.ca), and click Press this Button.

  3. You will be presented with a list of all submissions you have made in the current term to the course you selected. The submission with the highest sequence number (and most recent date/time) is the most recent submission from you that the system has in its records. Click its sequence number to view the contents of the submission.

  4. Be sure to examine the contents of the submission carefully. The name of your assignment directory will be listed at the top of the contents list, with a list of all source code files submitted below. Ensure that all your source code files listed, and that no other files (e.g. .class, .html, .css) or directories (e.g. src, bin) are listed. If there are any problems with the submission, simply resubmit your assignment, as discussed in the next section.

    Notes from the Systems Group:
    • If no files are shown in the list below, then your submission failed and you should resubmit the assignment.
    • If you are told that it could not find anything, then your submission has been removed from the system for some reason and you should resubmit the assignment.
    • If you get a tar: blocksize = something message, then your submission failed and you should resubmit it.
    • If you get a permission denied error message, please check again in about 15 minutes.
    • If the list of submitted files shows all of the files you have ever submitted, you will need to compare date stamps to be sure that this submission worked.

Section 4: Resubmitting Your Assignment

If you need to resubmit your assignment for any reason, simply follow the steps in Section 2 and submit your assignment again.

IMPORTANT NOTES:

  • The last (most recent) submission will be the one that is graded.
  • If you resubmit after the assignment deadline, late penalties will apply as usual.