MailArchiva

From SME Server
Jump to navigation Jump to search


MailArchiva for SME Server

  Skill level: medium
The instructions on this page require a basic knowledge of linux.


Description

MailArchiva is a state-of-the-art email archiving system.

  Warning:
: Some portions obsolete



  Note:
This How-To has been amended to work with SME Server 10.


http://www.mailarchiva.com/

Enable SME maillog archiving

http://wiki.contribs.org/SME_Server:Documentation:FAQ#Keep_a_copy_of_all_emails

Installing on SME Server 10.1

MailArchiva On Premise v9.0.26

Downloading . . .

There are two options available

Option A (preferred)

https://help.mailarchiva.com/enterprise-linux-install

Copy and paste the command in Step 2

curl -sS https://bs.stimulussoft.com/api/v1/download/product/maonprem/linux/latest | grep -oP '"downloadUrl": *"\K[^"]*' | xargs curl | tar -xz -C /tmp && cd /tmp/mailarchiva-* && ./install && rm -r /tmp/mailarchiva-*

Note: As an alternative, the link to download the latest version may also be found on the download page. After downloading, run ./install to begin setup.

Option B

Download and extract the most recent tar.gz archive

https://bs.stimulussoft.com/downloads

After extracting the archive, cd into the mailarchiva-* directory and execute the install script:

# ./install

You'll initially be required to read the license agreement

**************************************************************

  • MailArchiva Server Installation/Upgrade                    *

Welcome to the MailArchiva installation / upgrade procedure.

In future, you may also use this script from upgrade purposes.

Simply download an update from http://www.mailarchiva.com     

and run this script. All your settings will be preserved.     

Press [enter] to read the license agreement...

After reading the agreement, you'll be asked whether or not you agree to the terms of the agreement ('yes' is the proper answer):

Do you agree to the terms of the agreement (yes/no)?

During the installation process (either method), you'll be asked two questions:

Do you agree to the terms of the agreement (yes/no)?

("yes" is the proper answer)

Max heap size [512m-7557m]?:

(If your server has 8GB of physical RAM, you can use 5192m for the Max heap size value)

Refer to http://help.mailarchiva.com/enterprise-memory-settings for heap space recommendations

If installation is successful, you'll see the following:

mailarchiva service installed

to start service, type sudo systemctl start mailarchiva

to stop service, type sudo systemctl stop mailarchiva

mailarchiva server has been installed in /opt/mailarchiva

after starting, access web console at http://localhost:8090

if service start fails, start server using /opt/mailarchiva/server/startserver

visit http://help.mailarchiva.com/ for setup and configuration instructions

Tweaking The Installation: The SME Server Way

SME Server 10.1 requires a few additional tweaks in order to:

  • allow Mailarchiva traffic on TCP port 8090
  • allow Mailarchiva to run as a service under the SME Server system
  • allow Mailarchiva to be publicly (or privately) accessible
  • allow Mailarchiva to survive a server reboot

The tweaks required to make Mailarchiva work on SME Server 10.1 are:

mkdir /etc/systemd/system/mailarchiva.service.d
printf "[Install]\nWantedBy=sme-server.target" > /etc/systemd/system/mailarchiva.service.d/50koozali.conf
db configuration set mailarchiva service TCPPort 8090 access public status enabled
signal-event console-save

If you prefer not to have your implementation available to the public, change the 3rd line above to:

db configuration set mailarchiva service TCPPort 8090 access private status enabled

Then you can ssh to your server via a tunnel on port 8090 and then access Mailarchiva at http://localhost:8090


Kudos

I'm very grateful for the assistance of ReetP and Jean-Philippe Pialasse via the Contribs.org Forums for their guidance in getting this to work, and to the author of the original Mailarchiva Wiki How-To for the original initiative.