loading table of contents...

2.1.3.1. Installing the war package

For installing the Docmenta war package, all you have to do is to deploy the war file to the web-server. You can recognize the war file by its filename extension ".war". If the downloaded package has the extension ".zip" then unpack the zip file to get the war file.
The steps of deploying a war file can differ, depending on which web-server you are using. For the Apache Tomcat web-server all you have to do, is to copy the war file into the webapps sub-folder of the Tomcat installation directory. If the "autoDeploy" setting is disabled, then you additionally have to restart the Tomcat web-server. See also the Apache Tomcat documentation for more information on how to deploy a web-application: http://tomcat.apache.org/tomcat-6.0-doc/deployer-howto.html
If you are using some other web-server (e.g. JBOSS, WebSphere, WebLogic, Jetty, ...), then please see the documentation that is provided with your web-server.
Note:
For exporting large publications it may be necessary to increase the maximum Java heap size of your web-server installation. You can detect that you have to increase the heap size, when large exports fail and the server logs list out-of-memory errors. Please consult the documentation provided with your web-server for details. Following forum discussion gives some useful hints on how to increase the heap size for Apache Tomcat: http://www.coderanch.com/t/87422/Tomcat/increase-java-heap-size
After having deployed the war package, you are ready to set up Docmenta as described in Section 2.1.4, “Setup”.