Update mailman documentation

Signed-off-by: Michal Konecny <mkonecny@redhat.com>
This commit is contained in:
Michal Konecny 2024-04-26 10:30:55 +02:00 committed by zlopez
parent e95876ffbc
commit 995b1e25ab

View file

@ -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=<username>;``
+
** By email (only primary mail is used)
+
``UPDATE auth_user SET is_staff = TRUE, is_superuser = TRUE WHERE email=<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