Zum Hauptinhalt gehen
Version: 5.5

Integration und Konfiguration des S3-Speichers

Der S3-Speicher bietet hohe Langlebigkeit, konstante Leistung und maximale Verfügbarkeit. Zudem ermöglicht er es, Einschränkungen wie die Anzahl der Objekte in einem Bucket zu umgehen.

Empfehlungen​

Interne Implementierung (Ceph, Minio, etc.).​

Achten Sie auf die Verteilung der Daten über mehrere Maschinen, das Netzwerk und die Laufwerke darunter (nur ssd/nvme, siehe Empfehlungen oben).

⚠️ Eine Netzwerkbandbreite von 1 GB zum S3-Speicher eignet sich nur für kleine Installationen, da alle E-Mails dort gespeichert werden.

Implementierung mit gekauften Diensten (Scality Ring usw.)​

Der Schwerpunkt liegt auf der Netzwerkverbindung zwischen dem E-Mail-System und dem S3-Speicher: Die Latenz ist in der Regel hoch, und es gelten Ratenbeschränkungen.

Die Implementierung im Rahmen von Anwendungen mit Webmail und EAS-Synchronisierung ist erst ab Version 5.3 von BlueMind möglich.

In Szenarien mit der Nutzung von „dicken“ Clients gestaltet sich die Implementierung umso komplizierter, da diese bei jeder erneuten Verbindung eine ganze Flut vollständiger E-Mails herunterladen; die Zurücksetzung eines Outlook-Clients kann daher bereits allein das Anfrage-Kontingent des Anbieters erschöpfen.

Backup​

S3 gilt als langlebig, was den Anschein erweckt, dass eine Sicherung nicht erforderlich ist. In der Praxis sind jedoch Softwarefehler oder unglückliche Administrationsbefehle Eventualitäten, die berücksichtigt werden müssen.
Die Wiederherstellung gelöschter Objekte im Katastrophenfall würde die Entwicklung spezifischen Codes erfordern und wird derzeit von BlueMind nicht nativ unterstützt. Es wird daher empfohlen,die S3-Versionierung zu aktivieren, damit Löschvorgänge lediglich als Löschmarkierungen fungieren, die erst viel später ablaufen, sodass die Objekte nicht sofort verloren gehen.

Konfiguration des S3-Speichers für eine neue BlueMind-Installation​

Für eine Neuinstallation von BlueMind sollten Sie BlueMind zunächst auf einem leeren Server installieren, bevor Sie mit der Konfiguration und anschließenden Aktivierung des S3-Speichers fortfahren:

  1. Überprüfen Sie die Voraussetzungen für die Installation

  2. Führen Sie die Installation von BlueMind durch

    ⚠️ Verwenden Sie in diesem Schritt nicht den Setup-Assistenten.

  3. Das Abonnement manuell installieren

    💡 theme.common.Pourinfo Umsetzung der Subskription > Abonnementdatei installieren > Manuelle Installation

  4. Installieren Sie die neuen Pakete:

    apt update && apt install bm-plugin-cli-setup bm-setup-wizard

  5. Starten Sie den Installationsassistenten, indem Sie die erforderlichen Informationen eingeben:

    bm-cli setup install \
        --domain "nom-du-domaine.tld" \
        --external-url "url-externe.tld" \
        --set-contact "email-de-contact@domaine.tld" \
        --admin0-pass 'CHANGEME'
        --sw-pass 'CHANGEME2'
        --domain-admin-pass 'CHANGEME3'

  6. Optional: Aktivieren Sie bei Bedarf den „ Filehosting von BlueMind “:

    bm-cli filehosting activate --domain bluemind.lab --group user

  7. Konfiguration der Verbindung von BlueMind zum S3-Speicherserver:

    ⚠️ Das folgende Beispiel muss bearbeitet und an die jeweilige Umgebung angepasst werden

    cat << EOF > bm-s3-config.json
    {
        "archive_kind": "s3",
        "sds_s3_endpoint": "http://s3.bluemind.lab:8333", # ATTENTION, doit contenir le protocole sinon erreur : "The URI scheme of endpointOverride must not be null"
        "sds_s3_bucket": "NOM DU BUCKET S3",
        "sds_s3_region": "", # Peut être vide
        "sds_s3_access_key": "ACCESS KEY S3",
        "sds_s3_secret_key": "SECRET KEY S3",
        "sds_filehosting_storetype": "s3", # Optionnel, Configuration S3 pour le file hosting.
        "sds_filehosting_endpoint": "http://s3.bluemind.lab:8333", # Optionnel, Configuration S3 pour le file hosting.
        "sds_filehosting_s3_bucket": "NOM DU BUCKET S3", # Optionnel, Configuration S3 pour le file hosting.
        "sds_filehosting_s3_region": "", # Optionnel, Configuration S3 pour le file hosting.
        "sds_filehosting_s3_access_key": "ACCESS KEY S3", # Optionnel, Configuration S3 pour le file hosting.
        "sds_filehosting_s3_secret_key": "SECRET KEY S3" # Optionnel, Configuration S3 pour le file hosting.
    }
    EOF

  8. S3-Konfiguration aktivieren:

    bm-cli sysconf mset --format=json bm-s3-config.json

    💡 Ein Neustart des Dienstes ist nicht erforderlich, die Konfiguration wird sofort übernommen.

Migration des E-Mail-Spools auf einen neuen Speicher​

  1. Befolgen Sie die Schritte 1 bis 7 der Anleitung aus dem vorherigen Kapitel

    ⚠️ FÜHREN SIE SCHRITT 8 (S3-Konfiguration aktivieren) NICHT AUS

  2. Kopieren Sie die E-Mails vom alten Speicher auf den neuen mit dem Befehl „bm-cli sds migrate “: 
    bm-cli sds migrate config2.json --workers 8 --format=json --no-filehosting
    #                                         ^ adapter le nombre de workers au besoin

    💡 Dieser Schritt kann einige Zeit in Anspruch nehmen, lässt sich jedoch im laufenden Betrieb durchführen. Zudem kann der Befehl unterbrochen und neu gestartet werden.

  3. Fahren Sie nun mit Schritt 8 „S3-Konfiguration aktivieren“ fort.
  4. Führen Sie den Befehl zum Kopieren der E-Mails erneut aus, um eventuelle Datenunterschiede zwischen der ersten Migration und der Aktivierung zu migrieren.

Migration des Filehostings mit Rclone​

Mit dem Befehl „ bm-cli sds migrate “ können Sie den „ Filehosting von BlueMind “ ausschließlich vom lokalen Speicher (Datei) auf ein SDS migrieren.

Das Tool Rclone ermöglicht die Migration sowohl aus dem lokalen Speicher als auch aus einem SDS.

In den folgenden Befehlen:
  • src: Der aktuelle SDS-Server (optional bei lokalem Speicher)
  • dst: Der SDS-Zielserver
  • Ersetzen Sie src:BUCKET_SOURCE durch den absoluten Pfad des Filehosting (/var/spool/bm-filehosting) im Falle einer Migration von einem lokalen Speicher.

  1. Rclone installieren:

    apt install rclone

  2. Konfigurieren Sie die Rclone-Remotes mit dem Befehl „ rclone config “.

  3. Bereiten Sie die JSON-Konfigurationsdatei (s3-destination.json) für den neuen SDS-Speicherserver vor (siehe oben „Konfiguration für eine Neuinstallation“, Schritt 7.).

  4. Kopieren Sie die Daten vom alten S3-Speicher auf den neuen:

    rclone sync --progress src:BUCKET_SOURCE dst:BUCKET_DESTINATION

    💡 Dieser Schritt kann unterbrochen und später fortgesetzt werden.

  5. Konfiguration des neuen S3-Speichers übernehmen:

    rclone sync --progress src:BUCKET_SOURCE dst:BUCKET_DESTINATION && bm-cli sysconf mset --format=json s3-destination.json

    💡 Ein Neustart des Dienstes ist nicht erforderlich.

  6. Starten Sie eine erneute Synchronisierung der Daten vom alten S3-Server auf den neuen für E-Mails, die zwischen der letzten Synchronisierung und der Umstellung eingegangen sind:

    rclone copy --progress src:BUCKET_SOURCE dst:BUCKET_DESTINATION

    ⚠️ Verwendung des Befehls COPY Achtung: In diesem Schritt MÜSSEN Sie den Befehl „ copy “ verwenden. Der Befehl „ sync “ kann E-Mails am Zielort löschen.

Weiterführende Informationen​

Lesen Sie die BlueMind-Dokumentation in Verbindung mit