Changes

Jump to navigation Jump to search
61 bytes removed ,  20:08, 20 March 2022
no edit summary
Line 1: Line 1:  +
 +
=== Version ===
 +
{{ #smeversion: smeserver-ezmlm-web}}
 +
{{ #smeversion: ezmlm-idx}}
 +
 
===Install and configure ezmlm-web on SME Server===  
 
===Install and configure ezmlm-web on SME Server===  
   −
Before starting, uninstall any previous versions of ezmlm you have installed as this version is not compatible with earlier versions.
+
Before starting, uninstall any previous versions of ezmlm (prior ezmlm-idx-std-5 and ezmlm-idx-7.2.2) you have installed as this version is not compatible with earlier versions.
   −
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.
   −
Thanks to Gordon Rowell for developing the rpms.
+
For further information please refer to the ezmlm.idx manual and faq at http://www.glasswings.com.au/ezmlm/ or http://untroubled.org/ezmlm/faq/
   −
For further information please refer to the ezmlm.idx manual and faq at http://www.glasswings.com.au/ezmlm/
+
====Installation====
or from the EZFAQ at http://ezmlm.org/faq/index.html
+
<tabs container><tab name="For SME 10">
 +
yum install --enablerepo=smecontribs smeserver-ezmlm-web
    +
then go to you server-manager for configuring your first mailing lists
 +
</tab>
 +
<tab name="For SME 9 and earlier">
   −
====Installation====
  −
  −
The ezmlm rpms are located in the smecontribs repository
  −
  −
ezmlm-idx-std
  −
ezmlm-web
  −
perl-Ezmlm
  −
smeserver-ezmlm-web
      
Install the packages with yum
 
Install the packages with yum
Line 29: Line 30:  
  signal-event reboot
 
  signal-event reboot
   −
(Note: Requires the complete reconfigure + reboot to stop Warning appearing in server manager re this.)
+
Alternatively you can
 
  −
If required to get the panel to appear in the correct location in server manager under Collaboration (ignore all warnings that appear on screen)
     −
  /etc/e-smith/events/actions/navigation-conf
+
  expand-template /etc/ezmlm/ezmlmwebrc
 +
expand-template /etc/httpd/admin-conf/httpd.conf
 +
expand-template /etc/httpd/conf/httpd.conf
 +
expand-template /home/e-smith/files/ezmlm/lists/webusers
 +
service httpd-admin restart
 +
service httpd-e-smith restart
 +
config set UnsavedChanges no
   −
====Upgrading from other versions====
+
# Upgrading from other versions
    
Refer this thread http://forums.contribs.org/index.php?topic=40851.new;topicseen#new
 
Refer this thread http://forums.contribs.org/index.php?topic=40851.new;topicseen#new
Line 46: Line 51:     
Backup your ezmlm data first ie all of /home/e-smith/files/ezmlm/
 
Backup your ezmlm data first ie all of /home/e-smith/files/ezmlm/
 +
 +
</tab>
 +
</tabs>
 +
 +
    
====Configuration====
 
====Configuration====
    
When you log on to server manager, you will find a new menu item under Collaboration 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.
 
When you log on to server manager, you will find a new menu item under Collaboration 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.
 +
 +
    
==='''Creating, Configuring and Using Mail Lists'''===
 
==='''Creating, Configuring and Using Mail Lists'''===
   −
To be added
  −
This section deals with how to set up and use mail lists, and the various commands available to Manage lists remotely.
      +
The initial panel to create and manage access rights:
 +
 +
[[File:Mailinglist-ezmlm.png]]
   −
===Additional information===
+
The ezmlm-web interface where you can handle all possible options to manage your list.
 +
 
 +
[[File:Ezmlm-Subscribe.png]]
 +
 
 +
 
 +
There is also a panel userpanel-mailinglist to allow you to delegate only management of designated lists to one or more users. You will need to install also [[UserManager]] to allow access to this interface and more.
   −
If you receive an error message when trying to Modify the list Configuration then you need to change the ezmlm folder so it has the correct permissions by doing the following:
     −
  chown ezmlm:ezmlm ~ezmlm
+
If you want you can also use various commands available to Manage lists remotely or from command line. Please refer to the documentation at  http://untroubled.org/ezmlm/
      Line 67: Line 84:     
The switches and their meaning is summarized here.  
 
The switches and their meaning is summarized here.  
Both the FAQ and manual for ezmlm should be read fully to give you a complete understanding of the functionality of ezmlm.
+
Both the [http://untroubled.org/ezmlm/faq/ FAQ] and [http://untroubled.org/ezmlm/manual/ manual] for ezmlm should be read fully to give you a complete understanding of the functionality of ezmlm.
   −
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 value that will be used if you leave a setting out - check the faq carefully. The switches set are good safe settings but they may not serve your purposes.  
+
The check boxes set the following switches. An important point to remember is that leaving these switches out will not prevent a list behaviour necessarily. Most switches have a default value that will be used if you leave a setting out - check the faq carefully. The switches set are good safe settings but they may not serve your purposes.  
    
=====Default settings=====
 
=====Default settings=====
Line 178: Line 195:  
Users are encouraged to carefully read the manual and test the behavior of their list to ensure it does what you require.
 
Users are encouraged to carefully read the manual and test the behavior of their list to ensure it does what you require.
   −
  −
====Known bugs for fixing in next release====
  −
  −
=====modify description after creation=====
  −
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"
  −
  −
=====removing mailing lists=====
  −
{{note box|msg=resolved in [[bugzilla:3599]]}}
  −
  −
List deletion gives an error and the list does not get deleted.
  −
  −
You need to manually delete folders & files and remove the database entry at the command prompt
  −
  −
rm -R -f /home/e-smith/files/ezmlm/lists/listname
  −
rm /home/e-smith/files/ezmlm/.qmail-listname*
  −
db accounts delete listname
      
====Setting the attachment size for list messages====
 
====Setting the attachment size for list messages====
Line 207: Line 202:  
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.
 
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
  −
  −
Press Ctrl+O to save.
  −
  −
Press Ctrl+X to exit.
      
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.  
 
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.  
Line 232: Line 208:  
====Modifying the default configuration====
 
====Modifying the default configuration====
   −
The default configuration of each new list is controlled by the contents of /etc/ezmlm/ezmlmrc.
+
The default configuration of each new list is controlled by the contents of '''/etc/ezmlm/ezmlmrc'''.  
 
  −
Information about customizing ezmlmrc including these modifications can be found [http://ezmlm.org/faq/ezmlmrc.5.html here].
  −
 
  −
The following changes alter the default message attachmemt size (from 30,000 to 500,000) and change the reply to address to be the list address.
     −
Download the English configuration file from the following location:  
+
Information about customizing ezmlmrc including these modifications can be found [http://untroubled.org/ezmlm/man/man5/ezmlmrc.5.html here].
   −
http://mirror.contribs.org/smeserver/contribs/rmitchell/smeserver/contribs/ezmlm/ezmlmrc-config/english/ezmlmrc
+
You can edit the applicable sections of ezmlmrc to alter the default.
   −
and replace the current file located in /etc/ezmlm/ folder.
+
<u>Note that these new settings are applied when you create a new list.</u>
   −
A modified Spanish version of ezmlmrc is here:
+
If you have existing lists and wish to apply these changes then you will need to either:
 
+
* configure manually to the new settings your list via the web interface (recommended)
http://mirror.contribs.org/smeserver/contribs/rmitchell/smeserver/contribs/ezmlm/ezmlmrc-config/spanish/ezmlmrc
+
* configure manually to the config files present in the list individual folder i.e. /home/e-smith/files/ezmlm/lists/MYLISTNAME/
 
+
* delete all your lists, then download and replace the ezmlmrc file, and then recreate the lists. Upon recreation of the list the new defaults will be applied.
You can compare the files to see the differences using the diff command (assuming you copy the new file to /tmp) eg
  −
 
  −
diff /etc/ezmlm/ezmlmrc /tmp/ezmlmrc
  −
  −
Note that these new settings are applied when you create a new list.
  −
 
  −
If you have existing lists and wish to apply these changes then you will need to delete all your lists, then download and replace the ezmlmrc file, and then recreate the lists. Upon recreation of the list the new defaults will be applied.
      
If you wish to retain the data in existing lists, then you will need to backup your lists first.
 
If you wish to retain the data in existing lists, then you will need to backup your lists first.
Line 260: Line 225:  
Then, when you have finished recreating the list, copy your subscribers backup folders into each list.
 
Then, when you have finished recreating the list, copy your subscribers backup folders into each list.
   −
Alternatively you can edit the applicable sections of ezmlmrc
     −
around line 330
+
====Other usage tips====
   −
# max & min message size
+
If you wish to allow list users to send html messages or any other type of attachments, go to the configuration of the list and delete all entries under "Mime types to strip from all outgoing mail". Note that you can selectively remove entries that are applicable to the type of attachment you wish to only allow.
   −
</msgsize#x/>
+
===Additional command line actions you might need===
   −
30000:2
     −
Change this to suit your requirements eg
+
====Other usage tips====
 +
If you receive an error message when trying to Modify the list Configuration then you need to change the ezmlm folder so it has the correct permissions by doing the following:
   −
  # max & min message size
+
  chown ezmlm:ezmlm ~ezmlm
   −
</msgsize#x/>
+
====modify description after creation====
 +
The description field for the plain English description of each list can only be set when the list is first created.
   −
500000:2
+
The description is not modifiable later (it was in earlier versions).
   −
around line 314
+
You can modify it from the command prompt by doing:
   −
  # Headeradd needs to always exist but leave out stuff for sublists
+
  /sbin/e-smith/db accounts setprop mylist Description "Description of list"
 
  −
</headeradd#E^0/>
  −
 
  −
# Good for mailing list stuff (and vacation program)
  −
 
  −
Change this to suit your requirements eg
  −
 
  −
# Headeradd needs to always exist but leave out stuff for sublists
  −
 
  −
</headeradd#E^0/>
     −
Reply-To: <#L#>@<#H#>
+
====list migration from a domain to another====
 
  −
# Good for mailing list stuff (and vacation program)
  −
 
  −
====Other usage tips====
  −
 
  −
If you wish to allow list users to send html messages or any other type of attachments, go to the configuration of the list and delete all entries under "Mime types to strip from all outgoing mail". Note that you can selectively remove entries that are applicable to the type of attachment you wish to only allow.
  −
 
  −
==list migration from a domain to another==
      
you might need to move a list from a domain to another, following the forum (http://forums.contribs.org/index.php/topic,49078.0.html) you might execute this :
 
you might need to move a list from a domain to another, following the forum (http://forums.contribs.org/index.php/topic,49078.0.html) you might execute this :
Line 330: Line 277:  
  done
 
  done
   −
===migration from a server to another===
+
====migration from a server to another====
      Line 351: Line 298:  
Of course if you also change the domain you have to check what's above.
 
Of course if you also change the domain you have to check what's above.
   −
=== Bugs ===
+
====Sorry, only subscribers may post.====
 +
after changing server, or upgrading from aprevious version this could occurs for members previously on the list, while newly added members can post, or ut could occurs that you are not able to use the web panel and you get an error while trying to update the list. On the last version of smeserver-ezmlm-web we added few scripts to make the lists compatibles but in some cases you might need to run manual steps on every old list with issues to make them compatibles, Mostly it would be
 +
  ezmlm-make -++ /home/e-smith/ezmlm/lists/MYLIST
 +
  ezmlm-idx /home/e-smith/ezmlm/lists/MYLIST
 +
 
 +
For very old lists version some more complex steps might be needed refers to the file /usr/share/doc/ezmlm-idx-7.2.2/UPGRADE for details
 +
 
 +
== Bugs ==
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 
and select the smeserver-ezmlm component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-ezmlm|title=this link}}.  
 
and select the smeserver-ezmlm component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-ezmlm|title=this link}}.  
    
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-ezmlm|noresultsmessage="No open bugs found."}}
 
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-ezmlm|noresultsmessage="No open bugs found."}}
 +
 +
==Changelog==
 +
Only released version in smecontrib are listed here.
 +
 +
{{ #smechangelog: smeserver-ezmlm-web}}
 +
 +
 +
 
----
 
----
 
[[Category:Contrib]]
 
[[Category:Contrib]]
 
[[Category:Mail]]
 
[[Category:Mail]]
 +
[[Category:Mail:Mailinglists]]
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu