JBoss Community Archive (Read Only)

SwitchYard 0.7

Installing Eclipse Tooling

Release Builds

The easiest way to get started with the SwitchYard (SY) tooling is to install the latest version of JBDS (https://devstudio.jboss.com/download/) first, then install the SY tooling from the offline installation update site.

SwitchYard 0.7 tooling requires JBDS 6.  Please make sure you add the update sites listed in step 3 before trying to install the SwitchYard plugins or the installation will fail.

Please make sure to disable Honour all XML schema locations in preferences, XML→XML Files→Validation after installation.  This will prevent erroneous XML validation errors from appearing on switchyard.xml files.

  1. Download and install the latest version of JBDS (https://devstudio.jboss.com/download/).

  2. Download a release version of the offline update site ZIP (switchyard-site-assembly) from the SwitchYard Downloads page. 

    As an alternative, you may install directly from the update site here:  http://download.jboss.org/jbosstools/updates/stable/juno/soa-tooling/switchyard/

  3. Select Window→Preferences from the main menu bar, go to Install/Update→Available Software Sites, and Add... the following sites:

    1. http://download.eclipse.org/modeling/emf/compare/updates/releases/1.3/

    2. http://download.eclipse.org/tools/orbit/downloads/drops/R20120526062928/repository/ images/author/download/attachments/61702326/add_update_site.jpg

  4. Select Help-->Install New Software... from the main menu bar.

  5. Press the Add... button to add the SwitchYard tooling software site zip. Click the Archive... button and specify the location of the downloaded zip.

    images/author/download/attachments/61702326/eclipse_installation.jpg

  6. Once the software site has been configured, SwitchYard Tools should be displayed in the list of available software.  Check the box, press Next and proceed through the rest of the wizard. (Refer to the Eclipse documentation for more information on software installation.)

  7. (When the installation is complete, you can also install the latest BPMN2 Modeler editor from Eclipse if you will be editing any BPM-related files. Repeat steps 3, 4, and 5, but specify the location of the repository as: http://download.eclipse.org/bpmn2-modeler/site/0.1.0/.)

Development Builds

Configure the following update sites in your Eclipse installation:

All of these sites need to be defined, even if you don't plan on installing any features from them as they provide dependencies required by the SwitchYard tools.

Make sure you reference the correct update site for JBoss Tools, especially if you are installing SwitchYard into an instance of Eclipse Indigo as using a newer update site (e.g. nightly) may cause platform instability.  The JBoss Tools update site listed above will work fine for Indigo based installs.

SwitchYard 0.6 and earlier require a version of m2e-wtp which is incompatible with the version used by JBT 4.0. This means SY <= 0.6 and earlier can only be installed with JBT 3.3 and SY > 0.6 can only be installed with JBT 4.0.

THE FOLLOWING IS NOT SUPPORTED, but provided for those who cannot use Juno, but want to give SwitchYard a try.  Newer, Juno based SwitchYard tools may be installed on an Indigo platform by following the instructions for installing on Indigo with the following changes: use the SwitchYard update site URL that is listed in the Juno instructions; add the following update site URL prior to installation.  Please note this will make your install incompatible with other m2e features provided by JBoss Tools and possibly other JBT features as well (i.e. this will make your Indigo install incompatible with JBoss Tools).  Here's the extra update site URL: http://download.eclipse.org/m2e-wtp/releases/

Best results may be obtained by installing the following features:

  • Eclipse IDE for Java EE Developers (required): http://www.eclipse.org/downloads/

  • SwitchYard Tooling (required):

    • SwitchYard Tools - The core tooling.

    • SwitchYard Editor - The SwitchYard configuration editor and BPMN2 modeler custom task support.

  • JBoss Tools (optional):

    • JBoss Maven Support (at a minimum, JBoss Maven Integration) - provides additional m2e support for JEE.

    • JBoss AS Tools (under Abridged JBoss Tools or JBoss Web and Java EE Development) - provides support for workspace deployment.

  • Eclipse BPMN2 Modeler (optional):

Alternate Installation

If you'd rather not install all of JBDS, you can also install the SwitchYard tooling on top of any standard Eclipse IDE for JEE distribution version 3.6 or later.  You may use another type of distribution, but you will need to figure out which features need to be installed; at a minimum you will need XML tools and JEE project facets.

Prerequisites

In addition to the basic Eclipse platform, you will also need to install m2eclipse version 1.0 or later.  (Note, for those of you using an older version of m2eclipse, this version is more tightly integrated and may require you to install additional Eclipse plug-ins to support specific Maven plug-in executions.  If you're not already using m2eclipse 1.0, you may want to use a separate Eclipse install until you are sure the latest version supports all the Maven plug-ins you are using.)  If an update site for m2eclipse is not already configured in your Eclipse install, here's the URL: http://download.eclipse.org/technology/m2e/releases/

You may also wish to install the latest version of the BPMN2 Modeler from Eclipse if you will be editing any BPMN2-related files. That update site is located here: http://download.eclipse.org/bpmn2-modeler/site/

If you decide to install using the offline update site for SwitchYard tooling, be aware you will need to also install some functionality from JBoss Tools for more Maven support. To satisfy this extra dependency, you can install just the "JBoss Maven Support" from the JBoss Tools 3.3 site - http://download.jboss.org/jbosstools/updates/stable/indigo/

Installation

  1. The SwitchYard Eclipse plug-ins may be installed by launching Eclipse and selecting Help-->Install New Software... from the main menu bar. 

  2. Press the Add... button to add the SwitchYard tooling software site:

    images/author/download/attachments/61702326/eclipse_installation.jpg

  3. Specify a name for the site (e.g. JBoss SOA Tools - Nightly).  For the location, specify http://download.jboss.org/jbosstools/updates/nightly/soa-tooling/3.3.x/

Offline Installation

For offline installation, a ZIP of the software site may be downloaded from http://hudson.jboss.org/hudson/job/SwitchYard-Tools/lastSuccessfulBuild/artifact/sources/eclipse/site/target/site_assembly.zip. Once downloaded, specify the location of the ZIP in the "Add Repository" dialog (press Archive...).

Once the software site has been configured, SwitchYard Tools should be displayed in the list of available software.  Check the box, press Next and proceed through the rest of the wizard.  (Refer to the Eclipse documentation for more information on software installation.)

JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-13 09:46:42 UTC, last content change 2013-02-14 13:58:31 UTC.