Service/lists: Difference between revisions

← Older edit

Latest revision as of 20:12, 23 January 2026

Hostnames

Hosted on

Machine/bender

Administrative contact

For problems concerning a specific mailing-list, please contact the individual administrator reported on in the mailing-list summary page
Technical contact for Mailman and general sugarlabs.org email routing: postmaster AT sugarlabs DOT org

Sysadmins

For non-emergency calls, preferably send email to the administrative contact above.

Requesting a new mailing list

The best way to start a new mailing list is to begin a discussion on a related list that already exists, and once the discussion becomes active, to ask for a separate list for that topic or that sort of traffic.

When you have a critical mass of people regularly talking about the same topic, request a mailing list by emailing the following information to the administrative contact:

The name you want for your mailing list, with alternative names if the first one is taken
A description of the list, its purpose, and why it's needed (being able to say "we've been talking on this other list for a while, and the discussion has grown too big - see these archive links" is helpful)
The name/email of the list admin, and of at least one other moderator (minimum one admin and one moderator)
At least 10 names/emails of people who want to be the initial subscribers

It may take up to 48h to hear a response back, so please be patient!

Notes

User	`mailman`
Home	`/opt/mailman`
Daemon	`/etc/systemd/system/mailman3.service` `/etc/systemd/system/mailmanweb.service` `/etc/systemd/system/uwsgi.service`
Logs	`/var/log/nginx` `/opt/mailman/web/logs/` `/opt/mailman/mm/var/logs/`
Config	`/etc/nginx/sites-available/mailman.sugarlabs.org` `/etc/mailman3/*`
Ports	`443` HTTP server `ss -tnlp` View service ports
Admin scripts	`/opt/mailman/mm/bin/`

Sysadmin Recipes

Adding a new a mailing list

Login to mailman user.

Create the list:

python3 create-list.py --list LISTNAME

Mailman3 has separate parts and the core communicates with a REST API, the script is aimed to make it easier to create a list, and can be viewed to see how to authenticate to the API.

Send additional instructions to list administrator

I created the new list LISTNAME@lists.sugarlabs.org.

You are the list admin, and should have received a welcome message
with your admin password. You can share this role with others, if
you wish, or nominate one or more moderators.

Feel free to make any configuration changes you need. In particular,
you may want to add a meaningful summary and description of what this
list is about. Please, notify systems@ if you change security or privacy
related settings.

After making changes to any config, restart all three services as django has quite the persistent cache.

@@ Line 1: / Line 1: @@
 == Hostnames ==
-* http://lists.sugarlabs.org/
+* https://lists.sugarlabs.org/
-* http://lists.ole.org/
+* https://mailman.sugarlabs.org/
 == Hosted on ==
-[[Machine/sunjammer]]
+[[Machine/bender]]
 == Administrative contact ==
@@ Line 13: / Line 12: @@
 * For problems concerning a specific mailing-list, please contact the individual administrator reported on in the mailing-list summary page
 * Technical contact for Mailman and general sugarlabs.org email routing: '''postmaster AT sugarlabs DOT org'''
 == Sysadmins ==
-For non-emergency calls, preferably send email to the administrative contact.
+For non-emergency calls, preferably send email to the administrative contact above.
 * [[User:bernie|Bernie Innocenti]]
-* [[User:SMParrish|Steven Parrish]]
+* [[User:Chimosky|Chihurumnaya Ibiam]]
-== Recipes ==
+== Requesting a new mailing list ==
-=== Change virtual host of a list ===
+The best way to start a new mailing list is to begin a discussion on a related list that already exists,
+and once the discussion becomes active, to ask for a separate list for that topic or that sort of traffic.
- bin/withlist -l -r fix_url bolivia -u lists2.ole.org
+When you have a critical mass of people regularly talking about the same topic, request a mailing list by
+emailing the following information to the administrative contact:
-=== Change a parameter on all lists ===
+# The name you want for your mailing list, with alternative names if the first one is taken
+# A description of the list, its purpose, and why it's needed (being able to say "we've been talking on this other list for a while, and the discussion has grown too big - see these archive links" is helpful)
+# The name/email of the list admin, and of at least one other moderator (minimum one admin and one moderator)
+# At least 10 names/emails of people who want to be the initial subscribers
- echo "nondigestable = True" >bar
+It may take up to 48h to hear a response back, so please be patient!
- for l  in `bin/list_lists  -b`; do  bin/config_list -i bar  -v $l ; done
+== Notes ==
- rm bar
-=== Migrating lists from one host to another ===
+{| class="wikitable"
+|-
+!scope="row" | User
+|{{Code|mailman}}
+|-
-To migrate lists from solarsail to sunjammer, I did the following:
+|-
+!scope="row" | Home
+|{{Code|/opt/mailman}}
+|-
+!scope="row" | Daemon
+|
+{{Code|/etc/systemd/system/mailman3.service}}<br>
+{{Code|/etc/systemd/system/mailmanweb.service}}<br>
+{{Code|/etc/systemd/system/uwsgi.service}}<br>
+|-
+!scope="row" | Logs
+|
+{{Code|/var/log/nginx}}<br>
+{{Code|/opt/mailman/web/logs/*}}<br>
+{{Code|/opt/mailman/mm/var/logs/*}}<br>
+|-
+!scope="row" | Config
+|
+{{Code|/etc/nginx/sites-available/mailman.sugarlabs.org}}<br>
+{{Code|/etc/mailman3/*}}<br>
+|-
+!scope="row" | Ports
+|
+{{Code|443}} HTTP server<br>
+{{Code|ss -tnlp}} View service ports<br>
+|-
+!scope="row" | Admin scripts
+|
+{{Code|/opt/mailman/mm/bin/}}<br>
+|-
-* Lower TTL for lists.sugarlabs.org to 30 minutes
+|}
-* Copy over config before cut-off:
+== Sysadmin Recipes ==
-  ssh solarsail
+=== Adding a new a mailing list ===
-  cd /var/lib/mailman/lists/
-  rsync -aP aslo bugs colombia community-news dextrose fourthgrademath gsoc iaep italia marketing slobs soas somosazucar sugar-desarrollo sugar-devel sugar-reports  systems systems-logs root@sunjammer:/var/lib/mailman/lists/
-  cd /var/lib/mailman/archives/private
-  rsync -aP aslo* bugs* colombia* community-news* dextrose* fourthgrademath* gsoc* iaep* italia* marketing* slobs* soas* somosazucar* sugar-desarrollo* sugar-devel* sugar-reports* systems* systems-logs* root@sunjammer:/var/lib/mailman/archives/private/
-* Copy over the lists.sugarlabs.org bits from the Postfix configuration (<code>/etc/postfix/main.cf</code> and <code>/etc/postfix/transport</code>)
+* Login to mailman user.
-* Test admin pages and archives on the new site (hint: set the new IP for lists.sugarlabs.org in /etc/hosts)
+* Create the list:
-* [[Sysadmin/Announcing_downtime|Announce downtime]] on all affected lists
+ python3 create-list.py --list LISTNAME
-* Stop mailman on solarsail
+Mailman3 has separate parts and the core communicates with a [https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/rest.html REST API],
+the script is aimed to make it easier to create a list, and can be viewed
+to see how to authenticate to the API.
-* Switch over DNS records (with default TTL values)
+* Send additional instructions to list administrator
-* Remove mailman transport map from solarail, leaving the relay, so that anything@lists.sugarlabs.org gets sent to sunjammer
+ I created the new list LISTNAME@lists.sugarlabs.org.
+ You are the list admin, and should have received a welcome message
+ with your admin password. You can share this role with others, if
+ you wish, or nominate one or more moderators.
+ Feel free to make any configuration changes you need. In particular,
+ you may want to add a meaningful summary and description of what this
+ list is about. Please, notify systems@ if you change security or privacy
+ related settings.
-* Restart mailman on solarsail
+After making changes to any config, restart all three services as django has quite the
+persistent cache.
 == See Also ==
 * [[Mailing_Lists]]
-* [[Sysadmin/Add_mailing_list]]
 [[Category:Service|zzz]]