Special Information for MBARI Users
This server uses the Sympa public domain listserver software. The MBARI I.S. staff has put together a specialized set of tech notes on the IS web site dealing with MBARI's implementation of the Sympa package. You can find those tech notes by clicking here; they will open in a new window for your convenience. You may also submit a help ticket if you need additonal help.
The rest of this document is a customized version of the documentation distributed with the Sympa product.
Mailing lists - Owner and moderator guide
Introduction: who is in charge of managing mailing lists?
Reminder: a mailing list service involves four types of roles:
listmaster owner moderator subscriber
Refer to the description of each role to know more about this.
Requesting the creation of a mailing list
Only the MBARI listmaster may create new mailing lists. To create a new mailing list, do as follows:
Go to the list environment homepage and log on as firstname.lastname@example.org. In the top menu, click on the 'Create list' link.
Give your list a name (only enter the name without the '@listserver.mbari.org'.
Do not use any spaces, accents or specials characters in list names: those characters might cause problems. Choose an explicit yet short name: think of the subscribers who will have to type this name every time they will send a message to the list! If you manage a set of lists, you can prefix your lists' names with a common prefix; thus they will be sorted together and will be easily recognizable (example: email@example.com, firstname.lastname@example.org, etc.).
Choose a list type among the predefined types (the predefined types are only examples of typical configurations that can be changed by the list owners after creation; it is even possible to configure the list beyond the options offered in the list administration module, by asking the listmasters). Enter a subject for your list. This subject will display as a header for all the list pages, and will also be visible on list index pages (list of lists, list of your subscriptions, etc.) and in the browser title bar.
Choose a topic in the 'Topics' drop-menu.
Enter a description for your list. This description will display on the list information page and in the 'Subscribers Charter' sent by email to each new subscriber, under the 'List subject' heading.
You can format your list description with HTML tags. Be careful: if your description is long, cut it with manual line breaks (ENTER key of your keyboard); otherwise, it might not be entirely visible in your browser window.
Click on the 'Submit your creation request' button.
Managing a list
To manage a list you own, do as follows:
Go to the list environment homepage and log on. Go to the home page of the list you want to manage. In the left-hand menu, click on the 'Admin' link.
To browse the sections of the administration module, click on the links below the 'Admin' link, in the left menu.
Those different sections allow you to perform various functions. Please keep in mind that you agreed "not to change any list parameters that I may have access to through the list manager software" when you requested your list server. Modifying list parameters may cause the list to stop functioning.
configure the list; customize files related to the list; manage subscribers; manage the message archive of the list; manage bounces; create, delete or restore the shared document web space; rename the list; delete the list.
The options available in the 'Moderate' submenu allow you to:
moderate messages sent to the list; moderate documents available in the shared document web space; moderate pending subscriptions.
Configuring the list
To learn how to configure the list, please refer to the documentation about list configuration.
Customizing the list
From this page, you can edit a number of files relating to your list, among which:
typical messages sent to subscribers in particular occasions: welcome message: this message is the notice sent to people who just subscribed. You should write a charter for your list and add it in this welcome message. You can create a structured MIME message (reserved to the MIME format experts); unsubscribe message: this message is sent to people unsubscribing from the list; deletion message: this message is sent to people you unsubscribe from the list (DEL command), especially because their address caused bounces; remind message: this message is sent to subscribers as a personalized reminder when using the REMIND command. This command is essential to the good management of your list since many bounces are due to people whose current address is not their subscription address anymore, or even who forgot that they were subscribed to the list; subscribing invitation message: this message is sent to people you invite to subscribe to the list using the INVITE command; notice of message rejected by the moderator: this message is sent to the sender of a message rejected by the moderator; notice of message rejected because of a virus: this message is sent to the sender of a message in which a virus was found. miscellaneous files: list description: the list description is sent by email in return to the INFO command. By default, it is also included in the welcome message (subscription notice). It is not the same as the list presentation page displayed on the mailing list web interface; list homepage: this description is available on the information page of the list. It can be in HTML format. Even though you do not use this format, use
<br />tags to indicate line breaks;
message header: when available, it is added as a MIME attachment at the beginning of each message distributed to the list; message footer: when available, it is added as a MIME attachment at the end of each message distributed to the list.
This section lets you browse the list of all the list subscribers. For each subscriber, the following information is available:
email address; domain of the email address (@cru.fr, @sympa.org, @fai.com, etc.); picture (if that feature was activated for the list); name (according to the subscription method, it is not always displayed); message delivery mode; data source indicating the origin in case the subscriber is included in the list and not directly subscribed; date of subscription to the list; latest update of the subscriber options.
To search for a subscriber, enter all or part of his/her email address or name in the input field and click on the 'Search' button.
You can subscribe other people to the list from this page:
To add a single person, enter his/her email address in the input field and click on the 'Add' button. To add several persons, click on the 'Multiple add' button. In the input field that displays, enter the email addresses and names of the people you want to subscribe to the list and click on 'Add subscribers'.
Even though you have the possibility to subscribe people to your mailing lists, it is always much better that people take the necessary steps to subscribe themselves to the list. You can also invite people to subscribe to the list through the INVITE command: send an email to email@example.com and type the following command in the message body: invite nameofthelist emailaddress (example: invite list_name john.doe(@)mbari.org).
To accept or reject the subscription requests to the list, click on 'Pending subscriptions'. The list of all people who requested subscription to the list displays. To accept or reject a request, tick the box in front of a person's name and click on the button of your choice.
To send a subscription reminder to all subscribers, click on the 'Remind all' button. The subscription reminder message contains:
The name of the list to which the subscriber is subscribed The email address with which the subscriber is subscribed A link to the information page of the list A clickable address in order to allow subscribers to unsubscribe from the list
To unsubscribe subscribers from this page, select them by ticking the boxes in front of their names and click on the 'Delete selected email addresses' button.
To change a subscriber's options, click on his/her email address. From this page, you can change the name, email address and message delivery mode of the subscriber. You can also unsubscribe him/her.
If the subscriber is bouncing, another form displays under the 'Subscriber information' form. The information displayed involves:
The type of error (in English); The number or errors; The period during which errors occurred.
You can check the latest error or reset errors. If you reset errors, the subscriber's score will be reset to zero.
To manage bouncing addresses more easily, go to the 'Bounces' page of the list administration module.
When there is a problem with subscribers' email addresses (obsolete email addresses, addresses temporarily unavailable when messages were sent, inbox quota exceeded, etc.), the percentage of bouncing addresses displays in the left menu under the text 'Error rate'. To check the bouncing addresses, go to the 'Bounces' page of the list administration module.
The Sympa software automatically manages bouncing subscribers: according to the number of errors and to the traffic on the list, bouncing subscribers are either notified, unsubscribed, or their score is reset to zero when their address stops bouncing.
To make addresses stop bouncing, select them by ticking their boxes and click on the 'Reset errors for selected users' button. If the error remains, the addresses will be reported as bouncing again as soon as a message is posted on the list.
You can also unsubscribe subscribers whose addresses are still bouncing: too many bouncing addresses cause a considerable load on the mailing list server. To unsubscribe subscribers, select them by ticking the boxes in front of their names and click on the 'Delete selected email addresses' button.
Tip: to select all subscribers at once, first make sure that they are all displayed on the page, and then click on the 'Toggle selection' button: all subscribers will be selected in a single click!
Moderating messages sent to the list
When a list is moderated, all messages have to be approved of by one of the moderators before being distributed to the list. After sending a message to a list, subscribers are automatically notified by email that their message will be moderated. As for moderators, they also receive a notice message from Sympa, which includes the message to moderate.
You can perform moderating tasks either by email, by answering the messages received from Sympa, or through the mailing list web interface. To do that, click on the 'Message' link in the 'Moderate' submenu: you are brought to a page that displays all messages to be moderated (the most recent messages are on top of page). To read a message, click on its subject.
You have two options:
Authorize the message distribution on the list; Reject the message and notify sender: when you reject a message, it is better to notify its sender...
All moderators can decide to distribute a message or not. However, the first moderator to process the message will carry the day. You will be notified by Sympa if you try to process a message that has already been moderated. When there are several moderators, it is easier to moderate messages from the mailing list web interface: thus, you will be able to view all messages remaining to be moderated.
Whatever the date and time of moderation, the date and time of sending of the message do not change. Thus, if the distribution of the message is allowed with a lot of delay, it is possible to receive a message dated January 1st on December 31st!
Checking the 'Add to blacklist' checkbox both skips the rejection notification and adds the message author to the list's own blacklist. You can manage the blacklist via the 'edit blacklist' button at the bottom of the page.
If you wish to customize the rejection message that is sent to a message author, you can do so via the 'Manage rejection messages' button. The message management page will let define a set of rejection messages and define the default one.
Managing the message archive
The Sympa list server software can generate downloadable compressed archives (.ZIP format) of the messages sent to the list. To download those archives, you must be logged into the web interface as a list administrator. Go to the Admin section of the list home page and then select the Manage Archives tab. Select the months that interest you in the list and click on the 'Download Zip file' button. You will receive a file named 'nameofthelist_archive.zip' (example: detritus_archive.zip) containing folders named 'nameofthelist_year-month' (example: detritus_2017-06) for each month. Inside each folder, the file names are numbers representing their position in the chronology of the messages sent (example: the file named '1' contains the first message sent in the month). The message files have no extension; use the text editor of your choice (Notepad, WordPad, Vim, etc.) to open them. Each file represents an entire message (full header).
From the 'Manage archive' page, you can also delete messages month by month and not message by message. To do that, select the months that interest you in the list and click on the 'Delete selected months' button.
Be careful: this operation is irreversible!!! When you click on 'Delete selected months', keep in mind that you are not only deleting an archive file, but also the entire message archive of the selected month!!!
Deleting the list
In the list administration module, click on 'Remove list'. A confirmation message displays; click on 'OK'. Be careful! If you delete the list, you will not be able to reopen it yourself!!! If you want to reopen the list, you will have to ask I.S. In real terms, what are the consequences of a list deletion?
All subscribers are immediately unsubscribed automatically (including owners and moderators). The message archive is preserved but no one can access it anymore. The documents published in the shared document web space are preserved but no one can access them anymore. Only the listmasters have the power to reopen the list; if they do, the former list subscribers will automatically be subscribed again.
In order to have dynamic lists, you must be deeply involved in their exchanges: if a list is neither controlled nor enlivened by its owners, it may result in a loss of quality in its messages and it might even end up vanishing...
The use of email in general and for mailing lists is bound by a set of precise rules necessary to share pleasant exchanges: the "Netiquette". As a list owner or moderator, it is your role to have subscribers respect it. You will find the general principles of the Netiquette, as well as many links on the page of the Wikipedia dedicated to the Netiquette.
You should write a charter for your list to define all the rules that apply to its use: