Difference between revisions of "MailArchiva"
(4 intermediate revisions by 2 users not shown) | |||
Line 7: | Line 7: | ||
MailArchiva is a state-of-the-art email archiving system. | MailArchiva is a state-of-the-art email archiving system. | ||
{{Warning box| : Some portions obsolete}} | {{Warning box| : Some portions obsolete}} | ||
+ | |||
+ | {{Note box|This How-To has been amended to work with SME Server 10.}} | ||
http://www.mailarchiva.com/ | http://www.mailarchiva.com/ | ||
− | ===Enable SME maillog archiving | + | ===Enable SME maillog archiving=== |
http://wiki.contribs.org/SME_Server:Documentation:FAQ#Keep_a_copy_of_all_emails | 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 . . .''' | '''Downloading . . .''' | ||
Line 60: | Line 26: | ||
'''Option A (preferred)''' | '''Option A (preferred)''' | ||
https://help.mailarchiva.com/enterprise-linux-install | https://help.mailarchiva.com/enterprise-linux-install | ||
+ | |||
Copy and paste the command in Step 2 | 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-* | ||
+ | |||
+ | Note1: If you wish to keep the setup files (in /tmp/mailarchiva-*), don't copy "&& rm -r /tmp/mailarchiva-*" in the line above prior to issuing the command | ||
+ | Note2: As an alternative, the link to download the latest version may also be found on the download page. After downloading and extracting the archive, run ./install to begin setup. | ||
'''Option B''' | '''Option B''' | ||
Line 67: | Line 38: | ||
Download and extract the most recent tar.gz archive | Download and extract the most recent tar.gz archive | ||
https://bs.stimulussoft.com/downloads | https://bs.stimulussoft.com/downloads | ||
− | After extracting the archive, cd | + | After extracting the archive, cd into the mailarchiva-* directory and execute the install script: |
− | ./install | + | # ./install |
− | |||
− | <code> | + | 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 . . . |
− | ("yes" is the proper answer) | + | 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) |
− | |||
− | <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:<blockquote><code>mailarchiva service installed</code> | |
− | If installation is successful, you'll see the following: | ||
− | |||
− | <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 96: | Line 59: | ||
<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'''=== |
SME Server 10.1 requires a few additional tweaks in order to: | SME Server 10.1 requires a few additional tweaks in order to: | ||
− | * allow Mailarchiva traffic on TCP port 8090 | + | *allow Mailarchiva traffic on TCP port 8090 |
− | * allow Mailarchiva to run as a service under the SME Server system | + | *allow Mailarchiva to run as a service under the SME Server system |
− | * allow Mailarchiva to be publicly (or privately) accessible | + | *allow Mailarchiva to be publicly (or privately) accessible |
− | * allow Mailarchiva to survive a server reboot | + | *allow Mailarchiva to survive a server reboot |
− | + | The tweaks required to make Mailarchiva work on SME Server 10.1 are: | |
− | The tweaks required to make Mailarchiva work on SME Server 10.1 are:<syntaxhighlight lang="bash"> | + | <syntaxhighlight lang="bash"> |
mkdir /etc/systemd/system/mailarchiva.service.d | mkdir /etc/systemd/system/mailarchiva.service.d | ||
printf "[Install]\nWantedBy=sme-server.target" > /etc/systemd/system/mailarchiva.service.d/50koozali.conf | 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 | db configuration set mailarchiva service TCPPort 8090 access public status enabled | ||
signal-event console-save | signal-event console-save | ||
− | </syntaxhighlight>If you prefer not to have your implementation available to the public, change the 3rd line above to:<syntaxhighlight lang="bash"> | + | </syntaxhighlight> |
+ | |||
+ | If you prefer not to have your implementation available to the public, change the 3rd line above to: | ||
+ | |||
+ | <syntaxhighlight lang="bash"> | ||
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 | ||
+ | |||
Latest revision as of 12:28, 23 August 2024
MailArchiva for SME Server
Description
MailArchiva is a state-of-the-art email archiving system.
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-*
Note1: If you wish to keep the setup files (in /tmp/mailarchiva-*), don't copy "&& rm -r /tmp/mailarchiva-*" in the line above prior to issuing the command
Note2: As an alternative, the link to download the latest version may also be found on the download page. After downloading and extracting the archive, 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.