Migración de datos de MS Exchange a ONLYOFFICE

Este artículo mostrará cómo puede transferir los datos de MS Exchange a ONLYOFFICE. Actualmente se admiten los siguientes tipos de datos para la transferencia:

• usuarios,
• buzones de correo,
• mensajes de correo.

En las próximas versiones, planeamos agregar soporte para los siguientes datos:

• calendarios,
• contactos,
• tareas.

Ejecutar el servicio necesario

Primero, debe asegurarse de que el servicio Microsoft Exchange Mailbox Replication (o MSExchangeMailboxReplication) esté iniciado. Ejecute el siguiente comando en la consola cmd:

Get-Service -name MSExchangeMailboxReplication

Si el servicio que necesita está en ejecución, el resultado del comando será similar a este:

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

O puede ir al Panel de Control de Windows - Herramientas Administrativas - Servicios, encontrar el Microsoft Exchange Mailbox Replication y ejecutarlo.

Asignación de derechos

Asigne los derechos administrativos al usuario que va a exportar los buzones de correo de MS Exchange:

New-ManagementRoleAssignment –Role "Mailbox Import Export" –User <nombre de usuario>

Dónde <nombre de usuario> es el nombre del usuario que va a exportar los datos. Si va a hacerlo usted mismo, asigne este rol a su cuenta.

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

Después de eso, reinicie la consola de Exchange Web Services (EWS) con derechos de administrador. Esto se hace haciendo clic en el icono de EWS en el menú de inicio con el botón derecho del ratón y seleccionando la opción Ejecutar como administrador.

Ejecutar el script

Ahora descargue el script que hará todo lo necesario para la correcta exportación de los datos de MS Exchange. El script está disponible aquí. Una vez descargado, ejecútelo en la consola de EWS:

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

Dónde .\ExportExchangeData.ps1 es la ruta al script, y -dir "C:\Temp" es la ruta a la carpeta que se usará para exportar los archivos.

La carpeta con los archivos exportados luego debe ser transferida al ordenador con ONLYOFFICE instalado.

Instalación de ONLYOFFICE Workspace Enterprise Edition y configuración del Servidor de Correo

Instala la versión Docker de ONLYOFFICE Workspace Enterprise Edition. Esto se puede hacer instalando ONLYOFFICE Workspace Enterprise Edition usando el script y seleccionando la variante de instalación Docker. Después de eso, configura el servidor de correo como se indica aquí.

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

Descargar el script e instalar/actualizar dependencias

Ahora necesitas descargar y descomprimir el script que realizará el proceso de importación de datos. Esto se puede hacer usando el 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

El comando descargará y descomprimirá el archivo, creando la siguiente estructura de carpetas:

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

Necesitarás tener instalado Python v2.7. A menudo se instala por defecto con varias distribuciones de Linux, pero en caso de que falte, tendrás que instalarlo tú mismo. Así es como se hace para distribuciones basadas en Debian:

# apt install python
# python -V
Python 2.7.12

Instala el pip (gestor de paquetes), también necesario para el correcto funcionamiento del script:

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

Y instala los otros paquetes requeridos:

pip install -r requirements.txt

Ejecutar el script

Ahora puedes ejecutar el script especificando los parámetros necesarios:

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

Reemplaza los parámetros entre corchetes con los datos de tu propio portal y ejecuta el script:

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

Espera a que el script termine de trabajar. Puede tardar algún tiempo dependiendo del número de usuarios y la cantidad de sus datos.

Resultados del trabajo del script

Cuando el script realiza todo lo que se propone, los resultados serán los siguientes:

• se crearán los nuevos usuarios del portal con las direcciones de correo del archivo users.csv;
• se crearán los buzones en el Servidor de Correo de ONLYOFFICE, que tendrán los mensajes de correo de MS Exchange y estarán conectados en el módulo Correo de ONLYOFFICE para los usuarios listados en el archivo users.csv;
• el archivo results-ok.txt se guardará en la carpeta Import, contendrá la lista de todas las cuentas de usuario del archivo users.csv y sus contraseñas, que se crearon con éxito;
• el archivo result-err.txt se guardará en la carpeta Import, contendrá la lista de todas las cuentas de usuario del archivo users.csv, que tuvieron problemas cuando fueron importadas y creadas;
• el archivo mailboxes.json en formato JSON se guardará en la carpeta Import, contendrá la lista de configuraciones necesarias para conectar a los nuevos buzones desde los clientes de correo de terceros.

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