Skip to main content
Version: 5.4

BlueMind Major Version Update: Upgrade from v4 to 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 Updating BlueMind.

Check the points to watch​

BlueMind Version​

Afin de pouvoir passer en BlueMind 5, la version 4 doit être installée et à jour de la dernière version disponible.

System​

Disk space​

In view of PostgreSQL's upgrade from version 14 to 16, the /var/lib/postgresql partition must have an occupancy rate of less than 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.

Network​

Hardware​

Hardware requirements have changed between BlueMind 4 and BlueMind 5. Il est fortement recommandé de consulter la page Hardware Sizing afin d'ajuster la configuration du serveur.

Specific setup​

CAS configuration​

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.

OpenID configuration​

In the case of a remote authentication service, ensure that it is properly configured and that you have a URL accessible from the BM server.

For further information, see :

Installation with Edge server​

In the case of an installation with an Edge server not managed by BlueMind, correct its Nginx configuration.

Post-upgrade problems​

Consulter les problèmes connus en fin de page :

Starting eligibility test​

Execution required

This Eligibility Test must not be completed before updating BlueMind from v4 to v5.

Un test d'éligibilité check-upgrade-v5, complété par un test de vérification pre-upgrade-5, ont été ajoutés au CLI Admin Client afin d'éviter toute perte de données et assurer une mise à jour en v5 maîtrisée et sécurisée.

These tests verify these 5 major points:

  • Checking custom settings
  • Checking hotupgrades
  • Checking elasticsearch cluster status
  • Checking cyrus replication
  • Cyrus email checks

Execute and validate tests​

  1. Run the eligibility test by executing the following command:

    bm-cli setup check-upgrade-5 --force-delete-many-orphans

    ⚠️ Test duration and resource consumption

    Depending on sizing, the chek-upgrade-5 command can take over an hour. It is recommended to run in a screen or tmux session.
    Testing and subsequent maintenance operations can be resource-intensive.
    It is therefore recommended to perform them during long periods of low activity, for example at the end of the day.

  2. Execute the suggested repair commands, according to the faults identified.
    The command list follows as follows (example):

    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

  3. Lancer le test de vérification une fois les réparations recommandées effectuées.
    To do this, run the following command in a screen or tmux session:

    bm-cli setup pre-upgrade-5

    This allows you to refresh the list of errors and potentially track those that have not been reported or repaired.

Transmitting results​

Il est fortement recommandé de transmettre les deux fichiers de logs générés (check-upgrade-5 et pre-upgrade-5) à l'équipe Support via la création d'un ticket.

Updating subscription​

Subscription must be updated only when the eligibility test is valid.

Updating BlueMind when a major version is changed requires a change of software repository addresses. The subscription file must therefore be updated for you to perform the version upgrade. For further information, see Setting up the subscription.

Purging trash​

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.

To free up disk space, we recommend purging these emails before the upgrade (this is a Cyrus server-specific process, no longer used in version 5) with the following command:

cyr_expire -X 0

Then repair the mailboxes using the following options:

bm-cli maintenance repair --ops missed.deletions all

Running BlueMind Update​

Une fois les prérequis et le test d'éligibilité validés :

  1. Suivre la procédure de Updating BlueMind

    ⚠️ Support

    If you encounter any difficulties, create a ticket containing the following information:

    • the contents of /var/log/ in tgz or zip format. If too large, please provide at least the following 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
    • the return of these commands: 
      bm-cli node status
      bmctl status
      nproc
      free -m
      df -h; 
      uptime

  2. Clean up backups v4

    ⚠️ Once the upgrade is complete, it is recommended that you purge the BlueMind 4 backups.

    BlueMind 5 backs up e-mails using a new method in /var/backups/bluemind/sds-spool. The first backup includes all e-mails, which can trigger a disk saturation alert if the available space is < 50%.

    V4 backups are no longer compatible. Removing them saves space.

Running post-upgrade operations​

Automatic BlueMind operations​

Background operations are performed after the update. They have been designed to run without impacting the service in production.

Some features are unlocked over time following these post-ugrade operations. These include advanced e-mail sorting and message conversation settings.

To check the progress of post-upgrade operations, run the command :

bm-cli hotupgrade progress --details --filterSuccess

If these operations fail, a banner appears in the administration console, informing administrators. In this case, create a ticket (or update the one concerning the eligibility test - see above) on our ticket tracking tool.

Nginx configuration​

If the Nginx configuration for a domain has been customized, copy the /etc/nginx/bm-local.d/<domain>.conf file to /etc/nginx/bm-local.d/<xxxxxtechnical_domain>/ and update the configuration there.

Known issues​

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

Ref. 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

Ref. 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

Ref. BM-22000

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 :

↳ corrigé dans les versions 5.3.3 et 5.4.1

Ref. BM-21003

Problèmes en attente de correction​

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).

Ref. BM-22759

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

Ref. 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.

For further information, see :

Ref. 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.

Ref. 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.

Ref. BM-22019

Disparition des boîtes partagées​

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.

Ref. BM-22058

Non-terminal filters​

The mail filters created since the old preferences were obligatorily terminal: once a filter had been applied to an email, no other filter was applied.
With the new webmail and preferences, you can now choose whether a filter is terminal or not.
When upgrading from BlueMind 4 to BlueMind 5, this option is not activated by the filter recovery, so all filters are non-terminal and can lead to confusing sorting for users.

Ref. BM-22085

Find out more​

Related BlueMind documentation pages

Related BlueMind Blog articles