[mailman] init
This commit is contained in:
Maxime Alves LIRMM@home
parent
53ac4523ac
commit
2cfb26dfc8
313
content/mailman.rst
Normal file
313
content/mailman.rst
Normal file
@ -0,0 +1,313 @@
|
|||||||
|
mailman
|
||||||
|
#######
|
||||||
|
|
||||||
|
:date: 2021-06-21 13:00
|
||||||
|
:modified: 2021-06-21 13:00
|
||||||
|
:tags: mail mailing-list
|
||||||
|
:category: documentation
|
||||||
|
:slug: mailman
|
||||||
|
:authors: Ms.Leave-A-Mix
|
||||||
|
|
||||||
|
|
||||||
|
We have a mailman instance on the mail server that runs on Alpine Linux. Here's
|
||||||
|
a how-to install this mailman server.
|
||||||
|
|
||||||
|
|
||||||
|
I did this after a failed upgrade caused to Pip packages that I installed in the
|
||||||
|
same repository that alpine python packages. That caused troubles during the
|
||||||
|
upgrade from python3.8 to python3.9.
|
||||||
|
|
||||||
|
I backuped and removed /usr/lib/python3.{7,8}.
|
||||||
|
|
||||||
|
|
||||||
|
I'll barely follow the mailman documentation on "how to install mailman on a
|
||||||
|
virtual env".
|
||||||
|
|
||||||
|
|
||||||
|
--------
|
||||||
|
cleaning
|
||||||
|
--------
|
||||||
|
|
||||||
|
I had a huge problem with my previous mailman installation, that I did with Pip.
|
||||||
|
Pip mixed PyPi packages with my alpine-repo python packages (those that begins
|
||||||
|
with py3... and some others).
|
||||||
|
|
||||||
|
Here's how I did to clean my server :
|
||||||
|
|
||||||
|
I listed all installed packages and their content.
|
||||||
|
|
||||||
|
:code:`apk list -I|awk -F'[\}\{]' '{print $2}'|xargs -I'{}' apk info -L "{}" > /tmp/installed_packages_content`
|
||||||
|
|
||||||
|
Then I checked all the pacckages that had at least one file installed in the
|
||||||
|
:code:`/usr/lib/python3.9/site-packages` directory.
|
||||||
|
|
||||||
|
:code:`grep -E '((site-packages.*__init__.py)|(:$))' ./installed_packages_content |awk '/:$/{package=$0}/^usr/{usr=$0;if(prev!=package){print package;print $usr};prev=package}'|rev|cut -d'/ ' -f2-|rev`
|
||||||
|
|
||||||
|
|
||||||
|
I quickly realized that many of the directories in
|
||||||
|
:code:`/usr/lib/python3.9/site-packages` where created by pip. So I simply backuped this
|
||||||
|
folder, and then removed it. Then I looped on the list of alpine packages I got
|
||||||
|
to reinstall them.
|
||||||
|
|
||||||
|
:code:`apk list -I|awk -F'[\}\{]' '{print $2}'|xargs apk fix`
|
||||||
|
|
||||||
|
I saw that the py3-* packages and some others (certbot, certbot-nginx and
|
||||||
|
py-augeas) where causing errors. So I just reinstalled them.
|
||||||
|
|
||||||
|
:code:`apk del py3-* py-augeas certbot certbot-nginx`
|
||||||
|
|
||||||
|
:code:`grep "^py3" /tmp/installed_packages|xargs apk add`
|
||||||
|
|
||||||
|
:code:`apk add certbot certbot-nginx py-augeas`
|
||||||
|
|
||||||
|
|
||||||
|
------------
|
||||||
|
installation
|
||||||
|
------------
|
||||||
|
|
||||||
|
mailman
|
||||||
|
-------
|
||||||
|
|
||||||
|
https://docs.mailman3.org/en/latest/install/virtualenv.html
|
||||||
|
|
||||||
|
As I already had a mailman instance, I just had to do the following to create a
|
||||||
|
virtual environment.
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
cd /opt/mailman
|
||||||
|
chown -R mailman:mailman .
|
||||||
|
su mailman
|
||||||
|
python3.9 -m venv venv
|
||||||
|
source ./venv/bin/activate
|
||||||
|
echo 'source /opt/mailman/venv/bin/activate' >> /opt/mailman/.bashrc
|
||||||
|
|
||||||
|
Check if the version of pip you use is really the one of the virtual env :
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
(venv) {13:24} mail:/opt/mailman$ which pip
|
||||||
|
/opt/mailman/venv/bin/pip
|
||||||
|
|
||||||
|
|
||||||
|
:code:`pip install wheel mailman`
|
||||||
|
|
||||||
|
-- An error occured because "pg_config" did not exist. As I won't need psycopg2, I
|
||||||
|
-- just avoid this and install pymysql instead (I run a mysql database for my mail
|
||||||
|
-- server).
|
||||||
|
|
||||||
|
:code:`pip install pymysql`
|
||||||
|
|
||||||
|
I'll modify the mailman init to point to the one in the virtual environment.
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
vim /etc/init.d/mailman
|
||||||
|
|
||||||
|
|
||||||
|
#!/sbin/openrc-run
|
||||||
|
# Copyright 1999-2004 Gentoo Foundation
|
||||||
|
# Distributed under the terms of the GNU General Public License v2
|
||||||
|
NAME="mailman"
|
||||||
|
CONF=/etc/mailman.cfg
|
||||||
|
PIDFILE=`grep -o "^pid_file:.*" "$CONF"|cut -d' ' -f2`
|
||||||
|
BIN="/opt/mailman/venv/bin/mailman"
|
||||||
|
USER="mailman"
|
||||||
|
ENV_="MAILMAN_CONFIG_FILE=$CONF"
|
||||||
|
|
||||||
|
extra_commands="info conf"
|
||||||
|
|
||||||
|
depend() {
|
||||||
|
need mta
|
||||||
|
use logger
|
||||||
|
}
|
||||||
|
|
||||||
|
start_pre() {
|
||||||
|
sleep 0
|
||||||
|
}
|
||||||
|
|
||||||
|
start() {
|
||||||
|
ebegin "Starting mailman"
|
||||||
|
mkdir -p -m 0750 /var/run/mailman
|
||||||
|
chown mailman: /var/run/mailman
|
||||||
|
mkdir -p -m 0750 /var/log/mailman
|
||||||
|
chown mailman: /var/log/mailman
|
||||||
|
mkdir -p -m 0750 /var/lock/mailman
|
||||||
|
chown mailman: /var/lock/mailman
|
||||||
|
|
||||||
|
start-stop-daemon -S -p $PIDFILE -u $USER -e $ENV_ \
|
||||||
|
-x $BIN start --
|
||||||
|
eend 0
|
||||||
|
}
|
||||||
|
|
||||||
|
stop() {
|
||||||
|
ebegin "Stopping mailman"
|
||||||
|
start-stop-daemon -K -p $PIDFILE -e $ENV_ \
|
||||||
|
-x $BIN stop --
|
||||||
|
|
||||||
|
eend 0
|
||||||
|
}
|
||||||
|
|
||||||
|
status() {
|
||||||
|
ebegin "Mailman status"
|
||||||
|
eval $ENV_
|
||||||
|
$BIN status
|
||||||
|
eend 0
|
||||||
|
}
|
||||||
|
|
||||||
|
info() {
|
||||||
|
ebegin "Mailman info"
|
||||||
|
eval $ENV_
|
||||||
|
$BIN info
|
||||||
|
|
||||||
|
eend 0
|
||||||
|
}
|
||||||
|
|
||||||
|
conf() {
|
||||||
|
ebegin "Mailman configuration"
|
||||||
|
eval $ENV_
|
||||||
|
$BIN conf
|
||||||
|
|
||||||
|
eend 0
|
||||||
|
}
|
||||||
|
|
||||||
|
svc_restart() {
|
||||||
|
ebegin "Restarting mailman"
|
||||||
|
start-stop-daemon -K -p $PIDFILE -u $USER -e $ENV_ \
|
||||||
|
-x $BIN restart --
|
||||||
|
|
||||||
|
eend 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
Modify mailman.cfg according to new configuration (path.fhs.bin_dir)
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
[mailman]
|
||||||
|
layout: fhs
|
||||||
|
site_owner: root@freepoteries.fr
|
||||||
|
noreply_address: no-reply
|
||||||
|
|
||||||
|
[mta]
|
||||||
|
incoming: mailman.mta.postfix.LMTP
|
||||||
|
outcoming: mailman.mta.deliver.deliver
|
||||||
|
lmtp_host: 127.0.0.1
|
||||||
|
lmtp_port: 8025
|
||||||
|
smtp_host: 127.0.0.1
|
||||||
|
smtp_port: 25
|
||||||
|
|
||||||
|
[webservice]
|
||||||
|
hostname: 0.0.0.0
|
||||||
|
port: 8081
|
||||||
|
use_https: no
|
||||||
|
admin_user: root
|
||||||
|
admin_pass: password
|
||||||
|
api_version: 3.1
|
||||||
|
|
||||||
|
[database]
|
||||||
|
class: mailman.database.mysql.MySQLDatabase
|
||||||
|
url: mysql+pymysql://mailman:password@maria.freepoteries.fr/mailman?charset=utf8&use_unicode=1
|
||||||
|
debug: yes
|
||||||
|
|
||||||
|
|
||||||
|
[paths.fhs]
|
||||||
|
# Filesystem Hiearchy Standard 2.3
|
||||||
|
# http://www.pathname.com/fhs/pub/fhs-2.3.html
|
||||||
|
|
||||||
|
# BEGIN(MODIFY THIS)
|
||||||
|
bin_dir: /opt/mailman/venv/bin
|
||||||
|
# END
|
||||||
|
|
||||||
|
var_dir: /var/mail/mailman
|
||||||
|
queue_dir: /var/spool/mailman
|
||||||
|
log_dir: /var/log/mailman
|
||||||
|
lock_dir: /var/lock/mailman
|
||||||
|
etc_dir: /etc
|
||||||
|
ext_dir: /etc/mailman.d
|
||||||
|
pid_file: /var/run/mailman/master.pid
|
||||||
|
|
||||||
|
[language.master]
|
||||||
|
description: English (USA)
|
||||||
|
charset: utf-8
|
||||||
|
enabled: yes
|
||||||
|
|
||||||
|
[language.fr]
|
||||||
|
description: Français
|
||||||
|
charset: utf-8
|
||||||
|
enabled: yes
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
I also removed /etc/mailman/conf.d/mailman.cfg as it was unused.
|
||||||
|
|
||||||
|
|
||||||
|
Start the service and test a mailing list (i.e. test@lists.freepoteries.fr).
|
||||||
|
|
||||||
|
:code:`rc-service mailman start`
|
||||||
|
|
||||||
|
Check if the logs are not crying.
|
||||||
|
|
||||||
|
:code:`tail -n1000 /var/log/mailman/mailman.log`
|
||||||
|
|
||||||
|
|
||||||
|
Freeze the requirements.
|
||||||
|
|
||||||
|
:code:`pip freeze > /opt/mailman/requirements.txt`
|
||||||
|
|
||||||
|
Add the crontabs.
|
||||||
|
|
||||||
|
:code:`EDITOR=vim crontab -e -u mailman`
|
||||||
|
|
||||||
|
.. code-block:: crontab
|
||||||
|
|
||||||
|
0 2 * * * /opt/mailman/venv/bin/mailman digests --periodic
|
||||||
|
0 2 * * * /opt/mailman/venv/bin/mailman notify
|
||||||
|
|
||||||
|
|
||||||
|
Git commit all those changes before continuing.
|
||||||
|
|
||||||
|
|
||||||
|
mailman-web
|
||||||
|
-----------
|
||||||
|
|
||||||
|
Let's take care of the web interface.
|
||||||
|
|
||||||
|
You can check the documentation in the mailman-web repo/docs/index.rst .
|
||||||
|
|
||||||
|
You should be in the same virtualenv as before.
|
||||||
|
|
||||||
|
|
||||||
|
mailman-web needs the cryptography, as specified in the cryptography manual :
|
||||||
|
|
||||||
|
As If you are on Alpine or just want to compile it yourself then cryptography
|
||||||
|
requires a C compiler, a Rust compiler, headers for Python (if you’re not
|
||||||
|
using pypy), and headers for the OpenSSL and libffi libraries available on
|
||||||
|
your system.
|
||||||
|
|
||||||
|
The rust package is the compilator, and the cargo is the rust package manager.
|
||||||
|
|
||||||
|
:code:`apk add rust cargo`
|
||||||
|
|
||||||
|
:code:`pip install mailman-web mailman-hyperkitty`
|
||||||
|
|
||||||
|
Freeze requirements and git the files.
|
||||||
|
|
||||||
|
:code:`pip freeze > /opt/mailman/requirements.txt`
|
||||||
|
|
||||||
|
|
||||||
|
Migrate mailman new version.
|
||||||
|
|
||||||
|
:code:`mailman-web migrate`
|
||||||
|
|
||||||
|
:code:`mailman-web collectstatic`
|
||||||
|
|
||||||
|
:code:`mailman-web compress`
|
||||||
|
|
||||||
|
:code:`mailman-web compilemessages`
|
||||||
|
|
||||||
|
|
||||||
|
uwsgi
|
||||||
|
.....
|
||||||
|
|
||||||
|
"env pythonpath" was not taken into account by django, I changed the option by
|
||||||
|
settings "env = PYTHONPATH=/etc/mailman3".
|
||||||
|
|
||||||
|
TODO: Archivage
|
||||||
Loading…
Reference in New Issue
Block a user