Difference between revisions of "MailArchiva"

From SME Server
Jump to navigationJump to search
Line 39: Line 39:
 
  # ./install
 
  # ./install
  
You'll initially be required to read the license agreement <blockquote>**************************************************************
+
You'll initially be required to read the license agreement . . . <blockquote><code>Press [enter] to read the license agreement...</code></blockquote>After reading through the agreement, you can proceed as follows . . .
  
* MailArchiva Server Installation/Upgrade                    *
+
During the installation process (either method), you'll be asked two questions:<blockquote><code>Do you agree to the terms of the agreement (yes/no)?</code></blockquote>("yes" is the proper answer)<blockquote><code>Max heap size [512m-7557m]?:</code></blockquote>(If your server has 8GB of physical RAM, you can use 5192m for the Max heap size value)
 
 
**************************************************************
 
 
 
Welcome to the MailArchiva installation / upgrade procedure.
 
 
 
In future, you may also use this script from upgrade purposes.
 
 
 
Simply download an update from <nowiki>http://www.mailarchiva.com</nowiki>     
 
 
 
and run this script. All your settings will be preserved.     
 
 
 
**************************************************************
 
 
 
Press [enter] to read the license agreement...</blockquote>After reading the agreement, you'll be asked whether or not you agree to the terms of the agreement ('yes' is the proper answer):<blockquote>Do you agree to the terms of the agreement (yes/no)? </blockquote>During the installation process (either method), you'll be asked two questions:<blockquote><code>Do you agree to the terms of the agreement (yes/no)?</code></blockquote>("yes" is the proper answer)
 
 
 
<code>Max heap size [512m-7557m]?:</code>
 
 
 
(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
 
Refer to http://help.mailarchiva.com/enterprise-memory-settings for heap space recommendations
  
If installation is successful, you'll see the following:
+
If installation is successful, you'll see the following:<blockquote><code>mailarchiva service installed</code>
 
 
<code>mailarchiva service installed</code>
 
  
 
<code>to start service, type sudo systemctl start mailarchiva</code>
 
<code>to start service, type sudo systemctl start mailarchiva</code>
Line 77: Line 57:
 
<code>if service start fails, start server using /opt/mailarchiva/server/startserver</code>
 
<code>if service start fails, start server using /opt/mailarchiva/server/startserver</code>
  
<code>visit <nowiki>http://help.mailarchiva.com/</nowiki> for setup and configuration instructions</code>
+
<code>visit <nowiki>http://help.mailarchiva.com/</nowiki> for setup and configuration instructions</code></blockquote>
  
 
==='''Tweaking The Installation: The SME Server Way'''===
 
==='''Tweaking The Installation: The SME Server Way'''===
Line 100: Line 80:
 
db configuration set mailarchiva service TCPPort 8090 access private status enabled
 
db configuration set mailarchiva service TCPPort 8090 access private status enabled
 
</syntaxhighlight>Then you can ssh to your server via a tunnel on port 8090 and then access Mailarchiva at http://localhost:8090
 
</syntaxhighlight>Then you can ssh to your server via a tunnel on port 8090 and then access Mailarchiva at http://localhost:8090
 +
  
  

Revision as of 13:22, 23 August 2024


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.


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

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

After reading through the agreement, you can proceed as follows . . . 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.