Mise à jour de version majeure de BlueMind : passer de v4 en v5
Le changement de version majeure de BlueMind requiert une attention toute particulière sur un certain nombre de points. Nous conseillons une lecture attentive de la page suivante, permettant de préparer au mieux le passage à la nouvelle version.
Vérifier les points de vigilance
Prérequis à l'installation
Comme pour toute mise à jour, il est important de s'assurer que les prérequis à l'installation d'une version 5 de BlueMind sont validés.
Pour plus d'informations, voir :
BlueMind recommande une attention particulière aux prérequis d'espace disque, ceux-ci ayant évolué avec la version 5.5 : Prérequis à l'installation : Espace Disque.
Version de BlueMind
Afin de pouvoir passer en version 5, la version 4 doit être installée et à jour de la dernière version disponible.
Système
Espace disque
En vue de la montée de version de PostgreSQL de 14 en 16, la partition /var/lib/postgresql doit avoir un taux d'occupation inférieur à 50%.
De même, dans le cas où un archivage est en place, il est nécessaire de disposer d'au moins 50% de libre dans la taille du spool rapide.
Réseau
- Le port KeyDB doit être autorisé.
Pour plus d'informations, voir : Les ports - L'URL externe doit être accessible.
Pour plus d'informations, voir :
Matériel
Les prérequis matériel ont évolué entre BlueMind 4 et BlueMind 5. Il est fortement recommandé de consulter la page Dimensionnement matériel afin d'ajuster la configuration du serveur.
Configurations spécifiques
Configuration CAS
Dans BlueMind 5 la configuration CAS s'effectue par domaine et non plus pour l'ensemble du serveur comme en v4. La configuration CAS du serveur n'est donc pas migrée.
Configuration OpenID
Dans le cas d'un déport du service d'authentification, s'assurer de la bonne configuration de celui-ci et d'être en possession d'une url accessible depuis le serveur BM.
Pour plus d'informations, voir :
- Mise en place du SSO avec un serveur d'authentification OpenID externe
- Configurer un client OpenID pour BlueMind avec un Keycloak tiers
Installation avec serveur Edge
Dans le cas d'une installation avec un serveur Edge non géré par BlueMind, corriger la configuration Nginx de celui-ci.
Problèmes post-mise à jour
Consulter les problèmes connus en fin de page : Problèmes connus
Lancer le test d'éligibilité {check-upgrade}
Ce test d'éligibilité doit impérativement être réalisé avant de mettre à jour BlueMind de v4 en v5.
Un test d'éligibilité check-upgrade-v5 a été ajouté au Client CLI pour l'administration afin d'éviter toute perte de données et assurer une mise à jour en v5 maîtrisée et sécurisée.
Ce test vérifie ces 5 points majeurs :
- Checking custom settings
- Checking hotupgrades
- Checking elasticsearch cluster status
- Checking cyrus replication
- Cyrus email checks
Exécuter et valider le test
- Lancer le test en exécutant la commande suivante :
bm-cli setup check-upgrade-5 --force-delete-many-orphans
Selon le dimensionnement, la commande chek-upgrade-5 peut durer plus d'une heure. Il est recommandé de l'exécuter dans une session screen ou tmux.
Le test et les opérations de maintenance qui suivent peuvent être gourmandes en ressources.
Il est donc recommandé de les exécuter pendant des créneaux de faible activité assez longs, par exemple en fin de journée.
Des commandes de réparation à exécuter sont ensuite proposées, selon les défauts identifiés.
La liste de commandes se présente comme suit (exemple) :
Recommended repair commands to run:
bm-cli hotupgrade start --no-delay --scheduled
bm-cli index coherency --all --run-consolidate --workers=1 all
bm-cli maintenance repair --ops replication.parentUid 1518B471-729C-4C99-AEC0-86D4D87DCB12@734ea413.internal
bm-cli maintenance repair --ops replication.parentUid,message_bodies B9584543-273B-43F0-A450-09FCB38526A6@734ea413.internal
- Lancer une nouvelle vérification une fois les réparations recommandées effectuées. Cela permet de rafraîchir la liste des erreurs et de potentiellement remonter celles qui n'ont pas été reportées ou réparées précédemment.
Transmettre les résultats
Il est fortement recommandé de transmettre à notre équipe Support le résultat des exécutions successives de ces commandes de test via la création d'un ticket.
Mettre à jour la souscription
La mise à jour de BlueMind lors d'un changement de version majeure nécessite un changement des adresses des dépôts logiciels. Le fichier de souscription doit donc être mis à jour afin de pouvoir réaliser le changement de version. Pour plus d'informations, voir Mise en œuvre de la souscription.
Purger les corbeilles
Lors de la reprise des données, les mails contenus dans le double fond de la corbeille et les brouillons marqués pour suppression (anciennes versions de brouillons) ne sont pas migrés.
Afin de libérer l'espace disque, nous recommandons donc de réaliser la purge de ces messages avant la mise à jour (il s'agit d'un processus propre au serveur Cyrus, qui n'est plus utilisé en version 5) avec la commande suivante :
cyr_expire -X 0
Effectuer ensuite une réparation des boîtes avec les options suivantes :
bm-cli maintenance repair --ops missed.deletions all
Lancer la mise à jour de BlueMind
Une fois les prérequis et le test d'éligibilité validés :
-
Suivre la procédure de Mise à jour de BlueMind
⚠️ Support
En cas de difficulté, créer un ticket contenant les informations suivantes :
- le contenu de
/var/log/au format tgz ou zip. Si trop important, fournir au minimum ces logs :/var/log/bm/core.log/var/log/bm/imap.log/var/log/bm-webserver/webserver.log/var/log/bm-webserver/setup.log/var/log/bm-keycloak/keycloak.log/var/log/postgresql/postgresql-??-main.log
- le retour de ces commandes :
bm-cli node status
bmctl status
nproc
free -m
df -h;
uptime
- le contenu de
-
Nettoyer les sauvegardes v4
⚠️ Une fois la mise à jour terminée, il est recommandé de purger les sauvegardes de BlueMind 4.
En effet, BlueMind 5 sauvegarde les e-mails selon une nouvelle méthode dans
/var/backups/bluemind/sds-spool. La première sauvegarde reprend tous les e-mails, ce qui peut déclencher une alerte de saturation du disque si l'espace disponible est < 50%.Les sauvegardes v4 ne sont plus compatibles. Les supprimer permet de regagner de l'espace.
Lancer les opérations post-mise à jour
Opérations BlueMind automatiques
Des opérations en arrière-plan sont exécutées suite à la mise à jour. Elles ont été prévues pour tourner sans impacter le service en production.
Certaines fonctionnalités sont débloquées au fil de l'eau suite à ces opérations post-ugrade. Il s'agit en particulier des tris avancés sur les e-mails et le paramétrage des conversations de messages.
Pour contrôler le bon avancement des opérations post-upgrade, lancer la commande :
bm-cli hotupgrade progress --details --filterSuccess
Si ces opérations sont en échec, un bandeau s'affiche dans la console d'administration et l'indique aux administrateurs. Dans ce cas, créer un ticket (ou mettre à jour celui concernant le test d'éligibilité - voir ci-dessus) sur notre outil de suivi de tickets.
Configuration Nginx
Si la configuration Nginx pour un domaine a été personnalisée, copier le fichier /etc/nginx/bm-local.d/<domain>.conf vers /etc/nginx/bm-local.d/<xxxxxtechnical_domain>/ et mettre à jour la configuration dans celui-ci.
Problèmes connus
Les quotas de certaines boites sont très différents après la mise à jour
Les quotas en version 5 ne sont pas calculés de la même manière qu'en version 4, dans laquelle les données remontées par Cyrus manquaient de fiabilité.
Dans certains cas, des boites peuvent donc apparaitre plus ou moins remplies qu'elles ne l'étaient avant la mise à jour.
Réf. BM-22057
Tâche DataProtect en erreur
Lors de la mise à jour vers Bluemind 5, parmi toutes les opérations qui ont lieu, un changement de spool de mail est opéré : les mails sont migrés depuis le spool cyrus vers un spool spécifique à Bluemind.
Pendant cette opération, la tâche de DataProtect ne fonctionne pas correctement et tombe en erreur — s'il y a plusieurs terra-octets de mail, cette opération peut prendre plusieurs jours (le temps reste dépendant de la vitesse des disques, en plus du volume de données).
Réf. BM-22759
Filtres non terminaux
Les filtres de messagerie créés depuis les anciennes préférences étaient obligatoirement terminaux : une fois un filtre appliqué à un message, aucun autre filtre n'était appliqué.
Avec le nouveau webmail et les nouvelles préférences, il est désormais possible de choisir si un filtre est terminal ou non.
Lors de la mise à jour de BlueMind 4 en BlueMind 5, cette option n'est pas activée par la reprise des filtres, ainsi tous les filtres sont non terminaux et peuvent entrainer des tris confus pour les utilisateurs.
Réf. BM-22085