= Getting Started with OpenSHA Development =
[[PageOutline]]

Two options are available to obtain the OpenSHA source code:

=== 1) Download Eclipse ===

The latest version of Eclipse can be obtained from [http://www.eclipse.org/downloads/ The Eclipse Website]

The "Eclipse IDE for Java Developers" should be fine, however the Enterprise Edition (EE) will work as well.
[[BR]][[BR]]

=== 2) Install the Subversion (SVN) Plug-in ===

The Eclipse SVN Plug in is called "Subclipse".

To install in Eclipse, follow the tutorial here: [http://subclipse.tigris.org/servlets/ProjectProcess?pageID=p4wYuA Subclipse Installation]

(be sure to use `http://subclipse.tigris.org/update_1.6.x` as the update site when prompted)
[[BR]][[BR]]

=== 3) Add the OpenSHA Source Repository ===

Once Subclipse is properly installed, from within eclipse:
        * Select ''`Window > Open Perspective > Other`''.
 * Select ''`SVN Repository Exploring`'' and hit ''`OK`''.

The ''`SVN Repository`'' tab should now be visible:
 * Click the ''`Add SVN Repository`'' button shown here...
[[Image(http://intensity.usc.edu/trac/opensha/attachment/wiki/SettingUpEclipse/svn_add_repo_button.png?format=raw)]]

 * Enter `http://intensity.usc.edu/svn/opensha` as the ''`URL`'' and hit ''`Finish`''.
 * Enter your ''`username`'' and ''`password`''.

=== 4) Check out the OpenSHA Project ===

 * Click the arrow to expand the repository tree.
 * Right click on ''`trunk`'' and select ''`Checkout...`'':
[[Image(http://intensity.usc.edu/trac/opensha/attachment/wiki/SettingUpEclipse/svn_checkout.png?format=raw)]]

 * If you are happy with the default options (they are fine for most people), just click ''`Finish`''.
   * If you would like to specify where to put your "Working Copy" of the project, click ''`Next`'' instead.
 * Be patient, it may take a little while to check out the entire project the first time.
 * Once it is checked out, switch to the Java perspective  ''`Window > Open Perspective > Java`'' (or ''`Other`'', then ''`Java`'').
 * More patience, it will probably take a little while to build the project as well (you should see ''`Building Workspace`'' in the lower right corner of the Eclipse window.