Administration

Which file should I download ?

In short:
  • magnolia-tomcat-bundle-x.y.z : if you want a standalone version of Magnolia pre-installed in Tomcat with 2 instances (author and public). If you're running with Java 5 or more recent, use of one the "jdk15" variations. If you're stuck with Java 1.4, take one of the "jdk14" variations (they contain the "compatibility package" necessary for Tomcat 5.5 to run with Java 1.4). Usually a .zip file will make Windows users happier, while .tar.gz files will make the day of any Unix or MacOSX user.
  • magnolia-bundled-webapp-x.y.z.war : if you want to use Magnolia in your own J2EE container. This war file is pre-installed with the samples and DMS modules. (No workflow)
  • magnolia-empty-webapp-x.y.z.war : if you want to build a project on top of Magnolia (where you usually won't want sample content). We recommend to use this artifact as a Maven dependency however. (it is available on our repository)

Bundled-webapp vs empty-webapp

In terms of Maven dependencies, custom Magnolia-based webapps should depend on the magnolia-empty-webapp artifact, and add dependencies to the modules they need. The magnolia-bundle project and subprojects are not meant to be used as-is by projects extending Magnolia, but only as packaging projects for Magnolia releases as a product.

Known issues

Leopard

We noticed some issues with Mac OSX 10.5 (Leopard), if Magnolia (Tomcat) is installed under the /Applications folder. This seems to be due to a more restrictive firewall. The solution is to either install Magnolia under a different, less restricted folder, or to relax the firewall configuration. Please see MAGNOLIA-1959 for more details and/or to comment on your own experience.

Xalan

Every now and then, someone has a Xalan related issue. If you see the infamous "javax.xml.transform.TransformerFactoryConfigurationError: Provider org.apache.xalan.processor.TransformerFactoryImpl not found" error message in your logs, you'll need to add the Xalan jar to WEB-INF/lib, delete the repositories and start again. Please see MAGNOLIA-1958 for more details and/or to comment on your own experience.