Difference between revisions of "Mailman 3 Service and Troubleshooting"

From Run Your Own
Jump to: navigation, search
(Manual Start and Restart)
Line 5: Line 5:
 
  systemctl status mailmanweb # AKA hyperkitty, postorius, uwsgi, django hell, needed for the web interface
 
  systemctl status mailmanweb # AKA hyperkitty, postorius, uwsgi, django hell, needed for the web interface
  
== Manual Start and Restart ==
+
== Troubleshooting ==
 +
=== Where is everything logged? ===
 +
 
 +
Don't think you can start understand anything without at least doing the following:
 +
* mailman core
 +
tail -f /home/mailman/we.lurk.org/mm/var/logs/*
 +
tail -f /var/log/mail.err /var/log/mail.log /var/log/mail.warn
 +
journalctl --follow _SYSTEMD_UNIT=mailman3.service + _SYSTEMD_UNIT=mariadb.service
 +
* web stuff
 +
tail -f /home/mailman/we.lurk.org/web/logs/*
 +
tail -f /var/log/nginx/*log
  
 +
=== Running mailman standalone ===
 
'''Only do this when manually troubleshooting otherwise this will conflict with <code>systemctl</code> initiated services.'''
 
'''Only do this when manually troubleshooting otherwise this will conflict with <code>systemctl</code> initiated services.'''
 
=== Basics ===
 
 
* Mailman 3 relies on its own mailman user to handle the processing of the emails.
 
* Mailman 3 relies on its own mailman user to handle the processing of the emails.
 
  su mailman    # switch to the mailman user
 
  su mailman    # switch to the mailman user
Line 19: Line 28:
 
  mailman stop        # stop mailman
 
  mailman stop        # stop mailman
 
  mailman restart      # stop and start mailman shorcut
 
  mailman restart      # stop and start mailman shorcut
 
== Troubleshooting ==
 
 
Don't think you can start understand anything without at least doing the following:
 
* mailman core
 
tail -f /home/mailman/we.lurk.org/mm/var/logs/*
 
tail -f /var/log/mail.err /var/log/mail.log /var/log/mail.warn
 
journalctl --follow _SYSTEMD_UNIT=mailman3.service + _SYSTEMD_UNIT=mariadb.service
 
* web stuff
 
tail -f /home/mailman/we.lurk.org/web/logs/*
 
tail -f /var/log/nginx/*log
 
 
  
  

Revision as of 16:37, 1 January 2024

Service Configuration and Installation

There are two services needed:

systemctl status mailman3   # AKA mailman-core you only need this for lists to work
systemctl status mailmanweb # AKA hyperkitty, postorius, uwsgi, django hell, needed for the web interface

Troubleshooting

Where is everything logged?

Don't think you can start understand anything without at least doing the following:

  • mailman core
tail -f /home/mailman/we.lurk.org/mm/var/logs/*
tail -f /var/log/mail.err /var/log/mail.log /var/log/mail.warn
journalctl --follow _SYSTEMD_UNIT=mailman3.service + _SYSTEMD_UNIT=mariadb.service
  • web stuff
tail -f /home/mailman/we.lurk.org/web/logs/*
tail -f /var/log/nginx/*log

Running mailman standalone

Only do this when manually troubleshooting otherwise this will conflict with systemctl initiated services.

  • Mailman 3 relies on its own mailman user to handle the processing of the emails.
su mailman     # switch to the mailman user
cd             # make sure you cd to mailman's home !IMPORTANT
  • You're now ready to control mailman
  • Everything is handled with the mailman command line tool. Do not run these commands with another user!
mailman status       # report on the service
mailman start        # start mailman
mailman stop         # stop mailman
mailman restart      # stop and start mailman shorcut