Migrer des données MS Exchange vers ONLYOFFICE

Cet article fournit des informations sur le transfert de données depuis MS Exchange vers ONLYOFFICE. À présent, le transfert des données suivantes est pris en charge:

• utilisateurs,
• boîtes mail,
• courriels.

Dans les futures versions, on va prendre en charge les données suivantes:

• calendriers,
• contacts,
• tâches.

Lancer le service approprié

Tout d'abord, vérifiez que le service Microsoft Exchange Mailbox Replication (ou MSExchangeMailboxReplication) soit lancé. Exécutez la commande suivante depuis la console cmd:

Get-Service -name MSExchangeMailboxReplication

Si le service est déjà exécuté, la commande retourne le résultat suivant:

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

Ou passez à Windows Control Panel - Administrative Tools - Services, recherchez et lancer Microsoft Exchange Mailbox Replication.

Attribuer les droits

Attribuez les droits d'administrateur à l'utilisateur qui va exporter les boîtes mail depuis MS Exchange:

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

Où <user name> est le nom de l'utilisateur qui exportera des données. Si c'est vous qui allez réaliser l'exportation, attribuez les droit à votre compte.

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

Ensuite, redémarrez la console Exchange Web Services (EWS) en mode administrateur. Pour ce faire, cliquez avec le bouton droit de la souris sur l'icône EWS du menu Démarrer et sélectionnez Exécuter en tant qu'administrateur (Run as administrator).

Exécuter le script

Maintenant, téléchargez le script qui va effectuer l'exportation des données depuis MS Exchange. Le script est disponible ici. Une fois téléchargé, exécutez le script depuis la console EWS:

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

Où .\ExportExchangeData.ps1 est le chemin d'accès au script et -dir "C:\Temp" est le chemin d'accès au dossier qui sera utilisé pour exporter les données.

Il faut transférer le dossier avec les fichiers exportés à l'ordinateur sur lequel ONLYOFFICE est installé.

Installer ONLYOFFICE Workspace Enterprise Edition et configurer le serveur de messagerie

Installez la version Docker de ONLYOFFICE Workspace Enterprise Edition. Pour ce faire, installez ONLYOFFICE Workspace Enterprise Edition en utilisant le script et sélectionnez l'installation sous Docker. Ensuite, installez le serveur de messagerie comme il est décrit ici.

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

Télécharger le script et installer/mettre à jour les dépendances

Vous devez télécharger et décompresser le script qui va effectuer le processus d'importation. Pour ce faire, utilisez la commande:

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

Cette commande va télécharger et décompresser le fichier et va créer la structure de dossier suivante:

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

Vous devez installer Python v2.7. Il est parfois installé par défaut avec la plupart des distributions Linux, mais s'il est manquant, installez-le vous-même. C'est comme ça qu'on fait pour les distributions basées sur Debian:

# apt install python# python -VPython 2.7.12

Installez pip (gestionnaire de paquets ), qui est aussi nécessaire pour le bon fonctionnement du script:

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

Installer les autres paquets requis:

pip install -r requirements.txt

Exécuter le script

Maintenant, vous pouvez exécuter le script en indiquant les paramètres suivants:

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

Remplacez les paramètres entre crochets par les données de votre portail et exécutez le script:

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

Attendez pour que le script se termine. Il faudra du temps en fonction du nombre d'utilisateurs et la quantité de leurs données.

Résultats du script

Les résultats du script seront les suivants:

• création de nouveaux utilisateurs du portail avec des adresses email depuis le fichier users.csv;
• création des boîtes mails sur le serveur de messagerie ONLYOFFICE Mail Server, comportant des messages depuis MS Exchange et connexion des utilisateurs du fichier users.csv au module ONLYOFFICE Mail;
• enregistrement du fichier results-ok.txt dans le dossier Import, celui-ci comportera la liste de tous les comptes d'utilisateurs du fichier users.csv et leurs mots de passe;
• enregistrement du fichier result-err.txtdans le dossier Import, celui-ci comportera la liste de tous les comptes d'utilisateurs du fichier users.csv ayant des difficultés pendant l'importation ou la création;
• enregistrement du fichiermailboxes.json au format JSON dans le dossier Import , celui-ci comportera la liste des paramètres pour connecter les nouvelles boîtes mails qui étaient créées à partir des clients de messagerie tiers.

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