InstallationManual

#summary Installation Manual

=INSTALLATION MANUAL=

==1.Install Java JDK6==

===Windows===

Download and install Java JDK 6. http://www.oracle.com/technetwork/java/javase/downloads/index.html

Set 'JAVA_HOME' environment variable to point to installation directory.

Add '%JAVA_HOME%\bin' to 'path' environment variable.

===Ubuntu===

Uninstall Open JDK if it's installed in your system.

Download and install Java JDK 6. http://www.oracle.com/technetwork/java/javase/downloads/index.html

Add this location to the path by modifying '.bashrc' file located in your home folder. For example, the following lines could be added to '.bashrc' file:

{{{ export JAVA_HOME= //EXAMPLE: export JAVA_HOME=/home/username/JAVA/jdk1.6.0_23 export PATH=$JAVA_HOME/bin:$PATH }}}

==2.Install Maven==

===Windows===

Download the last version of Maven2.

Unzip it in the location where you want to have it installed.

Modify the path by adding the location of the bin directory located inside the unzipped folder. For example: C:\Program Files\apache-maven-3.0.3\bin.

Test Maven2 runs correctly by writing 'mvn' in the console.

===Ubuntu=== Go to Synaptics Package Manager and install maven2.

TODO it could be any version of maven, we recommend the newest one.

==3.Install Eclipse and proper plugins==

Download and install Eclipse Classic: http://www.eclipse.org/downloads/

Set in .ini file in eclipse folder, the launching option

  {{{
   -vm
   C:/...path_to_java_jdk.../bin
  }}}

Install Subclipse plugin: http://subclipse.tigris.org/

Install m2eclipse plugin: http://m2eclipse.sonatype.org/

==4.Prepare the project and install dependencies==

Download Shanks project from svn

 {{{
 https://shanks-with-mason.googlecode.com/svn/trunk/
 }}}

Execute Maven Install over the whole project of Shanks.

---

== Annex:Issues == === 1. Dependency problem detected === SHANKS use MASON as the simulation engine, and MASON use Java3D for graphical representation. In SHANKS development we have found that some Java builds do not bring Java3D installed. To access all SHANKS functionalities we suggest that you check that Java3D is properly installed in your local JRE. To do this you must perform two checks.

You should check that the location %JAVA_HOME%/jre/lib contains the following libraries (There may be contained on one of the folders in that location):

• j3dcore.jar
• j3dutils.jar
• vecmath.jar

You should check that the location %JAVA_HOME%/jre/bin contains the following files.

• j3dcore-ogl.dll
• j3dcore-ogl-cg.dll
• j3dcore-ogl-chk.dll
• j3dcore-d3d.dll If it is not properly configured you should find and install the appropriate version of Java3D for the JRE installed on your PC.