JBoss Community Archive (Read Only)


Installing SwitchYard


The SwitchYard runtime can be installed into an existing EAP 6 installation using one of two methods:

  • Ant-based installer : supports interactive or parameterized installation of SwitchYard into EAP via an Ant script.

  • Distribution zip : an archive containing all SwitchYard modules, configuration, and quickstarts which is unzipped on top of an EAP installation.

The Ant-based installer is a bit more flexible in terms of options and also preserves existing EAP configuration. The distribution zip doesn't require Ant and allows for an easy unzip installation, but it does have the drawback of replacing the existing EAP configuration files (e.g.. standalone.xml). Whatever option you choose, you'll need to visit the SwitchYard Downloads page to get it.


SwitchYard is low on prerequisites. The only things you need check are:

  1. Java 8

  2. Maven 3

  3. EAP 6.4

If you plan to use the Ant-based installer, you'll need Ant as well.

based installer

Please make sure you are using ant version 1.9.x or newer.

Download the installer from the SwitchYard Downloads page and extract it to a location of your choice.  Once extracted, you can simply run 'ant from within the installer directory to start the interactive installer:

> cd switchyard-installer-2.1
> ant
Buildfile: /tmp/switchyard-installer-2.1/build.xml

    [input] Enter the path to the root of your JBoss EAP installation:

Interactive mode can be disabled by passing the EAP_PATH property when executing Ant:

> ant -DEAP_PATH=/tmp/jboss-eap-6.4

Distribution Zip

Download the distribution zip from the SwitchYard Downloads page and unzip it inside of your EAP installation:

> cd /tmp/jboss-eap-6.1
> unzip switchyard-2.1.0.Final-EAP6.4.4.GA.zip

Depending on the zip utility in use, you may be prompted whether existing files should be replaced.  Answer yes/all for all files being unzipped.

replace domain/configuration/domain.xml? [y]es, [n]o, [A]ll, [N]one, [r]ename: A
JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-13 09:43:05 UTC, last content change 2016-08-19 19:02:18 UTC.