h1. Montée d'un serveur Publik en version Debian 11 (Bullseye)

Cette page explique comment mettre à jour un serveur hébergeant les applications Publik pour passer de la version Debian 10 (Buster) à la version Debian 11 (Bullseye).

h2. Préparation de l'environnement

Pensez à *vérifier les sauvegardes* . Si possible, faire une image (snapshot) ou une sauvegarde juste avant la mise à jour.

S'assurer que les outils de supervision et de gestion des configuration sont compatibles avec Debian 11.

Vérifier que la ou les machines en Debian 10 sont bien à jour :

<pre>
# apt update
# apt full-upgrade
</pre>

Mise à jour préalable de *PostgreSQL* : si le serveur de base de données est séparé, il doit être mis à jour *avant* les serveurs d'applications Publik. Il faut passer en *Postgresql version 13* au minimum. Voir plus bas dans ce document pour une procédure si la machine est une Debian.

h2. Préparation de la mise à jour

Dans le cas d'une configuration à plusieurs nœuds, faire *un serveur après l'autre*. Ne jamais faire de mise à jour simultanée sur plusieurs nœuds. 

Arrêter le système de _cron_ :

<pre>
# systemctl stop cron
</pre>

Modifier les dépôts APT pour y indiquer "bullseye" comme base. Il s'agit typiquement de mettre à jour le fichier @/etc/apt/sources.list@ et ceux contenus dans le répertoire @/etc/apt/sources.list.d/@. Exemple de manipulation pour faire cette modification :

<pre>
# sed -i 's/buster/bullseye/g' /etc/apt/sources.list
# sed -i 's/buster/bullseye/g' /etc/apt/sources.list.d/*
# sed -i 's!bullseye/updates!bullseye-security!g' /etc/apt/sources.list
</pre>

Prise en compte de ces nouveaux dépôts :

<pre>
# apt update
</pre>

Installation des dépôts et fichiers de préférences APT relatifs à Publik sur les environnements de production :

<pre>
# apt install entrouvert-repository entrouvert-repository-hotfix && sudo apt update
</pre>

S'il s'agit d'un environnement de *test* / *pré-production*, et uniquement pour ceux là :

<pre>
# apt install entrouvert-repository entrouvert-repository-testing && sudo apt update
</pre>

h2. Lancement de la mise à jour

Très classiquement :

<pre>
# apt update
# apt full-upgrade
</pre>

h2. Passage en PostgreSQL version 13

Si le serveur d'application héberge aussi la base de données, après la montée de version vers Debian 11 il faut lancer la montée de version de PostgreSQL. En effet, deux clusters subsistent à la suite de la mise à jour, un actif en version 11 (venant de Debian 10) et l'autre en version 13 (installé par la mise à jour Debian 11).

Il s'agit de basculer vers le cluster en version 13 et de désactiver celui en version 11.

La documentation pour cela est sur @/usr/share/doc/postgresql-common/README.Debian.gz@. De façon pratique, la procédure revient à ces commandes :

<pre>
# sudo -u postgres pg_dropcluster --stop 13 main
# sudo -u postgres pg_upgradecluster -m upgrade -k -j 4 11 main
# sudo -u postgres reindexdb --concurrently --all -j 4
# systemctl disable postgresql@11-main.service
</pre>

Le 4 dans le « -j 4 » de la réindexation est à adapter selon le nombre de CPU.

*Attention* : le « -k » du pg_upgrade accélère la migration et fait gagner de l'espace, mais *rends le cluster 11 hors d'usage*. Si vous souhaitez conserver le cluster 11, ne l'utilisez pas. Dans tous les cas vérifier vos sauvegardes avant la mise a jour.

h2. Nettoyage

À la suite de la mise à jour, un nettoyage des paquets inutiles peut être fait.

<pre>
# apt autoremove
</pre>

Puis un redémarrage complet de la machine est nécessaire pour passer sur le dernier noyau et réactiver les _crons_.