Миграция с Microsoft® Exchange на CommuniGate Pro

Утилита ex2cgp.exe позволяет перенести учётные записи пользователей и данные почтовых ящиков (Почта, Календарь, Контакты, Задачи, Заметки) с сервера Microsoft Exchange на сервер CommuniGate Pro.

Возможности:

Экспорт списка почтовых ящиков и значений указанных атрибутов пользователей Exchange в .csv файл.
Экспорт почтовых контактов Exchange и значений указанных атрибутов в .ldif файл.
Импорт учётных записей пользователей из .csv файла на CommuniGate Pro.
Копирование данных почтовых ящиков пользователей Exchange в учётные записи пользователей CommuniGate Pro.

Ограничения:

Утилита ex2cgp может быть использвана только для локальных (on-premises) инсталляций Exchange (не работает с облачными инсталляциями).
Утилита ex2cgp не может быть использована для экспорта паролей почтовых ящиков пользователей Exchange.
Утилита ex2cgp экспортирует только основные e-mail адреса почтовых ящиков пользователей Exchange.
За раз могут быть скопированы данные только почтового ящика целиком (инкрементальное копирование не поддерживается).

Требования:

На ПК для миграции:
- ОС Microsoft Windows 7 x64 или новее.
- Microsoft Outlook 32-bit (2016 or 2019 рекомендуется) без сторонних надстроек.
- Права локального администратора в ОС.
Учётная запись в домене Exchange, данные которого нужно перенести, имеющая:
- Членство в группе Администраторы предприятия в AD.
- Полные права (FullAccess) на ящики пользователей, данные которых нужно скопировать (См. опцию командной строки --no-admin).

Замечание: Не рекомендуется запускать утилиту ex2cgp в той же ОС, где установлен сервер Microsoft Exchange.

Загрузка утилиты миграции

Операционная система	CPU	Загрузка
Microsoft Windows	Intel

Содержимое архива:

ex2cgp.exe – исполняемый файл утилиты миграции;
ex2cgpui.exe – графический интерфейс утилиты миграции;
ex2cgp.ini – конфигурационный файл, который содержит:

Список атрибутов, которые необходимо экспортировать для почтовых ящиков пользователей и почтовых контактов Exchange;
Сопоставления тегов свойств MAPI и имён атрибутов.

Подготовительные шаги

1) Создать конфигурацию Outlook.

2) Добавить учётную запись Exchange, являющуюся членом группы Администраторы предприятия в Active Directory.

3) В параметрах учётной записи отключить "Использовать режим кэширования Exchange".
Внимание: в конфигурации Outlook не должно быть других учётных записей, кроме добавленной учётной записи Exchange.

4) На сервере назначения CommuniGate Pro создать домен с таким же именем, как у домена Exchange который необходимо перенести.

Необязательно:

Если нужно экспортировать атрибуты почтовых ящиков пользователей и почтовых контактов Exchange, необходимо подготовить файл ex2cgp.ini:

Для почтовых ящиков пользователей указать в разделе [csv] атрибуты с сопоставлениями тегов MAPI.
Для почтовых контактов указать в разделе [ldif] атрибуты с сопоставлениями тегов MAPI.

Запуск ex2cgp

Графический интерфейс ex2cgpui.exe (или команду ex2cgp.exe из командной строки) необходимо запускать от имени Администратора.

Графический интерфейс

Параметры экспорта из Microsoft Exchange

Microsoft Exchange MAPI profile:

Имя конфигурации Outlook с учётной записью Exchange.

Export Accounts to CSV file:

Экспортировать список почтовых ящиков пользователей Exchange в .csv файл.
Этот файл содержит список пользователей Exchange, данные которых нужно скопировать в CommuniGate Pro.
По умолчанию, файл содержит 4 поля:

account: Значение этого поля берётся из псевдонима почтового ящика пользователя Exchange (атрибут mailNickname) и может быть использовано в качестве псевдонима пользователя CommuniGate Pro.
dn: Это поле содержит идентификатор почтового ящика пользователя Exchange (атрибут legacyExchangeDN), данные которого нужно скопировать в CommuniGate Pro.
mailbox: Значение этого поля берётся из основного e-mail адреса почтового ящика пользователя Exchange (атрибут mail) и используется в качестве имени пользователя CommuniGate Pro.
RealName: Значение этого поля берётся из Выводимого Имени пользователя Exchange (атрибут cn) и используется в качестве Настоящего Имени пользователя CommuniGate Pro.

Export Global Address List to LDIF file:

Экспортировать почтовые контакты Exchange в .ldif файл.
Этот файл может быть использован для импорта почтовых контактов Exchange в Справочник CommuniGate Pro.

Target Subtree:

Поддерево LDAP в Справочнике CommuniGate Pro для хранения почтовых контактов Exchange.

Translate attributes using:

Экспортировать атрибуты почтовых ящиков пользователей и почтовых контактов Exchange (номер телефона, должность, и т.д.).
Укажите имя .ini файла со списком атрибутов Exchange.

Export Distribution Lists to script file:

Экспортировать списки рассылки Exchange в CLI скрипт для создания групп CommuniGate Pro.

Параметры импорта в CommuniGate Pro

Server:

Имя хоста или IP-адрес сервера CommuniGate Pro.
Если порты IMAP и/или PWD отличаются от значений по умолчанию (143 и 106) необходимо указать используемые значения, например: 10.0.0.1:143:8106

Use a secure (SSL/TLS) connection

Использовать безопасное соединение с CommuniGate Pro.

Administrator Name:

Имя учётной записи администратора CommuniGate Pro, имеющей необходимые права доступа.

Administrator Password:

Пароль учётной записи администратора CommuniGate Pro.

Import Accounts from CSV file:

Файл .csv для импорта информации учётных записей.
Если используется опция Export Accounts to CSV file, это поле не может быть изменено.

Create CommuniGate Pro accounts

Создать пользователей CommuniGate Pro, указанных в .csv файле.

Домен для пользователей должен существовать на сервере CommuniGate Pro.
Для имён пользователей используются значения поля mailbox из .csv файла.
Для Настоящих Имён пользователей используются значения поля RealName из .csv файла.
Пользователи создаются с пустыми паролями.

Create Aliases

Создать псевдонимы для пользователей CommuniGate Pro.
Для имён псевдонимов используются значения поля account из .csv файла.

Reverse Aliases

Использовать значения поля account для имён пользователей CommuniGate Pro и значения поля mailbox для псевдонимов CommuniGate Pro.

Copy Mailboxes (Folders)

Копировать данные почтовых ящиков пользователей Exchange, указанных в .csv файле, в учётные записи пользователей CommuniGate Pro.

В качестве аккаунта источника используется почтовый ящик Exchange с legacyExchangeDN, указанным в поле dn в .csv файле.
В качестве аккаунта назначения используется пользователь CommuniGate Pro с именем (или псевдонимом), указанным в поле mailbox в .csv файле.
Пользователь назначения должен существовать на сервере CommuniGate Pro.
Если пользователь назначения уже содержит какие-либо данные, то скопированные данные будут добавлены к существующим.

Map Public Folders to

Копировать данные общих папок Exchange в учётную запись пользователя CommuniGate Pro.

Fix Folder names

(рекомендуется) Исправлять имена папок Exchange, которые не поддерживаются CommuniGate Pro.

Ignore Errors

(рекомендуется) Игнорировать незначительные ошибки, возникающие в процессе миграции.

Import passwords from:

Устарело. Не поддерживается.

Create Groups using script file

Создать группы CommuniGate Pro из CLI скрипта.

Skip imap objects

Не копировать почтовые объекты.
Используйте эту опцию, если хотите перенести из Exchange только непочтовые данные (Календарь, Контакты, Задачи, Заметки).

Command Line

Это поле содержит строку для запуска утилиты из командной строки, которая выполняется при нажатии кнопки Process.

Опции Командной Строки

 ex2cgp.exe command(s) options
   mailboxes
     [--profile=mapi-profile] [--accounts=csv-file] [--ini=ini-file]
   ldif
     [--profile=mapi-profile] [--ldif=ldif-file] [--ini=ini-file]
     [--target-dn=distinguished-name]
   accounts
      --accounts=accounts-file --server=pwd-server [--ssl]
     [--account=postmaster] [--pwd=postmaster-passwd]
   passwords
      --accounts=accounts-file --passwds=pwdump-file --server=pwd-server
     [--ssl] [--account=postmaster] [--pwd=postmaster-passwd]
   transfer
     [--profile=mapi-profile] --accounts=accounts-file --server=imap-server
     [--ssl] [--account=postmaster] [--pwd=postmaster-passwd]
     [--fix-folders]

Команды:

mailboxes: Экспортировать почтовые ящики пользователей Exchange в .csv файл.
ldif: Экспортировать почтовые контакты Exchange в .ldif файл.
accounts: Создать пользователей CommuniGate Pro, указанных в .csv файле.
transfer: Копировать данные почтовых ящиков пользователей Exchange, указанных в .csv файле, в учётные записи пользователей CommuniGate Pro.

Опции:

--profile: Имя конфигурации Outlook с учётной записью Exchange.
--accounts: Имя .csv файла для экспорта списка почтовых ящиков пользователей Exchange и/или имя .csv файла для импорта учётных записей пользователей на CommuniGate Pro.
--ldif: Имя .ldif файла для экспорта почтовых контактов Exchange.
--target-dn: Поддерево LDAP в Справочнике CommuniGate Pro для хранения почтовых контактов Exchange.
--ini: Экспортировать атрибуты почтовых ящиков пользователей и почтовых контактов Exchange (номер телефона, должность, и т.д.).
Укажите имя .ini файла со списком атрибутов Exchange.
--server: Имя хоста или IP-адрес сервера CommuniGate Pro.
--ssl: Использовать безопасное соединение с CommuniGate Pro.
--port: Порты IMAP и PWD для подключения к серверу CommuniGate Pro.
--account: Имя учётной записи администратора CommuniGate Pro, имеющей необходимые права доступа.
--pwd: Пароль учётной записи администратора CommuniGate Pro.
--passwds: Устарело. Не поддерживается.
--fix-folders: Исправлять имена папок Exchange, которые не поддерживаются CommuniGate Pro.
--skip-imap: Не копировать почтовые папки (папки с ContainerClass IPF.Note).
--skip-imap2: Не копировать почтовые папки и папки с пустым ContainerClass.
--no-wait: В случае возникновения ошибки закрывать окно консоли и не требовать нажатия Enter.
--no-admin: Переключение на режим работы, в котором учётной записи Exchange, используемой для миграции, не требуется членство в группе Администраторы предприятия в AD, а требуются полные права на копируемые ящики.

Примеры:

ex2cgp mailboxes ldif --ini=ex2cgp.ini --profile=msexch --accounts=accounts.csv --ldif=gal.ldif: Экспортирует почтовые ящики пользователей и почтовые контакты Exchange в файлы accounts.csv и gal.ldif.
ex2cgp accounts transfer --profile=msexch --accounts=accounts.csv --server=mail.company.com --ssl: Создает пользователей CommuniGate Pro из файла accounts.csv и переносит данные почтовых ящиков пользователей Exchange.

Сопоставления тегов свойств MAPI и имён атрибутов


;NAME
3A0F001E=cn
3A06001E=givenName
3A0A001E=initials
39FE001E=mail
3A11001E=sn
;HOME
3A15001E=homePostalAddress
3A59001E=l
3A5C001E=st
3A5B001E=postalCode
3A5A001E=c
3A09001E=homePhone
3A25001E=facsimileTelephoneNumber
3A1C001E=mobile
;BUSINESS
3A16001E=o
3A29001E=postalAddress
3A27001E=l
3A28001E=st
3A2A001E=postalCode
3A26001E=c
3A17001E=title
3A18001E=ou
3A19001E=physicalDeliveryOfficeName
3A2B101E=postOfficeBox
3A08001E=telephoneNumber
3A23001E=facsimileTelephoneNumber
3A24001E=officeFax
3A21001E=pager
;other
3004001E=info
806F101E=description