Difference between revisions of "Development:JABAWS:GettingStarted"
From Jalview Wiki
Asherstnev (Talk | contribs) |
Asherstnev (Talk | contribs) |
||
| Line 5: | Line 5: | ||
# Sign up at issues.jalview.org. | # Sign up at issues.jalview.org. | ||
| − | #* This login is also used for the | + | #* 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. | # Take a look at the general coding guidelines on the [[Development]] page. | ||
# Get set up with eclipse. | # Get set up with eclipse. | ||
Revision as of 22:14, 27 April 2014
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.
- 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 principal, 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}.
