Overview

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.

Prerequisites

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

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

get-jboss-path-question:
    [input] Enter the path to the root of your JBoss EAP installation:
/tmp/jboss-eap-6.4

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