Membrane ESB Web Application Deployment

Membrane ESB can be installed as a Web App providing the following benefits:

An Application Server can startup and shutdown Membrane ESB as needed.
The ESB runs in the same VM as the Servlet Container or application server.
Deployment fits production in a data center.

Building the ESB war and installing it into Tomcat (or any J2EE-compatible web server) requires the following steps:

1. Get the WAR

To quickly get started, download the war from the Maven repository and skip to the step 2. To customize it, continue here:

i. Checkout the Membrane Source Code

Checkout the source code from the following location:

https://github.com/membrane/service-proxy/

ii. Building the War

Excecute the following command from the directory where you checked out the sourcecode.

mvn package -DskipTests

The war will be build in war/target/.

2. Deploying the War in Tomcat

Copy the router.war into the Tomcat webapp directory located at

[tomcatDir]\webapps

Restart Tomcat. To test the router open .../admin in your browser. (Where "..." is the host and port your web server is listening on as well as the context root of the web application, for example http://localhost:8080/membrane-esb-war-3.3.8-SNAPSHOT/admin.)

More details on how to configure Membrane can be found in /WEB-INF/web.xml within the WAR.

Configuring Proxy Services

The ESB is configured by the proxies.xml and the monitor-beans.xml files. They are located in the WEB-INF directory of the war file. To open the archive simply rename it into a zip file (e.g. membrane.zip). The documentation of these files can be found here.