Eclipse Setup Instructions

NOTE - these instructions are a work in progress so please ask question and/or provide feedback on how to improve them.

First, download the latest version of Eclipse (from http://www.eclipse.org/downloads/) and install it.

Create a directory to store your Eclipse projects in.

When you launch Eclipse for the first time, it will ask you to specify the workspace. Navigate to and choose the directory you just created.

CVS checkout of jQuake project from the Eclipse

Note : User needs to have an account on scecdata.usc.edu to get connected to OpenSHA source code in CVS.

Step-1) Select "Import" option from the "File" menu option.

Step-2) Select "Checkout Projects from CVS" , click the "Next >" button.

Step-3) Enter the following repository location information in the window.

Host: scecdata.usc.edu

Repository path: /home/cvs/

User: your username on the account created on scecdata.usc.edu

Password: user's password on scecdata.usc.edu

Connection type: extssh

Keep the "Use default port" option selected and click on "save password" so you won't have to enter the password every time a connection is being made to the repository to commit or update the project.

Then click on the "Next >" button.

Step-4) Window will prompt the user to select the module to check out. Select the option "Use an existing module (this will allow you to browse the modules in the repository)". This will list all the modules on the cvs server. Scroll down the options and select "jQuake" from the list of modules.

Click on "Next >" button.

Step-5) Window will prompt user to specify the name of the project on user's local machine. By default it is the same as the name of the module being checked out of cvs ("jQuake").

Click on the "Next >" button.

Step-6) Keep everything default in this window (it updates user with the location in which project will be checkout from cvs).

Click on the "Next >" button.

Step-7) A window with the label "Select Tag" pops up. Keep everything default and click on the "Finish" button.

It will checkout the project from the CVS server and list the java source files in the "Navigator" window.

Double-Click on any of the source files to view it in the editor window on the right side.

Updating the project properties

Step-1) Select "Properties" from the "Project" menu option in Eclipse. Select "Java Build Path" from the various options displayed on the left-side of the window.

Step-2) Select the "Source" tab in the window displayed on the right side. The "Default output folder" listed at the bottom should say "jQuake/classes". If it says something else, change it to "jQuake/classes".

Step-3) Now when you click on the "Libraries" tab, do you see list of jar files in area below it.

Step-4) If you scroll to the bottom of the library list you will see "JRE System Library". This is where you can change the JVM if desired (by selecting it and clicking "Edit"). Otherwise use the default.

Step-5) Click the "Order and Exports" tab and see if all the library files are selected.

Click "OK" and the project should compile automatically.

Adding the RMI Plugin for Eclipse

Note: Only need to do it if user wants to run the OpenSHA server based applications from the Eclipse environment.

Go to the website http://www.genady.net/rmi and download the latest version of the plugin and follow the installation instructions for "Installing from scratch".

If you face any problems (which is likely) please contact us.