This chapter describes the creation and maintenance of distribution lists that are stored in the directory.
Note: This feature can be used to expand Internet only addresses. Other types of lists are also possible:
Those stored in files which must be maintained manually. These are described in Chapter 12,
File Based Distribution Lists.
To setup and use file Internet directory based distribution lists you need to do the following: • create and configure a internet directory list channel which will expand distribution lists
found in the directory.
• create the list using the Internet Mailbox Management console • assign members and other information to the list.
11.1
Creating an Internet distribution list
channel
If you do not have a Internet distribution list channel, or wish to create a second channel to expand lists, on the Switch Configuration Management tab, expand the Message Transfer Agents node, and the mta below that. Then with the Channels node selected, either right click and choose New Channel or choose Operations → New Channel. Then provide the following answers when prompted by the wizard:
• Channel Type select List: expands Internet Distribution Lists • Channel Name name it idlist
as shown in Figure 11.1, “Internet List channel creation”.
After creating the idlist channel, you should edit it so that the Program page looks like
Figure 11.2, “Internet List channel (Program page)”.
Figure 11.2. Internet List channel (Program page)
11.2
Creating a list
You can now create a new distribution list. To do this: 1. Open the tab Internet Mailbox Management 2. Click on the button Add Distribution List.
3. Choose the type of list you wish to create. A Standard Distribution List is a regular distribution list containing a fixed list of members. A Dynamic distribution list is the same, but can additionally contain a search expression to dynamically resolve members by means of a directory search.
4. For a dynamic address a search expression needs to be entered. This is any valid search expression, and should be a valid ldap filter URL. It can be changed more easily later in the editor page.
5. For both types of list, a list name is required. This is the address users will send to to expand the list.
Figure 11.4. Creating the list - step 2.
6. A list owner may be specified at this time, together with a single list member if required. These can both be filled in or altered later.
7. Finally the list channel is selected. There is normally only one of these. 8. Click Finish to create the list.
Figure 11.5. Mconsole, showing details of the new list.
You should test that this user is routed correctly by the local MTA by running the command ckadr as shown below:
Example 11.1. Output from ckadr
C:\Program Files\Isode\bin>ckadr [email protected]
[email protected] -> (rfc822) [email protected] [email protected] -> (x400)
/RFC-822=test4(a)attlee2k.isode.com/O=attlee2k/PRMD=TestPRMD/ ADMD=TestADMD/C=GB/ Delivered to attlee2k.isode.com by idlist (weight: 0)
Each distribution list Internet address may have a related Internet address which is the owner of the list. When list expansion takes place, the recipient is replaced by the members of the list and the originator is replaced by the list owner if set, or left unchanged otherwise. It is normally a good idea to set up such an owner address unless a specific behaviour is required. As a result non-delivery reports for members normally go to the list owner rather than the originator of the message.
11.3
Configuring the list attributes
The list page is divided into several tabs to keep related information together.
11.3.1
The List
The List tab holds the key features of the list. These are:
• Email addressses of mailbox contains the email address of the list. Alternate addresses may be specified here.
• Owner is the email address of the owner of the list. This will recieve delivery reports. It is sometimes common to name this listname-request and introduce an alias to the real owner.
• Delivery Channel is a designated list channel to expand the list. There is normally only one of these.
11.3.2
Members
• Sublists are references to directly included sublists. These are other list entries that will be expanded directly at the same time, including duplicate elimination. Buttons are availbe to Add distinguished names, Remove them and Editexisting entries.
• List Members are the internet addresses of the members of the list. There are buttons to Add new members, Remove selected members, and Edit existing addresses. Also available are buttons to Import a list of address from a file one per line, and Export the list to a file.
11.3.3
Admin
• The List Policy allows the list submission policy to be set. This may be one of: • Open whereby there are no restrictions on who may submit.
• Closed where only existing members of the list may submit to it. • Owner in which only the owner of the list can submit.
• Specified using the list of addresses specified below.
• The Submitting Members is a list of those members allowed to submit to the list if the policy is set to those
• The List Priority sets the priority of the message after list expansion. It may be set to Pass the original priority through unchanged; to Cap priority to a given level, which allows the priority to be passed through if less than or equal to the given value, else capped to the value; or finally it can be explicitly Set to the given priority.
11.3.4
Dynamic Members
If the list is a dynamic distribution list there is a tab for adding the dynamic expression and associated details.
• The Dynamic members is an LDAP URI that specifies the search expression to include members. Although it can be typed in by hand, it is usually best to use the Edit button which allows the components to be edited and the search to be tested out as shown in
Figure 11.6. The LDAP URI Editor for dynamic lists.
• The Exempted Members is a list of addresses that are explicitly excluded from the search. Thus these listed addresses will be removed from any search result.
11.3.5
Information
• Archive URI specifies a URI of an archive associated with the list. If specified it sets a header field List-Archive.
• Help URI specifies a URI of a help page or address associated with the list. If specified it sets a header field List-Help.
• Subscribe URI specifies a URI associated with subscribing to the list. If specified it sets a header field List-Subscribe.
• UnSubscribe URI specifies a URI associated with unsubscribing to the list. If specified it sets a header field List-UnSubscribe.