Difference between revisions of "MailArchiva"
(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) |
|||
Line 52: | Line 52: | ||
MailArchiva should now be ready and working. | 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 . . . | ||
+ | |||
+ | <code>Do you agree to the terms of the agreement (yes/no)?</code> | ||
+ | |||
+ | ("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 | ||
+ | |||
+ | |||
+ | 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 stop service, type sudo systemctl stop mailarchiva</code> | ||
+ | |||
+ | <code>mailarchiva server has been installed in /opt/mailarchiva</code> | ||
+ | |||
+ | <code>after starting, access web console at <nowiki>http://localhost:8090</nowiki></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> | ||
+ | |||
+ | === '''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:<syntaxhighlight lang="bash"> | ||
+ | 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 | ||
+ | </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 | ||
+ | </syntaxhighlight>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. | ||
---- | ---- | ||
[[Category:Howto]] | [[Category:Howto]] | ||
[[Category:Mail]] | [[Category:Mail]] |
Revision as of 21:58, 16 August 2024
MailArchiva for SME Server
Description
MailArchiva is a state-of-the-art email archiving system.
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.