Skip to end of metadata
Go to start of metadata

Overview

The Eclipse-based tooling for SwitchYard is organized in the following feature groups:

  • SwitchYard Tools : core SwitchYard tooling support including the visual editor
  • SwitchYard BPEL Support : optional add-on to implement services using BPEL and integrates with the Eclipse BPEL editor
  • SwitchYard BPM Support : optional add-on to implement services using jBPM 6 and integrates with the Eclipse BPMN 2 modeler

The following sections cover how to install SwitchYard tooling into JBoss Developer Studio (JBDS) and Eclipse.

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.

JBoss Developer Studio

SwitchYard tooling is compatible with JBoss Developer Studio 7. If you don't have JBDS installed already, download and install it from the JBDS site (https://devstudio.jboss.com/download/).

  1. Download a release version of the offline update site ZIP (switchyard-site-assembly) from the SwitchYard Downloads page. 
  2. Open JBDS.
  3. Select Window→Preferences from the main menu bar, go to Install/Update→Available Software Sites, and Add... the following sites:
    http://download.jboss.org/jbosstools/updates/stable/kepler/integration-stack/aggregate/4.1.4.Final/
  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.
  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.)

Eclipse Kepler

In addition to JBDS, SwitchYard Tooling is also compatible with Eclipse JEE Kepler release. If you don't already have a Kepler JEE install, download and install from the Eclipse Download site.

  1. Download a release version of the offline update site ZIP (switchyard-site-assembly) from the SwitchYard Downloads page. 
  2. Open Eclipse Kepler
  3. Select Window→Preferences from the main menu bar, go to Install/Update→Available Software Sites, and Add... the following sites:
    http://download.jboss.org/jbosstools/updates/stable/kepler/integration-stack/aggregate/4.1.4.Final/
  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.
  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.)
Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Jan 10, 2013

    Hi Friso,

    Please refer to heading "Release Builds" above. I have installed JBDS 6.0 and downloaded the 0.7 version of the Swi

      SwitchYard offline site update zip. I followed the instructions and I get the following error :

    Cannot complete the install because one or more required items could not be found.
      Software being installed: SwitchYard Editor 0.7.0.v20130109-0353-H243-CI (org.switchyard.tools.editor.feature.feature.group 0.7.0.v20130109-0353-H243-CI)
      Missing requirement: SwitchYard Editor 0.7.0.v20130109-0353-H243-CI (org.switchyard.tools.editor.feature.feature.group 0.7.0.v20130109-0353-H243-CI) requires 'org.eclipse.emf.compare.feature.group [1.2.0,2.0.0)' but it could not be found

    Can you please help?

    Thx

    Vimal

    1. Jan 11, 2013

      Hi Vimal,

      I'm just a regular user, like yourself. I edited the page as my installation failed, since the switchyard-site-assembly was in version 0.6 (something that should be fixed now). I solved it by using the update site http://download.jboss.org/jbosstools/updates/integration/juno/soa-tooling/switchyard/ YMMV.

      Groeten,

      Friso

    2. Jun 06, 2013

      I had faced similar issue; following link would help: https://community.jboss.org/thread/228913

  2. Jun 15, 2013

    Under section "Alternate Installation / Installation" step 3, I used this URL:
    http://download.jboss.org/jbosstools/updates/nightly/soa-tooling/4.1.kepler/4.1.0/

  3. Jun 19, 2013

    I failed when trying to install the SwitchYard 0.8 eclipse tooling due to conflicting dependencies. Please see my append https://community.jboss.org/thread/229543 where I describe the issue.

    Any ideas?

    1. Jun 19, 2013

      Michael, I also had the conflicting dependencies issue.  I resolved it by installing the following:

      1. Jun 19, 2013

        Hi David, I got a response from Rob Cernich on my referenced thread. That solved my issue in the meantime.

        But thanks for responding nonetheless!

        Cheers,

        M.

  4. Jun 12, 2014

    Just an fyi that the above instructions for JBDS say "Download a release version of the offline update site ZIP (switchyard-site-assembly) from the SwitchYard Downloads page". That page (http://switchyard.jboss.org/downloads) does not include any file with "switchyard-site-assembly" in the name. 

    1. Nov 27, 2014

      I belive switchyard-site-assembly is only on released (non alpha/beta) versions. The latest as the time of writing is 1.1.Final