Service Provider Configuration

Since MailArchiva runs under Apache Tomcat, multiple MailArchiva web applications can be deployed on a single Tomcat instance. The MailArchiva web app is fairly light weight, so you should be able to run many web apps on one server without a problem. Just be careful to set the audit log paths, etc. to unique values, otherwise the system can become unstable due to locking issues.

Once the web application is unpacked an entirely new instance of MailArchiva would be created, giving the customer full control over the entire application. Furthermore, this configuration model offers an acceptable level of isolation; if something goes wrong in one MailArchiva instance, it is unlikely to have an effect on the other instance.

Installation/ Upgrade Linux

Installing a new instance in Linux is easy!

You can use the standard install script that comes with MA to install and upgrade instances.

./install webapp-name 8095 8096

=> install/update [webapp-name]-instance with SMTP-PORT:8095 and MILTER-PORT:8096

(script available in EE only)

You may need to increase the amount of PermGen space, by editing the startserver.sh script and increasing -XX:MaxPermSize=128M

Also, increase heap size by running the configure script again.

Installation Windows

(1) Copy the directory

C:\Program Files\MailArchiva\Server\Webapps\ROOT to

C:\Program Files\MailArchiva\Server\Webapps\App

(2) Edit the file C:\Program Files\MailArchiva\Server\Webapps\App\WEB-INF\conf\server.conf

a) Change agent.port=8091 to another port

b) Change agent.milter.port=8092 to another port

c) Change audit.location=M:\MailArchiva\Server\WebApps\App\WEB-INF\logs

d) Change noarchive.location=M:\MailArchiva\Server\WebApps\App\WEB-INF\noarchive

e) Change quarantine.location=M:\MailArchiva\Server\webapps\App\WEB-INF\quarantine

f) Edit all other instance specific settings. Make sure volume store and index paths are different

(3) Edit the C:\Program Files\MailArchiva\Server\Webapps\App\WEB-INF\classes\log4j.xml

a) Search and replace ${ROOT} with ${App}

(4) In the task tray applet, you may need to increase the amount of memory and perm gen space allocated to the JVM

Set: -XX:PermSize=96M

-XX:MaxPermSize=128M (or greater depending on how many web applications)

Maximum memory pool: 1024 (or greater depending on how many web applications)

(5) Restart the server

(6) Access the instance by typing http://localhost:8090/App in your web browser.

(since you created a new application named "App" in the Webapps directory above)