Installing 2.1 war-file distribution

The war-file distribution contains 2 war files, magnoliaPublic and magnoliaAdmin, which you can deploy to an existing application server. The two war files are identical except for the different preloaded configuration (the xml files in the bootstrap directory.

Prerequisites

You will need a servlet container which support the servlets 2.4/jsp 2.0 spec. The suggested server is Tomcat 5/5.5, but you can choose a different application server if you wish.

Warning: since bootstrapping could require a large amount of memory, be sure to set the maximum memory available to the server to at least 256MB (usually passing the -Xmx256m parameter to the java process). If an OutOfMemory error pops up in the console during the bootstrap process you will need to remove the magnolia webapp and redeploy it since bootstrap will not be repeated if a partial repository has already been loaded. This need to be done BEFORE deploying the wars.

Installing and testing the installation

Install both wars (this is usually done by copying the files to the webapps directory of your server).

Also note that Magnolia requires to be unzipped in order to work properly. Most of the application server automatically unzip wars while deploying them: if you run Magnolia on an application server which is able to run zipped wars you will need to unpack it manually.

After starting the server, open your favorite browser and go to http://[server name]:[port]/[war name]. That means, for a default installation, http://localhost:8080/magnolia. You should see a login prompt, use superuser as login/password and welcome to the magnolia admin interface.

If you can't see anything probably the bootstrap process failed. Check you server logs for errors, the most common reason for a failure is an OutOfMemory error during bootstrap.