Migrazione dei dati di MS Exchange a ONLYOFFICE

Questo articolo mostrerà come trasferire i dati da MS Exchange a ONLYOFFICE. Attualmente, i seguenti tipi di dati sono supportati per il trasferimento:

• utenti,
• caselle di posta,
• messaggi di posta elettronica.

Nei prossimi rilasci aggiungeremo il supporto per i seguenti dati:

• calendari,
• contatti,
• attività.

Avviare il servizio necessario

Prima di tutto, è necessario assicurarsi che il servizio Microsoft Exchange Mailbox Replication (o MSExchangeMailboxReplication) sia avviato. Esegui il seguente comando nella console cmd:

Get-Service -name MSExchangeMailboxReplication

Se il servizio necessario è in esecuzione, il risultato del comando sarà simile a questo:

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

Oppure puoi andare al Pannello di Controllo di Windows - Strumenti di Amministrazione - Servizi, trovare il Microsoft Exchange Mailbox Replication e avviarlo.

Assegnare i diritti

Assegna i diritti amministrativi all'utente che eseguirà l'esportazione delle caselle di posta da MS Exchange:

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

Dove <user name> è il nome dell'utente che esporterà i dati. Se intendi farlo tu stesso, assegna questo ruolo al tuo account.

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

Dopo di che, riavvia la console dei Servizi Web di Exchange (EWS) con i diritti di amministratore. Questo si fa cliccando con il tasto destro del mouse sull'icona EWS nel menu di avvio e selezionando l'opzione Esegui come amministratore.

Eseguire lo script

Ora scarica lo script che farà tutto il necessario per l'esportazione corretta dei dati da MS Exchange. Lo script è disponibile qui. Una volta scaricato, eseguilo nella console EWS:

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

Dove .\ExportExchangeData.ps1 è il percorso dello script, e -dir "C:\Temp" è il percorso della cartella che verrà utilizzata per esportare i file.

La cartella con i file esportati deve quindi essere trasferita sul computer con ONLYOFFICE installato.

Installazione di ONLYOFFICE Workspace Enterprise Edition e configurazione del Mail Server

Installa la versione Docker di ONLYOFFICE Workspace Enterprise Edition. Questo può essere fatto installando ONLYOFFICE Workspace Enterprise Edition usando lo script e selezionando la variante di installazione Docker. Successivamente, configura il server di posta come descritto qui.

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

Scaricare lo script e installare/aggiornare le dipendenze

Ora devi scaricare e decomprimere lo script che eseguirà il processo di importazione dei dati. Questo può essere fatto utilizzando il comando:

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

Il comando scaricherà e decomprimerà il file, creando la seguente struttura di cartelle:

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

Avrai bisogno di Python v2.7 installato. È spesso installato di default con varie distribuzioni Linux, ma nel caso manchi, dovrai installarlo tu stesso. Ecco come si fa per le distribuzioni basate su Debian:

# apt install python
# python -V
Python 2.7.12

Installa il pip (gestore pacchetti), anch'esso necessario per il corretto funzionamento dello script:

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

E installa gli altri pacchetti richiesti:

pip install -r requirements.txt

Esecuzione dello script

Ora puoi eseguire lo script specificando i parametri necessari:

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

Sostituisci i parametri tra parentesi con i dati del tuo portale e avvia lo script:

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

Attendi che lo script termini il suo lavoro. Potrebbe richiedere del tempo a seconda del numero di utenti e della quantità di dati.

Risultati del lavoro dello script

Quando lo script avrà completato tutte le sue operazioni, i risultati saranno i seguenti:

• verranno creati i nuovi utenti del portale con gli indirizzi email dal file users.csv;
• verranno create le caselle di posta sul Mail Server di ONLYOFFICE, che conterranno i messaggi di posta da MS Exchange e saranno collegate nel modulo Mail di ONLYOFFICE per gli utenti elencati nel file users.csv;
• il file results-ok.txt sarà salvato nella cartella Import, conterrà l'elenco di tutti gli account utente dal file users.csv e le loro password, che sono stati creati con successo;
• il file result-err.txt sarà salvato nella cartella Import, conterrà l'elenco di tutti gli account utente dal file users.csv, che hanno avuto problemi durante l'importazione e la creazione;
• il file mailboxes.json in formato JSON sarà salvato nella cartella Import, conterrà l'elenco delle impostazioni necessarie per connettersi alle nuove caselle di posta dai client di posta di terze parti.

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