Deploy MUM

You are free to choose

Again, there are several options to deploy MUM to a servlet container:

  1. Use ant to deploy to a standalone tomcat server
  2. use Jetty with the JettyLauncher in Eclipse
  3. use Tomcat with the Eclipse WebTools project

Using Ant and a standalone web container

Most web developers have an instance of Tomcat or Jetty running that they use to boost the compile-deploy-test cycle. You can do the same with MUM by poiting your servlet container to the /web directory and using Ant to deploy it:

C:\mum>ant deploy

A typical Tomcat configuration looks like this:

<Context docBase="C:\mum\web" />

Using Eclipse's JettyLauncher plugin

It's even easier to use JettyLauncher. Select a Jetty Web configuration and click the New icon above the list.

Deployment with the JettyLauncher plugin

You will need a Jetty installation (mine is at D:\install\jetty-5.1.1RC0). You can then select the "mum" project, the "web" directory for the webapp root dir, and run it.

Be careful!
Until now Jetty 6.0 doesn't work with Eclipse and you can't use JRE 1.6.

When deployed like the picture above, you are not required to call any Ant task: the regular Eclipse build will suffice.

Using Eclipse WebTools with tomcat

To run MUM from Eclipse with the WebTools project you will need to install the required components using Eclipse's Update Manager. Select the Callisto Discovery Site and click "finish". After choosing a mirror select both packages unter "Web and J2EE Development" and then click "Select required", then "Next" and follow the installation process.

Installation of the Web Tools project

After the restart, you are ready to configure the Tomcat-server. To see the "servers" tab, click Window -> Show View -> Other... and select Server -> Servers from the list you get.
In the servers tab right-click and select "new" to go through the server configuration wizard.

Set up Tomcat

When this is done, you will need to add MUM to the server. Double-click the newly created server and switch to the Modules pages. Since we did not install MUM as a Web project we will need to add an external Web Module. As the document base you will need to select the filesystem-path of mum/web/.
Since tomcat now looks for its classes in mum/web/WEB-INF/classes, we will need to change the project properties of mum to compile classes to that folder:

Set build path

After the project is build you are ready to run it: In the Servers tab select your server and then click on Run or Debug.
Voilá

Welcome to MUM

After you've deployed the web app, you can point your browser to the deployed location (say, http://localhost:8080/mum) and see the first installation screen:

The installation is explained in all details on the next page.

Please send us comments, questions, criticism:

Please send us comments, questions, criticism!