MailArchiva

From SME Server
Jump to navigationJump to search


MailArchiva for SME Server

PythonIcon.png 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.png Warning:
: Some portions obsolete



Important.png Note:
This How-To has been amended to work with SME Server 10. See the Addendum below.


http://www.mailarchiva.com/

Enable SME maillog archiving following this FAQ:

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

Download MailArchiva

http://downloads.sourceforge.net/openmailarchiva

Installation without Tomcat

If you do not have Tomcat in your SME Server, follow these instructions.

tar -zxvf mailarchiva_opensource_edition_v1_7_9c_linux_32bit.tar.gz
cd ./mailarchiva_dist
./install.sh

SME Server specific config changes

config set mailarchiva service TCPPort 8090 access private status enabled
ln -s /etc/rc.d/init.d/e-smith-service /etc/rc.d/rc7.d/S99mailarchiva

Installation with Tomcat

If you already have Tomcat in your SME Server, follow these instructions.

service tomcat stop
tar -zxvf mailarchiva_opensource_edition_v1_7_9c_linux_32bit.tar.gz
cp -r mailarchiva_dist/mailarchiva/server/webapps/mailarchiva /opt/tomcat/webapps/mailarchiva
cp -r mailarchiva_dist/mailarchiva/server/endorsed /opt/tomcat/endorsed
chown -R tomcat.tomcat /opt/tomcat*
service tomcat start

Configure MailArchiva

Read and follow: mailarchiva_opensource_edition_v1_7_administration_guide.pdf

http://yourserver:8090/mailarchiva

or Tomcat port.

Step 1: Create a Volume and enter your Email Encryption Password
Step 2: Add your Domains
Step 3: Add a Journal Account Connection, username = maillog, test the connection

MailArchiva should now be ready and working.

Addendum: Installing MailArchiva On Premise v9.0.26 on SME Server 10.1

Downloading . . .

There are two options available

Option A (preferred)

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

Copy and paste the command in Step 2


Option B

Download and extract the most recent tar.gz archive

https://bs.stimulussoft.com/downloads

After extracting the archive, cd inito the mailarchiva-* directory and execute the install script . . .

./install

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.