Skip to content

Development Environment

Jump to bottom Edit New page
mdutoo edited this page Mar 1, 2012 · 52 revisions

For complete distribution instructions, see Releasing EasySOA.

The current page gives details about how to set up your development environment.

System dependencies

In short (details below) :

  • Required : Oracle's JDK 6, Maven, node.js, git, openssh (for git), ruby (for buildr, only required to distribute EasySOA)
  • Optional : vim (for conf files, or any other shell editor), wget (for HTTP tests), gcc/make/automake/autoconf/python (if you choose to build node.js)

How to get them

  • On Linux : get them using your favorite package manager
  • Windows : install Cygwin by getting it from http://www.cygwin.com/install.html and executing setup.exe, and configure it with said dependencies

git

In order to learn how to set up Git, see: http://help.github.com/set-up-git-redirect

If you don't have one, you need to generate your ssh identity.

Linux :

ssh-keygen -t dsa

Windows (in the cygwin shell):

ssh-user-config

And copy the generated .ssh/ files to your home, and there in ssh/ because eclipse needs it, see http://www.slideshare.net/loianeg/using-the-egit-eclipse-plugin-with-git-hub-2578587

More at http://inside.mines.edu/~gmurray/HowTo/sshNotes.html

Java

Install JDK 6 : either

sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner"
sudo apt-get update
sudo apt-get install sun-java6-jdk
sudo update-alternatives --config java
  • or download it from Oracle,
  • setup the JAVA_HOME environment
  • and twice in Eclipse : Preferences > default JDK, AND in Eclipse Maven : default

node.js

Linux :

  • get and build it (requires gcc, autoconf, automake, python)

do :

git clone --depth 1 https://github.com/joyent/node.git  
./configure  
make  
sudo make install
  • OR install it as packages

Windows : Official binaries are available from the [official website]

Maven

(to build frascati and nuxeo)

(requires Java)

get and install the latest Maven 2.x

  • including setup of MAVEN_HOME and PATH
  • if running it from Eclipse, configure it in Eclipse as an "external installation" of Maven
  • tested on maven 2.2.1

buildr

(to build the release)

on linux, install rubygems using your favorite package manager, then do

gem install buildr

on windows (using cygwin with wget, ruby) in the cygwin shell, do

wget http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz  
tar xfz rubygems-1.3.1.tgz ; cd rubygems*  
ruby setup.rb  
gem install buildr

more at http://buildr.apache.org/installing.html

Tools

Your favorite code editor or IDE, such as :

Eclipse

Get Eclipse for Java, Classic or EE (at least check you have the XML editors) and the plugins for :

  • Maven. To configure it, in Window > Preferences, add under Java > Build Path > Classpath Variables a new one named M2_REPO and pointing at your maven repository (typically $HOME/.m2/reository). FAQ : for Frascati, remember to configure it to use your external Maven 2 installation.
  • EGit : great for visual comparison, BUT more complicated to use than the shell (especially with github upstreams), and not as stable (UI bugs). More at http://www.vogella.de/articles/EGit/article.html
  • SVN (to work with the development version of Frascati)
  • Node : The "Chrome Developer Tools" provides useful debugging features for Node. A full setup tutorial is available on the node wiki.

Others

Netbeans, vim, emacs, notepad++...

Your favorite web browser, such as :

Firefox

with a few useful plugins :

Others

To help test services :

  • soapui
  • wget --post-data='a=b' url

Conclusion

Once done, the PATH env var should look like :

  • on windows : %SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;C:\dev\easysoa\node-0.4.7-i686-pc-cygwin\bin;C:\Program Files\Java\jdk1.6.0_14\bin;C:\dev\easysoa\apache-maven-2.2.1\bin
Add a custom footer
Add a custom sidebar
Clone this wiki locally