Development:JABAWS:GettingStarted
From Jalview Wiki
Revision as of 23:24, 27 April 2014 by Asherstnev (Talk | contribs)
Here's a work in progress concerning how to get a working development version of JABA on your own machine.
The first steps are:
- Sign up at issues.jalview.org.
- This login (your dev credentials) is also used for the JABAWS, Jalview and ProteoCache source repositories, and also the Jalview wiki.
- Take a look at the general coding guidelines on the Development page.
- Get set up with eclipse.
- I use a third party eclipse system called 'Yoxos' - see Development:Yoxos to set this up.
- a standard Eclipse pack for "Java EE Developers" may also be used (see details at [[1]])
- Install and add to Eclipse the last Java 6 JDK.
- Install and configure Apache Tomcat
- it is safer to use the last Tomcat 7 version, we haven't tested JABAWS with Tomcat 8.x yet...
- Create a new Tomcat instance in Eclipse (there is a standard Eclipse interface for that)
- Get your JABAWS development environment set up.
- Make sure you have a full installation of Apache Tomcat7 on your machine.
- In Eclipse, you'll need to add a link to your tomcat7 installation in the 'Runtimes' section of the Servers preferences tab.
- Checkout the JABAWS code and import the project to eclipse.
- i. clone the jabaws repository to somewhere on your laptop (~/git/ is always a good place to store git repos!)
- git clone https://source.jalview.org/git/jabaws.git # you will need your dev credentials for this. Currently the repository is ~1.3Gb, so this will take some time
- ii. switch to the develop branch, which includes the latest version of JABAWS (we'll release this as JABAWS 2.1).
- cd jabaws
- git checkout develop
- iii. Import the project to eclipse
- Use eclipse's File->Import dialog to select the 'Import projects from git repository' wizard, and point it at your local version of the JABAWS repository. Import the project called 'clustengine'
- iv. Try to run the project to launch a jabaws development server
- In principle, you'll then be able to right-click on the new clustengine project and select 'Run -> Run on Server' to get JABAWS running on a local tomcat instance. However, you'll almost certainly need to fix some paths.
- Further reading: there are details on the jabaws-dev server that give some more {{http://www.compbio.dundee.ac.uk/jabaws-dev/man_server_dev.html background about jabaws development}.