15-440 - Distributed Systems

Home Syllabus Schedule Lectures Assignments Projects Exams Resources

Project 1: Remote File Storage and Access Kit (File Stack) using Sockets and Remote Method Invocation

Design Report Due Date: 13 Sep 2014, by 11:59pm

Some Guidelines for Your Design Report: PDF file

Final Project Due Date: 1 Oct 2014, by 11:59pm

Submit your design report and code using the AFS file system: /afs/qatar.cmu.edu/usr10/mhhammou/www/15440-f14/handin/project1/userid/, where userid is your andrew id

• Project description can be found in Project 1 Handout
• Rubrics can be found in Ruberics-PDF
• Download Project 1 Starter Code. This is the framework that you will be modifying. Unzip the file. Read the README document. For the complete documentation of the framework, read the following (preferably in the same order)
  • The README file under the project archive.
  • The Implementation section in the project handout.
  • The javadoc of the starter code. Note: make docs-all command creates javadoc of starter code.

Importing code to Eclipse

• Open P1_StarterCode and delete all .class files under all sub-directories. You can do this manually or from the command-line, cd to P1_StarterCode and type make clean.
• Open Eclipse and create a new Java Project (File -> New -> Java Project). Name the project as Project 1.
• Under Project 1, right click on src and select Import -> File System -> Browse. Browse to P1_StarterCode and click Ok.
• Check the checkbox next to P1_StarterCode in the left pane and click Finish.
• You'll notice that the class SampleUnitTest.java contains an error (undefined class SampleClassUnderTest). This class does not actually exist, it just demonstrates how you can write unit tests. Therefore, just comment out all the lines that contain errors.
• Now you should be able to run ConformanceTests.java under the Conformance package. Of course, you wont pass any of the tests because you haven't implemented anything yet!!

Apps -- New feature to test your code

The "apps" package allows command-line access to the distributed file operations in FileStack. Apps package - with little changes to your existing project 1 code - allows you to utilize the apps package for easily accessing distributed files that are managed by your own FileStack implementation.
Now using simple commands on the shell you can:

• Read, write and copy files
• Start the name server and storage servers
• Change a directory and list contents of a directory

The P1_StarterCode_AppsAddon.zip includes the apps package. Follow the below instructions to use the apps features:

• Backup your existing project 1 code
• cd to your project 1 code directory
• Download the file P1_StarterCode_AppsAddon.zip
• Delete apps directory
• Unzip P1_StarterCode_AppsAddon.zip in your current directory
• Read the file README.apps file before using the apps module