The legal archive feature is ideal for keeping a copy of incoming emails in an archive. You can enable user level searching of the archive. And store the data locally (recommended) or on your Amazon storage.
Use the Archive config page in SurgeMail admin to quickly configure it. (Under Manage)
Never use the amazon storage feature (it's expensive, local drives are better!)
The Report and Search buttons let you see the usage and search for messages. Users can also search the archive (if permitted).
The basic settings you need are:
g_legal_archive_enable "TRUE"
g_legal_archive_local "TRUE"
g_legal_archive_path "/usr/local/surgemail/legal_archive"
g_legal_archive_hostid "1"
g_legal_archive_encrypt_key "yoursecret" <-- change this and never loose it!
g_legal_archive_keep "3 months" <-- specify retention time based on disk spaceTellmail commands for managing the archive:
la_export
tellmail la_export domain.name dd-mon-yyyy dd-mon-yyyy c:\destination
This command extracts the contents of the archive in a format suitable to import into other systems.
archive_delete
tellmail archive_delete domain.name YES_REALLY_DELETE_THIS
This deletes all archive data for a single domain.
archive_list (s3 only)
tellmail archive_list domain.name
Lists the contents of the archive. Not useful for local archives. DO NOT USE.
resync_archive
tellmail resync_archive
Send archive data to a mirror system
archive_monthly
tellmail archive_monthly 365
Will cleanout old archive data up to 1 year ago (applying existing rules within that time period)
This command does not need to be run manually.
Other archive settings...
g_legal_archive_accesskey - Amazon s3 awsaccesskeyid
Used if the archive is on amazon s3 storage, DO NOT USE!
Syntax: g_legal_archive_accesskey string
g_legal_archive_add - Users must belong to this group to get their email archived
This setting has no further documentation currently available
Syntax: g_legal_archive_add string
g_legal_archive_bucket - bucket for for net service
This setting has no further documentation currently available
Syntax: g_legal_archive_bucket string
g_legal_archive_enable - Enable legal archive
This setting has no further documentation currently available
Syntax: g_legal_archive_enable bool
g_legal_archive_encrypt_key - Key for encrypting the data, you MUST never loose this
This setting has no further documentation currently available
Syntax: g_legal_archive_encrypt_key string
g_legal_archive_hostid - Unique integer for this host 1-9 use if sharing mail spool
This setting has no further documentation currently available
Syntax: g_legal_archive_hostid int
g_legal_archive_keep - Days to keep legal archive, units=days unless you specify years or months, default 5 years
This setting has no further documentation currently available
Syntax: g_legal_archive_keep int
g_legal_archive_local - Store files locally only
This setting has no further documentation currently available
Syntax: g_legal_archive_local bool
g_legal_archive_nofail - Don't bounce messages if archvie fails
This setting has no further documentation currently available
Syntax: g_legal_archive_nofail bool
g_legal_archive_only - Drop all messages after archiving them!
This setting has no further documentation currently available
Syntax: g_legal_archive_only bool
g_legal_archive_path - Local path for archive indexes
This setting has no further documentation currently available
Syntax: g_legal_archive_path string
g_legal_archive_secretkey - Amazon s3 awssecretkey
This setting has no further documentation currently available
Syntax: g_legal_archive_secretkey string
g_legal_archive_show - Users must belong to 'archive_show' group to see their own archive
This setting has no further documentation currently available
Syntax: g_legal_archive_show bool
g_legal_archive_spam - Store files even if identified as spam (OBSOLETE)
Messages are always stored now regardless of spam score
Syntax: g_legal_archive_spam bool