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. Wir empfehlen Ihnen, die folgende Seite aufmerksam zu lesen, um sich auf den Übergang zur neuen Version vorzubereiten.

Überprüfung der Wachsamkeit​

Voraussetzungen für die Installation​

Wie bei jedem Update ist es wichtig, dass Sie sicherstellen, dass die Voraussetzungen für die Installation von BlueMind Version 5 erfüllt sind.

Weitere Informationen finden Sie unter :

Speicherplatz

BlueMind empfiehlt, den Anforderungen an den Festplattenspeicher besondere Aufmerksamkeit zu schenken, da diese sich mit Version 5.5 geändert haben: Voraussetzungen für die Installation: Festplattenspeicher.

Version von BlueMind​

Um auf Version 5 upgraden 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, müssen mindestens 50% der Größe des schnellen Spool** frei bleiben.

Netzwerk​

Tika​

Der Erinnerungswert des Dienstes bm-tika muss überbewertet werden. Dazu erstellen Sie die Datei /etc//bm/local/bm-tika.ini mit den Werten :

MEM=2028
DMEM=128

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.

Maximale Größe der gespeicherten Nachrichten​

Die derzeit von BlueMind unterstützte maximale Nachrichtengröße beträgt 96 MB; in Versionen vor BlueMind 4.6.0 konnten jedoch über einen IMAP-Client größere Nachrichten auf den Server hochgeladen werden. Es muss daher sichergestellt werden, dass keine Nachrichten mit einer Größe von mehr als 96 MB auf dem Server verbleiben. Mit dem Befehl find können Sie diese Suche durchführen:

find /var/spool/cyrus/data/ -type f -size +96M
find /var/spool/bm-hsm/ -type f -size +96M

Sollten Nachrichten gefunden werden, müssen diese gelöscht oder aus BlueMind verschoben werden, bevor Sie fortfahren. Sie können beispielsweise im Verzeichnis /var/backups/bluemind abgelegt werden. Auf diese Weise können sie anschließend an ihre Eigentümer zurückgegeben werden, die sie mithilfe einer Client-Software eines Drittanbieters einsehen können, sie jedoch nicht wieder in BlueMind integrieren können.

Falls der Eignungstest bereits durchgeführt wurde (siehe unten), muss er nach dem Löschen der betreffenden E-Mails erneut durchgeführt werden.

Es muss außerdem sichergestellt werden, dass die maximal zulässige Nachrichtengröße in der BlueMind-Konfiguration unter 96 MB liegt:

[ "$(bm-cli sysconf list | grep message_size | grep -oE '[0-9]+')" -lt $((100*1024*1024)) ] && echo "OK" || echo "Fehler"

↳ Die Antwort „KO“ bedeutet, dass der Wert korrigiert werden muss.

Weitere Informationen finden Sie unter die Seite System-Konfiguration > E-Mail.

Probleme nach dem Update​

Lesen Sie die bekannten Probleme am Ende der Seite: Bekannte Probleme

Eignungsprüfung starten​

Muss ausgeführt werden

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.

    ⚠️ Je nach Plattform ist dieser Vorgang ressourcenintensiv und kann daher einige Zeit in Anspruch nehmen. Um die Dauer der Betriebsunterbrechung zum Zeitpunkt des Updates zu verkürzen, kann man das Pre-Upgrade daher einige Tage im Voraus ausführen, sodass es schneller abläuft, wenn es kurz vor dem Update erneut ausgeführt wird. 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, die sich im „Papierkorb“ befinden, sowie zum Löschen markierte Entwürfe (frühere Versionen von Entwürfen) nicht migriert. Informationen Weitere Informationen zur Verwendung des Papierkorbs mit doppeltem Boden finden finden Sie unter Sie Weitere Informationen unter finden Sie unter Gelöschte Nachrichten wiederherstellen.

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 zu beachtenden Punkte und der Eignungstest bestätigt wurden:

  1. Führen Sie den Validierungstest erneut durch, um sicherzustellen, dass seit der ersten Validierung keine neuen Fehler aufgetreten sind:

    bm-cli setup pre-upgrade-5

    ⚠️ Sollten Fehler auftreten, lesen Sie bitte den Abschnitt Eignungstest starten.

  2. Befolgen Sie die Anweisungen unter Update von BlueMind

    ⚠️ Anfrage an 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

  3. 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​

Die Quoten einiger Postfächer weichen nach dem Update stark voneinander ab​

Die Quoten in Version 5 werden nicht auf dieselbe Weise berechnet wie in Version 4, in der die von Cyrus übermittelten Daten unzuverlässig waren. In einigen Fällen kann es daher vorkommen, dass die Felder mehr oder weniger gefüllt erscheinen als vor dem Update.

Ref. BM-22057

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

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