Menu ▾ ▴

Developer Tools Setup

Matt MacIntyre
Attachments

Here's a quick, rough guide on how to setup all the tools needed to be productive when working with The Periwinkle Project:

Java JDK

Since it's a java-based project, havng a Java Development Kit is required. Download and install the latest in the Java SE 6 series from here: http://www.oracle.com/technetwork/java/javase/downloads/index.html

Other JDK implementations may work as well, but have not been tested at this time.

Eclipse Indigo

Download and unpack Eclipse Indigo from here: http://www.eclipse.org/downloads/. Be sure to get the Eclipse IDE for Java EE Developers package.

Before starting Eclipse for the first time, make sure that the %JAVA_HOME%\bin or $JAVA_HOME/bin directory is in your PATH so that Eclipse will startup. And make sure JAVA_HOME is set to where the JDK you installed is at.

JBoss AS 7

Download and unpack the latest JBoss AS 7 release from here: http://www.jboss.org/jbossas/downloads/. Be sure to get the Everything (NOT Java EE6 Certified) package

JBoss Tools

Next, let's get JBoss Tools 3.3.X installed. We need to use the milestone version because the previous stable releases do not have support for JBoss AS 7. The easiest way to do this is through the Eclipse software update. To get it, do the following:

  • Start Eclipse.
  • In the menus, go to: Help -> Install New Software...
  • Press the Add button to add a new repository. Give it a name, and use URL http://download.jboss.org/jbosstools/updates/development/indigo/
  • When the list of entries is populated, select the following categories:
    • Maven Support
    • Web and Java EE Development
  • Press Next. The wizard will determine other dependencies to add.
  • Press Next. Accept the license agreements to continue.
  • Press Finish, and it will download and install the packages.
  • If you are prompted about installing software with unsigned content, say yes to continue.
  • When prompted, press "Restart Now" to start Eclipse with the new items installed.

EGit

Next, get EGit installed. Again, use the Eclipse Update Manager:

  • Start Eclipse.
  • In the menus, go to: Help -> Install New Software...
  • Press the Add button to add a new repository. Give it a name, and use URL http://download.eclipse.org/egit/updates
  • When the list of entries is populated, select the following entries:
    • Eclipse Git Team Provider - this is the core functionality for EGit
    • Eclipse JGit Feature - this is needed to make it work with Java projects
  • Press Next. The wizard will determine other dependencies to add, if any.
  • Press Next. Accept the license agreements to continue.
  • Press Finish, and it will download and install the packages.
  • When prompted, press "Restart Now" to start Eclipse with the new items installed.

Clone the Periwinkle EGit Repository

The easiest way to do this is to follow the instructions in the Eclipse Cheat Sheet. To get started, do the following:

  • Start Eclipse
  • In the menus, go to: Help -> Cheat Sheets...
  • Choose Team/Git -> Cloning a Git Repository (Press OK to continue)
  • The Cheat Sheet should appear on the right-hand side.
  • Press Click to Start and follow the steps
    • On the Source Git Repository screen, the URI to use is: ssh://USERNAME@git.code.sf.net/p/periwinkle/code
    • Replace USERNAME with your sourceforge username and enter your password
    • If you're prompted about SSH keys, answer yes to accept, and create the directories if necessary.
    • On the next screen, choose the master branch and press Next to continue.
    • Choose a place to store the repository (preferably outside of your Eclipse workspace)
    • On the last screen, do not select Push to Gerrit Code Review.
    • Press Finish

Import the Project from the Cloned Git Repository

To do this, perform the following steps:

  • Start Eclipse
  • Add the Git View. Go to Window -> Show View -> Other ... then choose Git -> Git Repositories and press OK to add it. The Git view will show up as a new tab on the right hand side.
  • The repository you added earlier should be there. Right-click on it, and choose Import Projects ...
  • In the wizard that appears, choose Import Existing Projects and select the Working directory (it might be the only entry in the list).
  • Press Finish to continue (it isn't necessary to change anything on the next screen)

Setup a JBoss Server Runtime

The easiest way to do this is to follow the instructions at the start of the JBoss AS 7 Getting Started Developing Applications Guide
. Look for the section, near the top of the page, called Starting JBoss AS from Eclipse with JBoss Tools.

To use the JBoss Tools, items are available in the Eclipse toolbar:

toolbar

Once you have created a server configuration (as per the link above), the buttons will become available for use.

Helpful Stuff

Related

Wiki: Home

MongoDB Logo MongoDB