HOWTO install and configure ezmlm-web on sme server:

Original Author:  Graeme Robinson
Update Author:
  Ray Mitchell - mitchellcpa_AT_yahoo.com.au
Release supported: SME 5.5, 5.6, 6.0
License:
GPL
Last updated: Friday 30 January 2004
Revision Number:  2

 


Problem:  You want to instal a mailing list manager

Solution:  Follow the steps in this HowTo

Information:  Revision 1 is copied from the original by Graeme Robinson and revised where necessary to suit the new rpms and instal requirements released in September & October 2002 & minor additions and improvements have been included. Significant changes have occurred compared to earlier versions, in particular the implementation of a web interface which is integrated into server manager. Revision 2 includes new download site locations and confirms support for sme v6.0.

Please be aware that the ezmlm contributed rpms are works in progress and newer versions may be released with different functionality so check the download sites to see if any later versions have been released.

Thanks to Gordon Rowell for developing the rpms, and to Gordon Rowell, Charlie Brady & Graeme Robinson for assisting me to update this HOWTO.

The ezmlm web interface has been tested & works on sme server v6.0 & no problem reports have been received. 

For further information please refer to the ezmlm.idx manual and faq at: http://www.glasswings.com.au/ezmlm/

Most of the information contained in this document is there in much greater detail.


 

STEP 1: Install the software: 

 

Log on as root or sudo and do the following:

FTP=ftp://ftp.ibiblio.org/pub/linux/distributions/e-smith/contrib/GordonRowell/RPMS/

rpm -Uvh $FTP/i386/ezmlm-idx-std-0.40-2.i386.rpm

rpm -Uvh $FTP/i386/perl-Ezmlm-0.03.1-1.i386.rpm

rpm -Uvh $FTP/i386/ezmlm-web-2.1-06.i386.rpm

rpm -Uvh $FTP/noarch/e-smith-ezmlm-web-1.1.1-05.noarch.rpm

 

Alternatively download the rpms to a folder and do

rpm -Uvh *.rpm

 

After the rpms have been installed or updated do

/sbin/e-smith/signal-event post-upgrade

/sbin/e-smith/signal-event reboot

 

 


 

STEP 2: Post install: 

 

When the server reboots and you log on to server manager, you will find a new menu item underCollaboration called Mailing Lists. This allows you to create a list with a set of modifiable default settings and set the list owner, the list administrator and also add subscribers either individually or from an existing text file and modify other configuration settings. The web interface panel allows you to select configuration options by checking tick boxes.

 


 

ADDITIONAL INFORMATION 

 

Possible problems where an earlier version was installed:

 

A couple of bugs were found during testing of earlier versions, you should update to the latest versions.

Then Modify any list and the proper permissions should be set up.

If you have installed and configured ezmlm with earlier versions of rpms in particular either or both

e-smith-ezmlm-web-1.1.1-04.noarch.rpm

and

ezmlm-web-2.1-04.i386.rpm

and receive an error message when trying to Modify the list Configuration then you need to change permissions in the ezmlm folder by doing the following:

chown ezmlm:ezmlm ~ezmlm

You should also update to the latest rpms.

If you have installed the earlier non web interface version of ezmlm on a e-smith 4.1.2 server and have upgraded the server to 5.x or 6.x and wish to upgrade to the latest ezmlm-web, you may have problems getting ezmlm to work. The new web version was deliberately made incompatible with the old non web version. You will need to do an upgrade installation (rpm -Uvh rpmname) and then manually copy the ezmlm list folder(s) from their old location to /home/e-smith/files/ezmlm/lists.

In earlier non web versions of ezmlm in e-smith 4.1.2, list folders were created in CAPITAL letters. These folders should be renamed to lower case before the ezmlm configuration can be modified using server manager web panel.

 


 

List creation: 

 

The switches and their meaning is summarized here. Note references for the faq and manual for ezmlm that should be referred to in full if you are going to manage these lists.

The check boxes set the following switches. An important point to remember is that leaving these switches out will not prevent a list behavior necessarily. Most switches have a default that will be used if you leave a setting out - check the faq carefully. The switches set are good safe settings but be warned they may not serve your purposes.

Here are the standard settings:

Note that these are set by checking or unchecking the appropriate tick boxes.

aBdfgHiJklMnOpQrStuWx

a =creates an archived list

B =archive access permitted (see g switch)

d =list digest will be created

f =prefix set so subject prefixed with listname

g =guard archive so only list members have access

H =subscription requires confirmation by a reply sent to subscription address

i =indexed for www archive access

J =unsubscribe requires confirmation by a reply sent to sub address

k =addresses in /deny are rejected.

l =sets up subscriber lists so remote admins can access them

M = message posting isn't moderated

n =setups up the list to allow remote administrators to edit files in /text

O =posts other than subscriber-originated are rejected

p =allow remote admin and archive retrieval

Q =don't process 'request' command

r =enable remote administration

S =subscriptions are not moderated

t =trailer; /text/trailer will be added to outgoing messages (editable by RA)

u =uses posts only

W =no address restriction

x =eXtra. Ezmlm-make will configure the list with a few extras such as stripping annoying mime parts such as excel spreadsheets, rtf text, html text etc from the messages. Messages consisting solely of this Content-type will be rejected

 


 

Common Usage/Configuration Misinterpretations: 

 

The "Others rejected" and "User posts only" switches should be used separately (not together) as they effectively counteract each other, unless of course you want "subscribers not moderated" behaviour for your list.

The message moderation only works for posts from subscribers when these two switches (Others rejected; User posts only) are not checked, or for non-subscriber posts, if one or both the other switches are checked.

Also you may not want to use the "User post only" switch with the "Message moderation" switch. Doing so allows subscribers and "allow" people to post without moderation.

Users are encouraged to carefully read the manual and test the behaviour of their list to ensure it does what you require.

 


 

Known bugs for fixing in next release: 

 

The description field for the plain english description of each list can only be set when the list is first created.

The description is not modifiable later (it was in earlier versions).

You can modify it from the command prompt by doing:

/sbin/e-smith/db accounts setprop mylist Description "Description of list"

 


 

Setting the attachment size for list messages: 

 

The default message attachment size is quite small (30Kb). If you wish to change the attachment size then edit the msgsize file.

Remember though, that if you have a large list of subscribers and send a message with a large attachment to the list, your server may be busy (and slow) for quite a while as the message with attachment is sent to all subscribers individually.

cd ~ezmlm/lists/listname

or

cd /home/e-smith/files/ezmlm/lists/listname

pico msgsize

change the value from

30000:2

to say

1000000:2

Ctrl o

Ctrl x

Alternatively you can include in the message a URL link to a website or ftp location where the attachment can be read or downloaded. This avoids sending large attachments to list subscribers who may not wish to receive them and also helps to reduce web traffic. The list subscriber can visit the web or ftp site if they wish to obtain the file attachment.