JBoss.orgCommunity Documentation

Chapter 2. Installation

2.1. Prerequisites
2.2. Installation Instructions
2.3. Importing Samples into Eclipse

This section describes the installation procedure for SAVARA tools and runtime modules.

2.1. Prerequisites

The pre-requisites for the SAVARA Eclipse Tools are:

  1. Eclipse JEE (3.6 or higher) http://www.eclipse.org
  2. JBoss Tools (3.2 or higher) http://www.jboss.org/tools available from an update site

The pre-requisites for the SAVARA Service Validator are:

  1. JBossAS (5.1.0.GA or higher) http://www.jboss.org/jbossas
  2. JBossAS (4.8 or higher) http://www.jboss.org/jbossesb
  3. SAVARA (version 1.1.0 or higher), available from http://www.jboss.org/savara/downloads

2.2. Installation Instructions

The installation instructions for the SAVARA Eclipse tools are:

  1. Eclipse

    Download the latest version of Eclipse JEE, and install in your environment.

  2. BPMN Modeller

    When Eclipse has been lauched, go to the Help->Install New Software.. menu item. Select the Eclipse update site for the version of Eclipse (e.g. Helios). Within the SOA Development category, select the BPMN Project Feature. Follow the instructions to accept the license and then restart Eclipse after the plugins have been installed.

  3. JBoss Tools

    Start up your Eclipse environment, and go to the Help->Install New Software.. menu item. Select the appropriate update site URL from the JBoss Tools download page, and enter it into the top text field in the dialog window, and press the Add button. Once the contents of the update site is available, then select the appropriate components and follow the instructions to install them within your Eclipse environment.

    The JBoss Savara Tools feature should be selected from the SOA Development category.

    If you wish to view the generated BPEL using a BPEL editor, rather than XML, then you should also select the JBoss BPEL Editor from the SOA Development category.

    NOTE: If you don't install the BPEL Editor, then you will have to install GMF. This can be found on the Helios update site, under the Modeling category. Select the Graphical Modeling Framework entry, and following the instructions to install.

    It is also recommended that you install the JBoss WebServices Tools, and JBossAS Tools, from the All category. These are required to define and launch a JBossAS server from within Eclipse, generate a JAX-WS web service from a WSDL definition, and test a Web Service.

The installation instructions for the SAVARA Service Validator are:

  1. JBossAS

    Download the latest version and follow its installation instructions.

  2. JBossESB

    Download the latest version and follow the instructions for installing it into the JBossAS environment.

  3. SAVARA

    Unpack the SAVARA distribution and edit the deployment.properties file in this ${SAVARA}/install folder. Set the org.jboss.as.home property to the root directory where the JBossAS environment is located, and change the org.jboss.as.config property from default if you wish to start your JBossAS using a different configuration. Set the org.jboss.esb.home property to the root directory where the JBossESB environment is located.

    Start a command window and execute the command ant deploy.

2.3. Importing Samples into Eclipse

Once the SAVARA Eclipse Tool distribution has been correctly installed, if you wish to try out any of the examples then the following steps should be followed to import the relevant projects into the previously configured Eclipse environment.

  1. Select the 'Import...' menu item, associated with the popup menu on the background of the left panal (Navigator or Package depending on perspective being viewed).

  2. When the import dialog appears, select the General->ExistingProject from Workspace option and press the 'Next' button.

  3. Ensuring that the 'Select root directory' radio button is selected, press the 'Browse' button and navigate to the ${SAVARA-Tools}/samples folder, then press 'Ok'.

  4. All of the Eclipse projects contained within the ${SAVARA-Tools}/samples directory structure will be listed. Press the 'Finish' button to import them all.

    Once imported, the Eclipse navigator will list the sample projects: