There are two sets of instructions for enabling the ArchiveVault with Exim. This depends on where the ArchiveVault is installed - if it is in a server external to where AtMail is, or if it is on the same server.

1.  External Installation

1.1  Step 1.

For enabling ArchiveVault where it is installed on a different server from the Atmail system, go to the Atmail system and do the following:

• Go to /usr/local/atmail/mailserver/
• Open and edit configure
• Locate.

 begin routers

• Add the following to routers.

 traffic_tap:
 unseen
 no_expn
 no_verify
 transport = remote_smtp
 driver = manualroute
 require_files = /usr/local/atmail/mailserver/MAIL_TAP_HOST
 route_data = ${readfile{/usr/local/atmail/mailserver/MAIL_TAP_HOST}{:}}

Please note that MAIL_TAP_HOST is a txt file that you can add IP or domain name of the AV appliance/software that you wish to use.

Example:

 domain.com

This exim hook will work with any existing Atmail Server or generic exim.

• Save and exit

1.2  Step 2.

• Log into Admin for ArchiveVault.
• Go to Admin > SMTP Settings.
• Set the server mode.

Post Delivery: Select for installations where the current mail-server forwards all messages to the ArchiveVault appliance, post mail delivery.

• Go to Admin > Global Settings > Local Domains.

Here you can specify which domains you wish for the ArchiveVault to Archive.

2.  Internal Installation

2.1  Step 1.

For enabling ArchiveVault where it is installed on the same server as the Atmail system, go to the Atmail system and do the following:

• Go to /usr/local/atmail/mailserver/
• Open and edit configure
• Locate.

 begin routers

• Add the following to routers.

 traffic_tap:
 self = send
 unseen
 no_expn
 no_verify
 ignore_target_hosts = 127.0.0.1
 transport = remote_smtp_arch
 driver = manualroute
 require_files = /usr/local/atmail/mailserver/MAIL_TAP_HOST
 route_data = ${readfile{/usr/local/atmail/mailserver/MAIL_TAP_HOST}{:}}

Please note that MAIL_TAP_HOST is a text file that must contain the local address of the AV server installed

Example:

 127.0.0.1

This Exim hook will work with any existing Atmail Server or generic Exim.

• Find the following line:

 mysql_sms:
 driver = pipe
 command = /usr/local/atmail/webmail/modules/email2sms.php ${local_part}@${domain}
 home_directory = "/tmp"
 current_directory = "/tmp"
 log_output = false
 return_fail_output = false

• Add the following under it:

 remote_smtp_arch:
 driver = smtp
 port = 2500
 hosts = 127.0.0.1 
 hosts_override
 allow_localhost

• Save and exit. Note port 2500 is the default port ArchiveVault will install the SMTP agent under when running an instance of Atmail locally.

2.2  Step 2.

• Log into Admin for ArchiveVault.
• Go to Admin > SMTP Settings.
• Set the server mode.

Post Delivery: Select for installations where the current mail-server forwards all messages to the ArchiveVault appliance, post mail delivery.

• Go to Admin > Global Settings > Local Domains.

Here you can specify which domains you wish for the ArchiveVault to Archive.