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.)
Login with user admin and password membrane.
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.