Zum Hauptinhalt gehen

BlueMind Major Release Update: Upgrade von v4 auf v5

Der Wechsel zu einer neuen Hauptversion von BlueMind erfordert besondere Aufmerksamkeit in Bezug auf eine Reihe von Punkten zusätzlich zur Validierung der Voraussetzungen von Update von BlueMind.

Überprüfung der Wachsamkeit​

Version von BlueMind​

Um auf BlueMind 5 umsteigen zu können, muss Version 4 installiert und auf dem neuesten Stand der letzten verfügbaren Version sein.

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.

Wenn eine Archivierung eingerichtet ist, überprüfen Sie die Spoolgröße und stellen Sie sicher, dass mindestens 50% frei sind.

Netzwerk​

Material​

Die Hardwarevoraussetzungen haben sich zwischen BlueMind 4 und BlueMind 5 geändert. Es wird dringend empfohlen, die Seite Materielle Dimensionierung aufzurufen, um die Konfiguration des Servers anzupassen.

Spezifische Konfigurationen​

CAS-Konfiguration​

In BlueMind 5 erfolgt die CAS-Konfiguration pro Domäne und nicht mehr für den gesamten Server wie in v4. Die CAS-Konfiguration des Servers wird daher nicht migriert.

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​

Siehe bekannte Probleme am Ende der Seite:

Eignungsprüfung starten​

Obligatorische Vollstreckung

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

Ein Eignungstest „check-upgrade-v5“, ergänzt durch einen Verifizierungstest „pre-upgrade-5“, wurde der Website CLI-Client für die Verwaltung hinzugefügt, um Datenverluste zu vermeiden und ein kontrolliertes und sicheres Update auf Version 5 zu gewährleisten.

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

    Empfohlene Reparaturbefehle: 
    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. Starten Sie den Verifizierungstest, nachdem die empfohlenen Reparaturen durchgeführt wurden. 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​

Es wird dringend empfohlen, die beiden erstellten Protokolldateien (check-upgrade-5 und pre-upgrade-5) durch Erstellen eines Tickets an das Team Unterstützung zu übermitteln.

Abonnement aktualisieren​

Das Abonnement darf erst aktualisiert werden, wenn der Berechtigungstest bestätigt 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​

Bei der Datenübernahme werden E-Mails im doppelten Boden des Papierkorbs und zum Löschen markierte Entwürfe (alte Versionen von Entwürfen) nicht migriert.

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​

Sobald die Voraussetzungen erfüllt sind und der Eignungstest bestanden wurde:

  1. Befolgen Sie die Anweisungen unter 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​

Korrigierte Probleme​

Anzeige der Signatur im Dialer​

Die Signatur ist im Dialer nicht sichtbar, aber in der E-Mail, die der Empfänger erhält, vorhanden.

↳ korrigiert in den Versionen 5.2.7 und 5.3.1.

Ref. BM-22080

Restbestand an Cyrus-Daten nach der Migration von v4 auf v5​

Daten bleiben nach dem Wechsel zu v5 im Spool Cyrus. Es handelt sich um E-Mails, die von cyrus als "Expunged" markiert wurden und die wir bei der Aktualisierung nicht übernehmen. Diese Dateien befinden sich in den folgenden Verzeichnissen:

  • /var/spool/cyrus/data/.
  • /var/spool/cyrus/meta/ Normalerweise handelt es sich hierbei nicht um ein großes Mailvolumen.

↳ korrigiert in Version 5.3.2.

Ref. BM-21846

Fehler beim Speichern von Entwürfen​

Bei einigen Installationen werden die Entwürfe der Benutzer von BlueMind Webmail (mailApp) nicht gespeichert, so dass die E-Mail nicht gesendet werden kann. Das Problem betrifft nicht immer alle Entwürfe. ⇒ Umleitung: Aktualisieren Sie die Seite mit dem Befehl ctrl+F5, der das Nginx Websocket deaktiviert.

↳ korrigiert in den Versionen 5.2.9 und 5.3.1.

Ref. BM-22000

Mail-Symbol in der Kontaktliste​

Aus der Kontaktanwendung heraus führt die Verknüpfung zum Senden einer E-Mail aus der Kontaktliste zur alten Webmail-Schnittstelle:

↳ korrigiert in den Versionen 5.3.3 und 5.4.1.

Ref. BM-21003

Probleme, die auf eine Korrektur warten​

DataProtect-Aufgabe mit Fehler​

Beim Update auf Bluemind 5 wird neben den übrigen Vorgängen auch eine Änderung des E-Mail-Spools vorgenommen: Die E-Mails werden vom Cyrus-Spool in einen Bluemind-spezifischen Spool migriert. Während dieses Vorgangs funktioniert die DataProtect-Aufgabe nicht ordnungsgemäß und bricht mit der Fehlermeldung „ — “ ab. Bei mehreren Terabyte an E-Mails kann dieser Vorgang mehrere Tage dauern (die Dauer hängt neben dem Datenvolumen auch von der Geschwindigkeit der Festplatten ab).

Ref. BM-22759

Aktivierung von Let's Encrypt​

Bei einigen Installationen ist es nicht mehr möglich, die Allgemeinen Geschäftsbedingungen von Let's Encrypt nach einem Wechsel auf Version 5 zu akzeptieren.
⇒ **Verwenden Sie den folgenden bm-cli-Befehl:

bm-cli certificate manage-lets-encrypt

Ref. BM-21613

Wenn die alte Webmail-Schnittstelle entfernt wurde, können Benutzer ohne die Rolle "Zugang zu neuem Webmail" die Option zur Konfiguration von mailto-Links in den BlueMind-Optionen nicht anzeigen. ⇒ **Umgehung: ** Geben Sie diese Rolle den Nutzern.

Weitere Informationen finden Sie unter :

Ref. BM-21735

Schaltfläche für den Zugang zu BlueMind Videokonferenzen​

Die Schaltfläche zum schnellen Start einer Videokonferenz ist aus dem alten Banner von bluemind verschwunden. 💡 Dieses Problem betrifft nur den schwarzen Banner, der nur erscheint, wenn der Nutzer das alte Webmail zum Lesen seiner E-Mails verwendet.

Ref. BM-21977

Fehler beim Sortieren eines Ordners in der alten Webmail​

Die Sortierung nach Absender im alten Webmail erzeugt einen Serverfehler, wenn der aktuelle Ordner zu groß ist. Sobald der Serverfehler auftritt, werden die E-Mails im Ordner des Benutzers nicht mehr abgerufen. ⇒ Umgehung: Gehen Sie über die Sortiereinstellungen der Anwendung (anstelle eines Klicks am Spaltenanfang), um die Sortierung nach Datum zurückzusetzen.

Ref. BM-22019

Verschwinden der gemeinsamen Boxen​

Benutzer, die gemeinsame Postfächer abonniert haben und das alte Webmail von Bluemind verwenden, können sich auf dem neuen Webmail verloren fühlen: Ihre gemeinsamen Postfächer werden nicht mehr im Banner auf der linken Seite ihres Bildschirms angezeigt. Wenn sie diese Postfächer noch abonniert haben, müssen sie ihre eigenen Einstellungen verwenden, um die verschiedenen Postfächer zu abonnieren, die für sie freigegeben sind. Obwohl es sich hierbei nicht um einen Bug handelt, planen wir angesichts der Auswirkungen auf die betroffenen Nutzer, die manchmal verwirrt sind, jeden Nutzer automatisch für die Boxen zu abonnieren, die für ihn freigegeben werden, wenn das Update durchgeführt wird.

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

Letztes Update