Chapter 1: Download, installation and quick tour

The story

In this chapter we'll learn general concepts of MUM. We'll show you how to download, deploy and start using MUM, discussing the initial data model and how the application works.

Since Joey always yawns just from hearing the word "installation", we'll make it short.

Before you start

To install and develop Marbles-based applications like MUM, you will need:

  • The JDK 1.5 or later
  • Optionally, a Java-capable IDE like Eclipse, NetBeans or IntelliJ
  • An installation of Apache Ant (You can also use Ant from within your IDE)
  • jUnit version 3.8.x or later
    • place the junit.jar file in the ANT_HOME/lib directory
  • A servlet container such as Jetty or Apache Tomcat. If you can't decide, Jetty.

1.3 Download the tutorial code

You can download the MUM source distribution from here. It's a ZIP file containing the runtime libraries, templates and all the things you need to get started. The structure of the archive is the following:

  • mum-beta4-src/
    • config/ – configuration files
    • standalone/ – files for the standalone release
    • src/ – Java source files
    • test/ – Java source files for tests
    • web/ – web file
      • mum-static/ – static content, mostly CSS, Javascript and image files.
      • WEB-INF/ – web.xml file
      • templates/ – widget templates
      • user/, group/, zone/, administration/ – application templates
    • build.xml, build-ivy.xml, build.properties – Ant build files
    • ivy.xml, ivyconf.xml – Ivy files

Although it seems a big structure, you'll probably only care about the items in bold.

Please send us comments, questions, criticism:

Please send us comments, questions, criticism!