Migrieren von MS Exchange-Daten zu ONLYOFFICE

Einleitung

Dieser Artikel zeigt, wie Sie die Daten von MS Exchange nach ONLYOFFICE übertragen können. Derzeit werden die folgenden Datentypen für die Übertragung unterstützt:

• Benutzer,
• Postfächer,
• E-Mail-Nachrichten.

In den nächsten Versionen werden wir die Unterstützung für die folgenden Daten hinzufügen:

• Kalender,
• Kontakte,
• Aufgaben.

Daten aus MS Exchange exportieren

Ausführen des erforderlichen Dienstes

Stellen Sie zunächst sicher, dass der Dienst Microsoft Exchange Mailbox Replication (oder MSExchangeMailboxReplication) gestartet ist. Führen Sie den folgenden Befehl in der Befehlszeile aus:

Get-Service -name MSExchangeMailboxReplication

Wenn der benötigte Dienst ausgeführt wird, sieht das Befehlsergebnis folgendermaßen aus:

Status   Name               DisplayName------   ----               -----------Running  MSExchangeMailb... Microsoft Exchange Mailbox Replication

Oder Sie können in der Windows-Systemsteuerung - Verwaltung - Dienste nach der Microsoft Exchange Mailbox Replication suchen und diese ausführen.

Zuweisen der Rechte

Weisen Sie dem Benutzer, der den Export der Postfächer aus MS Exchange durchführen soll, die Administratorrechte zu:

New-ManagementRoleAssignment –Role "Mailbox Import Export" –User <user name>

Dabei ist <user name> der Benutzername, der die Daten exportieren soll. Wenn Sie dies selbst tun, weisen Sie Ihrem Konto diese Rolle zu.

New-ManagementRoleAssignment –Role "Mailbox Import Export" –User John

Starten Sie anschließend die Exchange Web Services (EWS)-Konsole mit Administratorrechten neu. Klicken Sie dazu mit der rechten Maustaste auf das EWS-Symbol im Startmenü und wählen Sie die Option Als Administrator ausführen.

Ausführen des Skripts

Laden Sie nun das Skript herunter, das alles für den korrekten Export der Daten aus MS Exchange erledigt. Das Skript ist hier verfügbar. Führen Sie es nach dem Download in der EWS-Konsole aus:

.\ExportExchangeData.ps1 -dir "C:\Temp"

Dabei ist .\ExportExchangeData.ps1 der Pfad zum Skript und -dir "C:\Temp" der Pfad zum Ordner, der zum Exportieren der Dateien verwendet wird.

Der Ordner mit den exportierten Dateien muss dann auf den Computer übertragen werden, auf dem ONLYOFFICE installiert ist.

Die MS Exchange-Daten in ONLYOFFICE importieren

ONLYOFFICE Workspace Enterprise Edition installieren und E-Mail-Server konfigurieren

Installieren Sie die Docker-Version von ONLYOFFICE Workspace Enterprise Edition. Dies können Sie tun, indem Sie ONLYOFFICE Workspace Enterprise Edition mithilfe des Skripts installieren und die Docker-Installationsvariante auswählen. Richten Sie anschließend den E-Mail-Server wie hier beschrieben ein.

sed -i 's/exchange-domain.com/new-domain.com/g' users.csv

Skript herunterladen und Abhängigkeiten installieren/aktualisieren

Nun müssen Sie das Skript herunterladen und entpacken, das den Datenimportprozess durchführt. Dies kann mit dem folgenden Befehl erfolgen:

wget -O "ImportExchangeData.tar" "https://help.onlyoffice.co/products/files/httphandlers/filehandler.ashx?action=view&fileid=5549294&version=0&doc=TWVPQks1aUo2MEprc0tkbUF6K2Y4Um1OSi9tTkd6V0lyTHFocG0xZHE0QT0_IjU1NDkyOTQi0" && tar -xvf ImportExchangeData.tar && cd ./Import

Der Befehl lädt die Datei herunter und entpackt sie, wobei die folgende Ordnerstruktur erstellt wird:

Import|-lib
   |---create_users.py
   |---mbox2imap.py
   |---mapping.json
   |---pst2mbox.sh
   |---get-mailboxes.sh
   |---install-passfinder.sh
   |---ASC.Mail.PasswordFinder.tar
   |-ImportExchangeData.py
   |-requirements.txt

Sie benötigen Python v2.7. Sie ist bei verschiedenen Linux-Distributionen oft standardmäßig installiert. Falls sie jedoch fehlt, müssen Sie sie selbst installieren. So funktioniert sie bei Debian-basierten Distributionen:

# apt install python# python -VPython 2.7.12

Installieren Sie den pip (Paketmanager), der auch für die korrekte Funktion des Skripts erforderlich ist:

# apt install python-pip# pip -V
pip 9.0.1 from /usr/local/lib/python2.7/dist-packages (python 2.7)

Und installieren Sie die anderen erforderlichen Pakete:

pip install -r requirements.txt

Ausführen des Skripts

Jetzt können Sie das Skript unter Angabe der erforderlichen Parameter ausführen:

./ImportExchangeData.py -d "<portal domain>" -u "<portal administrator email>" -pw "<portal administrator password>" -f <path to the folder with the exported data>

Ersetzen Sie die Parameter in Klammern durch Ihre eigenen Portaldaten und führen Sie das Skript aus:

./ImportExchangeData.py -d myportal.com -u "my.email.address@gmail.com" -pw "123456" -f /root/Temp/

Warten Sie, bis das Skript fertig ist. Je nach Anzahl der Benutzer und Datenmenge kann dies einige Zeit dauern.

Ergebnisse der Skriptarbeit

Wenn das Skript alles tut, wofür es gedacht ist, sind die Ergebnisse die folgenden:

• Die neuen Portalbenutzer mit den E-Mail-Adressen aus der Datei users.csv werden erstellt.
• Die Postfächer auf dem ONLYOFFICE-E-Mail-Server werden erstellt, die die E-Mail-Nachrichten von MS Exchange enthalten und im ONLYOFFICE-Modul E-Mail für die in der Datei users.csv aufgeführten Benutzer verbunden werden.
• Die Datei results-ok.txt wird im Ordner Import gespeichert. Sie enthält die Liste aller Benutzerkonten aus der Datei users.csv und deren Passwörter, die erfolgreich erstellt wurden.
• Die Datei result-err.txt wird im Ordner Import gespeichert. Sie enthält die Liste aller Benutzerkonten aus der Datei users.csv, bei denen beim Importieren und Erstellen Probleme aufgetreten sind.
• Die Datei mailboxes.json im JSON-Format wird im Ordner Import gespeichert. Sie enthält die Liste der Einstellungen, die für die Verbindung mit den neu erstellten Postfächern von den E-Mail-Clients von Drittanbietern erforderlich sind.

bash ./lib/get-mailboxes.sh -j