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 en complément de la validation des prérequis de toute Mise à jour de BlueMind.
Vérifier les points de vigilance
Version de BlueMind
Afin de pouvoir passer en BlueMind 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, vérifier la taille spool rapide et s'assurer de disposer d'au moins 50% de libre.
Réseau
Le port KeyDB doit être autorisé.
Pour plus d'informations, voir : Les ports
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 :
Lancer le test d'éligibilité
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.
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
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
Problèmes corrigés
Affichage de la signature dans le composeur
La signature n'est pas visible dans le composeur mais bien présente dans l'e-mail reçu par le destinataire.
↳ corrigé dans les versions 5.2.7 et 5.3.1
Réf. BM-22080
Reliquat de données cyrus après migration de v4 en v5
Des données restent dans le spool cyrus après le passage en v5. Il s'agit de mails qui ont été marqués 'Expunged' par cyrus que nous ne reprenons pas lors de la mise à jour.
Ces fichiers sont situés dans les répertoires suivant :
/var/spool/cyrus/data//var/spool/cyrus/meta/Il ne s'agit normalement pas d'un grand volume de mail.
↳ corrigé dans la version 5.3.2
Réf. BM-21846
Erreur d'enregistrement des brouillons
Sur certaines installations, les brouillons des utilisateurs du webmail BlueMind (mailApp) ne s'enregistrent pas et l'e-mail ne peut alors pas être envoyé. Le problème ne concerne pas systématiquement tous les brouillons.
⇒ Contournement : actualiser la page avec la commande ctrl+F5 qui désactive le websocket nginx.
↳ corrigé dans les versions 5.2.9 et 5.3.1
Réf. BM-22000
Problèmes en attente de correction
Icône mail dans la liste des contacts
Depuis l'application contact, le raccourci d'envoi d'e-mail de la liste des contact renvoie vers l'ancienne interface webmail :
Activation de Let's Encrypt
Sur certaines installations il n'est plus possible d'accepter les conditions générales de Let's Encrypt après un passage en version 5.
⇒ Contournement : utiliser la commande bm-cli suivante :
bm-cli certificate manage-lets-encrypt
Réf. BM-21613
Ouverture des liens "mailto"
Dans le cas où l'ancienne interface webmail a été supprimée, les utilisateurs n'ayant pas le role "Accès au nouveau webmail" ne pourront pas afficher l'option de configuration des liens mailto dans les options de BlueMind.
⇒ Contournement : donner ce role aux utilisateurs.
Pour plus d'informations, voir :
Réf. BM-21735
Bouton d'accès à la visioconférence BlueMind
Le bouton de lancement rapide d'une visioconférence a disparu de l'ancien bandeau de bluemind.
💡 Ce problème ne concerne que le bandeau noir, qui n'apparait que si l'utilisateur utilise l'ancien webmail pour lire ses mails.
Réf. BM-21977
Erreur au tri d'un dossier dans l'ancien webmail
Le tri par expéditeur dans l'ancien webmail génère une erreur serveur si le dossier en cours est trop gros. Une fois l'erreur serveur apparue, les e-mails du dossier de l'utilisateur ne seront plus récupérés.
⇒ Contournement : passer par les paramètres de tri de l'application (au lieu d'un clic en haut de colonne) pour remettre le tri par date.
Réf. BM-22019
Disparition des boîtes partagées
https://forge.bluemind.net/jira/browse/BM-22058
Les utilisateurs abonnés à des boites aux lettres partagées et utilisant l'ancien webmail de Bluemind peuvent se retrouver perdus sur la nouvelle : leurs BAL partagées ne sont plus affichées dans le bandeau à gauche de leur écran. S'ils sont toujours abonnés à ces boites, il leur faudra passer par leurs propres paramètres pour s'abonner aux différentes boites au lettres qui leur sont partagées. Bien qu'il ne s'agisse pas d'un bug, compte tenu de l'impact auprès des utilisateurs concernés parfois déroutés, nous prévoyons d'abonner automatiquement chaque utilisateur aux boites qui lui sont partagées lors de la mise à jour.
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