The MailArchiva Server can be installed on a variety of Linux distributions. The instructions below illustrate the steps required to install the server on common Linux distributions.
Step 1. Install Haveged (optional, but recommended)
The Haveged utility enhances the entropy available on your server that MailArchiva relies upon to perform various cryptographic operations.
To install Haveged on Debian-based platforms:
sudo apt-get install haveged
sudo update-rc.d haveged defaults
sudo service haveged start
To install Haveged on RHEL/Fedora/CentOS machines:
chkconfig haveged on
To install Haveged on CentOS 8:
yum install epel-release-latest-8.noarch.rpm -y
yum install haveged -y
Step 2. Install FontConfig package (needed for PDF font rendering)
MailArchiva relies upon the Linux package FontConfig to render fonts when exporting PDF files. On a clean headless Linux distro install, the FontConfig package may not be available by default.
To install FontConfig on Debian-based platforms:
sudo apt-get update -y
To install Fontconfig on RHEL/Fedora/CentOS machines:
Step 3. Install/Upgrade MailArchiva Server
Download the latest MailArchiva distribution. To install the server, type the following:
tar –xvzf mailarchiva_server_linux_v8.11.30.tar.gz
During the install process, when prompted to enter a maximum heap size, refer to Memory Settings for guidance.
Following the above, the server will be installed /opt/mailarchiva. Server binaries are located at /opt/mailarchiva/server. Refer to File System Layout for other locations of interest.
Step 4. Check Availability of Port 8090 and Port 8091.
By default, MailArchiva uses port 8090 and port 8091. Before starting the server, ensure that these ports are not being used by another application. You can do this by typing “netstat -vatn” from the console. If port 8090 is in use, edit the file /var/opt/mailarchiva/tomcat/conf/server.xml and change all references from “8090” to the desired port.
Step 5. Start MailArchiva Server
To start the MailArchiva Server from the commandline type:
Now that your server is running, refer to Maintenance / Handover to familiarize yourself with general maintenance steps.
Found this information useful? Visit mailarchiva.com to learn more about MailArchiva.