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üfen Sie, ob Sie auf der Hut sind​

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 (https://doc.bluemind.net/release/4.9/changelogs).

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​

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​

Sehen Sie sich die bekannten Probleme am Ende der Seite an: Bekannte Probleme

Beginnen Sie mit dem Eignungstest {check-upgrade}​

Obligatorische Vollstreckung

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

Ein check-upgrade-v5 Eignungstest wurde zu CLI-Client für die Verwaltung hinzugefügt, um Datenverluste zu vermeiden und ein kontrolliertes und sicheres Upgrade auf v5 zu gewährleisten.

Dieser Test prüft die folgenden 5 Hauptpunkte:

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

Durchführung und Validierung des Tests​

  1. Starten Sie den Test, indem Sie den folgenden Befehl ausführen:
bm-cli setup check-upgrade-5 --force-delete-many-orphans
Testdauer und Ressourcenverbrauch

Je nach Dimensionierung kann der Befehl chek-upgrade-5 mehr als eine Stunde dauern. Es wird empfohlen, ihn in einer screen oder tmux Sitzung auszuführen.

Der Test und die anschließenden Wartungsarbeiten können ressourcenintensiv sein. Il est donc recommandé de les exécuter pendant des créneaux de faible activité assez longs, par exemple en fin de journée.

Anschließend werden Reparaturaufträge vorgeschlagen, die entsprechend den identifizierten Mängeln ausgeführt werden müssen. 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
  1. Lancer une nouvelle vérification une fois les réparations recommandées effectuées. Dies aktualisiert die Liste der Fehler und kann dazu führen, dass Fehler, die zuvor nicht gemeldet oder behoben wurden, wieder aufgegriffen werden.

Ergebnisse übermitteln​

Es wird dringend empfohlen, dass Sie unserem Team Unterstützung die Ergebnisse der wiederholten Ausführung dieser Testbefehle über die Erstellung eines Tickets mitteilen.

Aktualisieren Sie das Abonnement​

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.

Leeren Sie die Papierkörbe.​

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 Meldungen vor dem Update zu löschen (dies ist ein eigener Prozess des Cyrus-Servers, der in Version 5 nicht mehr verwendet wird) mit dem folgenden Befehl:

cyr_expire -X 0

Führen Sie dann eine Reparatur der Boxen mit den folgenden Optionen durch:

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

Starten Sie das Update von BlueMind​

Wenn Sie die Voraussetzungen erfüllt und den Eignungstest bestanden haben :

  1. Befolgen Sie das Verfahren der Update von BlueMind

    ⚠️ Unterstützung

    Wenn Sie Schwierigkeiten haben, erstellen Sie ein Ticket mit den folgenden Informationen:

    • den Inhalt von /var/log/ im tgz- oder zip-Format. Wenn zu groß, liefern Sie mindestens diese 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.
    • die Rückgabe dieser Bestellungen: 
      bm-cli node status
      bmctl status
      nproc
      free -m
      df -h; 
      uptime

  2. Bereinigung von Backups v4

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

    BlueMind 5 speichert nämlich E-Mails nach einer neuen Methode in /var/backups/bluemind/sds-spool. Die erste Sicherung umfasst alle E-Mails, was eine Warnung auslösen kann, dass die Festplatte voll ist, wenn der verfügbare Speicherplatz < 50% ist.

    Die v4-Backups sind nicht mehr kompatibel. Wenn Sie diese entfernen, gewinnen Sie wieder Platz.

Starten Sie die Nach-Aktualisierungsoperationen​

Automatische BlueMind-Operationen​

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​

Wenn 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 dort die Konfiguration.

Bekannte Probleme​

Die Quoten einiger Boxen sind nach dem Update sehr unterschiedlich.​

Die Quoten in Version 5 werden nicht auf die gleiche Weise berechnet wie in Version 4, in der die von Cyrus gelieferten Daten unzuverlässig waren. In einigen Fällen können Boxen mehr oder weniger gefüllt erscheinen als vor dem Update.

Ref. BM-22057

Fehlerhafte DataProtect-Aufgabe​

Beim Upgrade auf Bluemind 5 wird unter anderem der Spool für E-Mails geändert: Die E-Mails werden vom Spool cyrus in einen Spool speziell für Bluemind migriert. Während dieses Vorgangs funktioniert die Aufgabe von DataProtect nicht richtig und stürzt in einen Fehler — wenn es sich um mehrere Terra-Bytes an E-Mails handelt, kann dieser Vorgang mehrere Tage dauern (die Zeit hängt neben dem Datenvolumen auch von der Geschwindigkeit der Festplatten ab).

Ref. BM-22759

Nicht-terminale Filter​

Sobald ein Filter auf eine Nachricht angewendet wurde, wurden keine weiteren Filter mehr angewendet. Mit dem neuen Webmail und den neuen Einstellungen ist es nun möglich, zu wählen, ob ein Filter terminal ist oder nicht. Beim Upgrade von BlueMind 4 auf BlueMind 5 wird diese Option nicht durch die Übernahme der Filter aktiviert, so dass alle Filter nicht-terminal sind und zu einer verwirrenden Sortierung für die Benutzer führen können.

Ref. BM-22085

Pour aller plus loin​

Lesen Sie die BlueMind-Dokumentation in Verbindung mit

Lesen Sie die verwandten Artikel im BlueMind Blog

Letztes Update