Zum Hauptinhalt gehen
Version: 5.4

BlueMind Major Release Update: Upgrade von v4 auf 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 Update von BlueMind.

Überprüfung der Wachsamkeit​

Version von BlueMind​

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

System​

Festplattenspeicher​

Im Hinblick auf das Upgrade von PostgreSQL von 14 auf 16 muss die Partition /var/lib/postgresql einen Belegungsgrad von weniger als 50% haben.

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.

Netzwerk​

Material​

Die Hardwarevoraussetzungen haben sich zwischen BlueMind 4 und BlueMind 5 geändert. Il est fortement recommandé de consulter la page Materielle Dimensionierung afin d'ajuster la configuration du serveur.

Spezifische Konfigurationen​

CAS-Konfiguration​

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-Konfiguration​

Wenn Sie den Authentifizierungsdienst auslagern, stellen Sie sicher, dass er richtig konfiguriert ist und dass Sie eine URL haben, auf die Sie vom BM-Server aus zugreifen können.

Weitere Informationen finden Sie unter :

Installation mit Edge-Server​

Im Falle einer Installation mit einem Edge-Server, der nicht von BlueMind verwaltet wird, korrigieren Sie die Nginx-Konfiguration des Edge-Servers.

Probleme nach dem Update​

Consulter les problèmes connus en fin de page :

Eignungsprüfung starten​

Obligatorische Vollstreckung

Dieser Eignungstest muss unbedingt durchgeführt werden, bevor Sie BlueMind von v4 auf v5 upgraden..

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

Diese Tests überprüfen die folgenden fünf wesentlichen Punkte:

  • Überprüfen von benutzerdefinierten Einstellungen
  • Checking hotupgrades
  • Checking elasticsearch cluster status
  • Checking cyrus replication
  • Cyrus E-Mail-Checks

Tests durchführen und überprüfen​

  1. Starten Sie den Eignungstest, indem Sie den folgenden Befehl ausführen:

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

    ⚠️ Testdauer und Ressourcenverbrauch

    Je nach Umfang kann der Befehl chek-upgrade-5 länger als eine Stunde dauern. Es wird empfohlen, ihn in einer screen oder tmux Sitzung auszuführen.
    Die Tests und die anschließenden Wartungsarbeiten können sehr ressourcenintensiv sein.
    Es wird daher empfohlen, diese in längeren Zeitfenstern mit geringer Auslastung auszuführen, beispielsweise am Ende des Tages.

  2. Führen Sie die vorgeschlagenen Reparaturmaßnahmen entsprechend den festgestellten Mängeln durch.
    Die Liste der Bestellungen sieht wie folgt aus (Beispiel) :

    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.
    Führen Sie dazu den folgenden Befehl in einer screen- oder tmux-Sitzung aus:

    bm-cli setup pre-upgrade-5

    Dies aktualisiert die Liste der Fehler und kann dazu führen, dass Fehler, die zuvor nicht gemeldet oder behoben wurden, wieder aufgegriffen werden.

Ergebnisse weiterleiten​

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

Abonnement aktualisieren​

Das Abonnement sollte nur aktualisiert werden, wenn der Eignungstest bestanden wurde.

Das Upgrade von BlueMind auf eine neue Hauptversion erfordert eine Änderung der Adressen der Softwaredepots. Die Abonnementdatei muss daher aktualisiert werden, um den Versionswechsel durchzuführen. Weitere Informationen finden Sie unter Umsetzung der Subskription.

Papierkörbe leeren​

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.

Um Speicherplatz freizugeben, empfehlen wir daher, diese Nachrichten vor dem Update zu löschen (dies ist ein für den Cyrus-Server spezifischer Vorgang, der in Version 5 nicht mehr verwendet wird) – und zwar mit dem folgenden Befehl:

cyr_expire -X 0

Führen Sie anschließend eine Reparatur der Datenträger mit den folgenden Optionen durch:

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

Verwaltung des BlueMind-Updates​

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

  1. Suivre la procédure de Update von BlueMind

    ⚠️ Unterstützung

    Sollten Schwierigkeiten auftreten, erstellen Sie bitte ein Ticket mit den folgenden Informationen:

    • den Inhalt von /var/log/ im tgz- oder zip-Format. Falls der Umfang zu groß ist, stellen Sie bitte mindestens folgende Protokolle zur Verfügung:
      • /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
    • Die Ausgabe dieser Befehle: 
      bm-cli node status
      bmctl status
      nproc
      free -m
      df -h; 
      uptime

  2. Backups bereinigen v4

    ⚠️ Nach Abschluss des Updates wird empfohlen, die Backups von BlueMind 4 zu löschen.

    Tatsächlich sichert BlueMind 5 E-Mails nach einer neuen Methode im Verzeichnis /var/backups/bluemind/sds-spool. Bei der ersten Sicherung werden alle E-Mails gesichert, was eine Warnung wegen Speicherplatzmangel auslösen kann, wenn der verfügbare Speicherplatz unter 50 % liegt.

    Backups der Version 4 sind nicht mehr kompatibel. Durch das Löschen dieser Dateien gewinnen Sie Speicherplatz zurück.

Beginnen Sie mit der Nachbearbeitung​

Automatische BlueMind-Vorgänge​

Nach dem Update werden Hintergrundoperationen durchgeführt. Sie wurden so geplant, dass sie laufen, ohne den produktiven Dienst zu beeinträchtigen.

Einige Funktionen werden im Laufe der Zeit durch diese Post-Grade-Operationen freigeschaltet. Dies betrifft insbesondere die erweiterte Sortierung von E-Mails und die Einstellung von Nachrichtenkonversationen.

Um den Fortschritt der Post-Upgrade-Operationen zu überprüfen, führen Sie den Befehl :

bm-cli hotupgrade progress --details --filterSuccess

Wenn diese Operationen fehlschlagen, erscheint ein Banner in der Admin-Konsole und zeigt dies den Administratoren an. In diesem Fall erstellen Sie ein Ticket (oder aktualisieren Sie das Ticket für den Eignungstest - siehe oben) in unserem Ticket-Tracking-Tool.

Nginx-Konfiguration​

Falls die Nginx-Konfiguration für eine Domain angepasst wurde, kopieren Sie die Datei /etc/nginx/bm-local.d/<domain>.conf nach /etc/nginx/bm-local.d/<xxxxxtechnical_domain>/ und aktualisieren Sie die Konfiguration in dieser Datei.

Bekannte Probleme​

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.

Weitere Informationen finden Sie unter :

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

Nicht-Endfilter​

E-Mail-Filter, die über die früheren Einstellungen erstellt wurden, waren zwangsläufig endgültig: Sobald ein Filter auf eine Nachricht angewendet wurde, wurde kein weiterer Filter mehr angewendet.
Mit dem neuen Webmail und den neuen Einstellungen können Sie nun festlegen, ob ein Filter endgültig ist oder nicht.
Beim Update von BlueMind 4 auf BlueMind 5 wird diese Option durch die Übernahme der Filter nicht aktiviert, sodass alle Filter nicht terminal sind und zu verwirrenden Sortierergebnissen für die Benutzer führen können.

Ref. BM-22085

Weiterführende Informationen​

Lesen Sie die BlueMind-Dokumentation in Verbindung mit

Lesen Sie die verwandten Artikel im BlueMind Blog