MailArchiva

From SME Server
Revision as of 22:58, 16 August 2024 by Mdrone (talk | contribs) (An update of the Mailarchiva How-To. It includes download and installation information for the most recent version of Mailarchiva and additional code that makes it compatible with SME Server 10.1)
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:
: probably obsolete.


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-v9.0.26 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.