From 995b1e25ab8395df0cb60f071d85b8470d6bdd9a Mon Sep 17 00:00:00 2001 From: Michal Konecny Date: Jun 25 2024 17:46:26 +0000 Subject: [PATCH 1/4] Update mailman documentation Signed-off-by: Michal Konecny --- diff --git a/modules/sysadmin_guide/pages/mailman.adoc b/modules/sysadmin_guide/pages/mailman.adoc index 525bf63..60b4dd5 100644 --- a/modules/sysadmin_guide/pages/mailman.adoc +++ b/modules/sysadmin_guide/pages/mailman.adoc @@ -7,7 +7,7 @@ Owner:: Contact:: #fedora-admin, sysadmin-main, sysadmin-tools, sysadmin-hosted Servers:: - mailman01, mailman02, mailman01.stg + mailman01, mailman01.stg Purpose:: Provides mailing list services. @@ -29,6 +29,43 @@ Please make sure to add a valid description to the newly created list. (to avoid [no description available] on listinfo index) ==== +=== Adding user as admin + +. Log in to db01 server +. Start the postgreSQL console ++ +``sudo -u postgres psql`` ++ +. Connect to hyperkitty DB ++ +``\connect hyperkitty`` ++ +. Add admin permissions to user +** By username ++ +``UPDATE auth_user SET is_staff = TRUE, is_superuser = TRUE WHERE username=;`` ++ +** By email (only primary mail is used) ++ +``UPDATE auth_user SET is_staff = TRUE, is_superuser = TRUE WHERE email=;`` + + +== Deployment + +In case of new deployment of mailman in infrastructure, there are few tasks +that need to be done manually. + +=== Migrating social accounts from OpenID Fedora to OpenIDC + +This needs to be done only once when you update from old OpenID Fedora auth provider +to OpenIDC version. Doing this will correctly map the old accounts to new auth provider. + +. Log into mailman01 +. ``cd /srv/webui/bin/`` +. ``python migrate_fedora_auth.py`` ++ +This script does nothing if the users were already migrated. + == Removing content from archives We don't. @@ -91,7 +128,7 @@ sudo -u mailman mailman3 members -R moderator example@example.com Specific users are marked as 'site admins' in the database. -Please file a issue if you feel you need to have this access. +Please file an issue if you feel you need to have this access. === Restart Procedure @@ -99,8 +136,9 @@ If the server needs to be restarted mailman should come back on it's own. Otherwise each service on it can be restarted: .... -sudo service mailman3 restart -sudo service postfix restart +systemctl restart mailman3 +systemctl restart postfix +systemctl restart mailmanweb .... == How to delete a mailing list From b32a0448ccd93a57fbac68deb33e137cf0821fcb Mon Sep 17 00:00:00 2001 From: Michal Konecny Date: Jun 25 2024 17:46:26 +0000 Subject: [PATCH 2/4] Add info how to access admin page in mailman Signed-off-by: Michal Konecny --- diff --git a/modules/sysadmin_guide/pages/mailman.adoc b/modules/sysadmin_guide/pages/mailman.adoc index 60b4dd5..49ff3fd 100644 --- a/modules/sysadmin_guide/pages/mailman.adoc +++ b/modules/sysadmin_guide/pages/mailman.adoc @@ -50,6 +50,17 @@ Please make sure to add a valid description to the newly created list. ``UPDATE auth_user SET is_staff = TRUE, is_superuser = TRUE WHERE email=;`` +=== Accessing admin page in mailman + +Admin page will allow you to change some of the settings that are not able to be changed +anywhere else. The admin page could be accessed link:https://lists.fedoraproject.org/django-admin +or link:https://lists.stg.fedoraproject.org/django-admin for staging. + +[NOTE] +==== +You need to be added as admin to mailman to access the admin console. +==== + == Deployment In case of new deployment of mailman in infrastructure, there are few tasks From 4816d8924a420b0ec672e0f2189ab83ef465dbf2 Mon Sep 17 00:00:00 2001 From: Michal Konecny Date: Jun 25 2024 17:46:26 +0000 Subject: [PATCH 3/4] Add log locations Signed-off-by: Michal Konecny --- diff --git a/modules/sysadmin_guide/pages/mailman.adoc b/modules/sysadmin_guide/pages/mailman.adoc index 49ff3fd..553e501 100644 --- a/modules/sysadmin_guide/pages/mailman.adoc +++ b/modules/sysadmin_guide/pages/mailman.adoc @@ -133,6 +133,14 @@ Get the list of moderators for example@example.com: sudo -u mailman mailman3 members -R moderator example@example.com .... +== How to delete a mailing list + +Delete a list, but keep the archives: + +.... +sudo -u mailman mailman3 remove +.... + == Troubleshooting and Resolution === List Administration @@ -152,10 +160,7 @@ systemctl restart postfix systemctl restart mailmanweb .... -== How to delete a mailing list - -Delete a list, but keep the archives: +=== Log locations -.... -sudo -u mailman mailman3 remove -.... +Most of the logs are located in `/var/log/mailman3/`. In case you are looking for +postfix logs, they could be found in `/var/log/maillog`. From b216207fdfe0cb57e2b01e4a6ec821f47d8f977b Mon Sep 17 00:00:00 2001 From: Michal Konecny Date: Jun 25 2024 17:46:26 +0000 Subject: [PATCH 4/4] Add known error messages Signed-off-by: Michal Konecny --- diff --git a/modules/sysadmin_guide/pages/mailman.adoc b/modules/sysadmin_guide/pages/mailman.adoc index 553e501..8cac006 100644 --- a/modules/sysadmin_guide/pages/mailman.adoc +++ b/modules/sysadmin_guide/pages/mailman.adoc @@ -164,3 +164,12 @@ systemctl restart mailmanweb Most of the logs are located in `/var/log/mailman3/`. In case you are looking for postfix logs, they could be found in `/var/log/maillog`. + +=== Known error messages + +These are the error messages that are common in mailman3 logs: + +* `NNTP error for list ` ++ +We don't have NNTP server and this couldn't be disabled in mailman3, so you +can saw this error in logs, but it could be ignored.