Skip to end of metadata
Go to start of metadata


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.

Ant-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:

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

Distribution Zip

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

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.

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Jul 27, 2015

    Hey, can I get some information on how to deploy the swtichyard console here? Now I have packaged the switchyard-console and rename the war file to switchyard-console.war and installed in the JBoss EAP 6.4, but the problem is I cannot access it via

    So with the latest SY release, the console only support the embedded console with AS?