Kavi Mailing List Manager Help
Table of Contents
A mailing list archive is a convenient, centralized way to store mailing list posts for easy retrieval. Publicly viewable Web archives provide transparency into a technical standards organization's activities and standards development processes, whereas archives of lists that exchange confidential information can be kept private. Access to a list's Web archives may be as open or as restricted as required.
Among their many virtues, archives allow users to follow subject threads, to catch up on email that may have been missed while on vacation and to familiarize themselves with list history.
Back to topThere are two types of archives in the Kavi® Mailing List Manager system. The ezmlm software processes messages from mailing lists it manages into raw archives, then MHonArc software converts these raw archives into Web-viewable archives to provide more advanced indexing and search functionality.
Raw archiving is enabled in all Kavi default list types (the preconfigured templates on which different types of mailing lists are based). Raw archives can be retrieved via email using ezmlm email address commands, assuming the list type is configured to accept email admin requests.
The ezmlm archive indexing tool, ezmlm-idx, maintains a subject and author index for the raw archives. Email address commands can take advantage of these indexes to retrieve select sets of messages from the raw archives. For more information, see Email Commands.
Web-viewable archives are created by MHonArc, which uses the raw ezmlm archives and reformats them for presentation on the web. MHonArc HTML archives are accessible through Kavi Mailing List Manager tools, can be formatted to match the look and feel of the rest of your site, are searchable and offer several types of indexes including subject, author, date and thread.
Because the Web-viewable archives present a persistent record of the organization's activities, they are sometimes edited to remove inappropriate messages that were posted to the list. Editing of MHonArc archives must be performed by Kavi or other system administrators.
In order for a mailing list to have any archives whatsoever, ezmlm archiving must be enabled (i.e., the -a switch must be set in the ezmlm-make argument string) in the list type on which the list is based. As long as archiving is enabled in the list type, raw archives will exist, even if they are not accessible to anyone except administrators.
The option to enable Web-visible archiving is available when a list is created or edited. If Web-visible archiving is completely disabled for a list, MHonArc archives will not be created. If the feature is enabled and then later disabled, any existing MHonArc archives for that list will be deleted—but as long as the raw archives still exist, Web archives can always be recreated. There is one caveat to this: any edits performed on the Web archives will be lost.
Since archiving does consume some system overhead, raw archiving can be disabled for lists where archives are unnecessary.
Back to topAccess to raw archives is controlled through a list type option configured by super administrators when they add or edit one of the list types that serves as a template for mailing lists, whereas permissions for the web-viewable archives are set by admins when creating an individual list. This means that raw archives may be available to a different set of users than the HTML-formatted archives. Generally, access to raw archives is more restricted than access to web-viewable archives because they may contain content that isn't present in the web archives, such as the full email addresses of people who have posted to the list, which are usually obscured in the web archives.
Raw archives are accessed through ezmlm email address commands rather than Kavi Mailing List Manager tools, although there may be restrictions on who the list can accept commands from. For instance, the list type may be configured to accept email commands only from recognized subscribers and reject those from unknown senders. The most private list types may reject all email address commands except moderation commands. Administrators may always access the raw archives by URL path.
If web-visible archives exist, they will be accessible through Public, Member or Admin pages, or custom subscriber-only pages, depending on access control settings. Web-visible archives is determined by options set at the list level when the list is added or edited. Web archives can be temporarily hidden by editing the list and setting the Web Archive Visiblity option to 'Administrators only'.
For information on how mailing lists classify list users and control access, see Access Control.
For information on selecting appropriate user access settings for raw and Web archives, see Configuring Lists for Common Use Cases. For information on reconfiguring existing lists, see Changing List Type Options.
Back to topWhen raw archiving is enabled, messages that are posted to the list are also forwarded to a mailbox that collects messages to add to the archives. These messages are added to the archives in the order in which they are received.
The 'Instant Archiving' option, which is set at the list type level, determines whether messages will be archived the instant they are sent to this mailbox or periodically (the default is one hour for the periodic setting).
Instant archiving consumes more system resources than periodic archiving, but virtually eliminates the lag time between a message being posted to the list and a message being available in the archives. This lag time is a common source of confusion for list users who are following a thread in the archives or looking for confirmation of whether the message they just sent to the list was posted or not. Many assume that the absence of a message in the archives or a difference in the time the message was sent and the time it is displayed in the archives is proof that something is wrong with the list. For these reasons, as well as the convenience of list users, the benefits of instant archiving might justify the increased system overhead for busy lists or lists where timeliness is of paramount importance.
Periodic archiving works well for most lists and is particularly appropriate for lists that receive posts intermittently.
When ezmlm archives messages, it removes most of the header information, leaving only the message header fields. The message body contains the text of the original message, with any attachments extracted from the message and replaced by links to the extracted files.
Messages are indexed in the order they are received by the mailing list, beginning at 1 and ending at 100. When the first index reaches 100, a second index is begun.
In the Web-viewable archives, the archived messages for each list are compartmentalized into monthly buckets. This enhances the performance of the archiver and presents the messages in user-friendly, month-size chunks.
The indexes are largely self-describing, though it's probably a good idea to note that the 'Messages by Thread' index only includes messages to which there are replies or follow-ups. In other words, a thread is defined as a series of messages on a single subject, so messages without replies are omitted from this view because they don't qualify as threads.
Each monthly archive for a group contains four indexes:
Messages by Date
Messages by Thread
Messages by Author
Messages by Subject
For more information, see the page help for the List Archives tool.
Archive security is primarily based on the ability to restrict access to both the raw and web and archives, as we've already described, but it's also a good idea to take advantage of the 'Protect Archives from Spam' option when adding a list. When enabled, this feature "x's" out the domains of subscriber email addresses in the archives (e.g., fred@xxxxx.xxx) to protect subscriber addresses from address harvesting software. Spammers use this software, also known as spiders or scrapers, to search for and glean email addresses from every web page on the Internet. These addresses are compiled into address lists for the spammers personal use and for resale to other spammers.
The obscured email addresses are a little inconvenient when a list user wants to respond to another list user privately and isn't able to get the other's address from the Web archives. On the other hand, address harvesters are relentless in their attempts to crack or bypass system security, and the lists of address they gather may be sold to spammers around the world, including people running phishing schemes and other kinds of scams.
Back to top