|
|
| (7 intermediate revisions by 3 users not shown) |
| Line 2: |
Line 2: |
| {{shortcut|ISOP:MAILMAN}} | | {{shortcut|ISOP:MAILMAN}} |
|
| |
|
| Provides mailing list services for Fedora Hosted projects (hosted1) or the Fedora Project (collab1).
| |
|
| |
|
| == Contact Information ==
| | This SOP has moved to the fedora Infrastructure SOP git repo. Please see the current document at: http://infrastructure.fedoraproject.org/infra/docs/mailman.txt |
| Owner: Fedora Infrastructure Team
| |
|
| |
|
| Contact: #fedora-admin, sysadmin-main, sysadmin-tools, sysadmin-hosted group
| | For changes, questions or comments, please contact anyone in the Fedora Infrastructure team. |
|
| |
|
| Location: ?
| |
|
| |
|
| Servers: hosted1, collab1
| |
|
| |
| Purpose: Provides mailing list services.
| |
|
| |
| == Description ==
| |
|
| |
| Mailing list services for Fedora Hosted projects are located on the hosted1.fedoraproject.org server. Fedora Project mailing lists are on collab1.
| |
|
| |
| == Common Tasks ==
| |
|
| |
| === Creating a new mailing list ===
| |
|
| |
| 1. Log into hosted1 or collab1
| |
| 1. sudo /usr/local/bin/fedora-mailing-list-setup
| |
|
| |
| <pre>
| |
| [you@hosted1 ~] $ sudo /usr/local/bin/fedora-mailing-list-setup
| |
| Password:
| |
| Project name: project
| |
| List name: project-devel
| |
| Admin username: username # This is the admin user for the list.
| |
| FAS Username: yourfasusername # This is the admin adding the lists username
| |
| FAS Password: # This is the fas password for the admin user adding the list.
| |
| [you@hosted1 ~] $
| |
| </pre>
| |
|
| |
| Note that list names should make sense, and not contain the words 'fedora' or 'list' - the fact that it has to do with Fedora and that it's a list are both obvious from the domain of the email address.
| |
|
| |
| == Troubleshooting and Resolution ==
| |
|
| |
|
| |
|
| |
| == List Administration ==
| |
|
| |
| The mailman site password for hosted1 or collab1 can be found it /root/mm_sitepass
| |
|
| |
| <pre>
| |
| sudo cat /root/mm_sitepass
| |
| </pre>
| |
|
| |
| The site password can be used to reset lists admin passwords if required.
| |
| Note: If you change the site password, please update this file.
| |
|
| |
|
| |
| == ML password reset ==
| |
|
| |
| When a user has requested their mailman password be reset go to the mailing list admin interface at:
| |
|
| |
| https://fedorahosted.org/mailman/admin/<MailingListName>
| |
|
| |
| Use the site-admin password (see above) to log in, set the password to something. Then email the list admin the new password as well as asking them to change it.
| |
|
| |
| === Restart Procedure ===
| |
| If the server needs to be restarted mailman should come back on it's own. Otherwise each service on it can be restarted:
| |
|
| |
| <pre>
| |
| sudo service mailman restart
| |
| sudo service postfix restart
| |
| </pre>
| |
|
| |
| === How to delete a mailing list ===
| |
|
| |
| Delete a list, but keep the archives
| |
| <pre>
| |
| sudo /usr/lib/mailman/bin/rmlist <listname>
| |
| </pre>
| |
|
| |
| Delete a list and its archives
| |
| <pre>
| |
| sudo /usr/lib/mailman/bin/rmlist -a <listname>
| |
| </pre>
| |
|
| |
| == Mailman migration ==
| |
|
| |
| {{draft}}
| |
| This is a place where instructions for migrating lists from redhat.com to lists.fp.o will be kept.
| |
|
| |
| Things required from Red Hat:
| |
|
| |
| * The list config (whatever the equivalent of /var/lib/mailman/lists/<listname> is)
| |
| * The list archives, in mbox form (/var/lib/mailman/archives/private/<listname>.mbox)
| |
|
| |
| Put these items into their respective places on collab1.
| |
|
| |
| If required at this point, change the list name as follows:
| |
|
| |
| * Rename the archive and list directories to the new names
| |
| * Create a file called <newlist-name>.config and put the following in it:
| |
| <pre>
| |
| real_name = '<new list name>'
| |
| </pre>
| |
| * Don't do anything with that file until the next step :)
| |
|
| |
| For all lists, do the following:
| |
|
| |
| * In the <newlist-name>.config file created earlier, add the following line (create the file if you didn't need to rename the list):
| |
| <pre>
| |
| acceptable_aliases = [ 'old-list-name@redhat.com' ]
| |
| </pre>.
| |
|
| |
| * Verify the sanity of your new configuration via '/usr/lib/mailman/bin/config_list -i <new-list-name>.config -c <new-list-name>
| |
| * If that checks out, eliminate the -c from the previous command in order to make your changes.
| |
| * generate aliases for the new list /usr/lib/mailman/bin/genaliases
| |
| * change the url for the list /usr/lib/mailman/bin/withlist -l -r fix_url <new-list-name> -u admin.fedoraproject.org
| |
| * Rebuild the archives using '/usr/lib/mailman/bin/arch --wipe <new-list-name>'
| |
| * restore selinux contexts restorecon -rv /var/lib/mailman/lists /var/lib/mailman/archives/private
| |
|
| |
| === Additional steps ===
| |
| * rebuilding the archives means all links to the historical mailing lists posts will be broken. Can we get Red Hat to add http redirects from www.redhat.com/archives/<old-list-name> to the lists.fedoraproject.org/archives/<new-list-name> ?
| |
| * we'll need Red Hat to set up forwarding aliases for <old-list-name> to <new-list-name>
| |
| * fix the names of list that do not make any sense (e.g. feodra-extras-steering) in the current environment. relevant
| |
| [[Category:Infrastructure SOPs]] | | [[Category:Infrastructure SOPs]] |
| [[Category:Hosted Projects]]
| |
