Migration from Microsoft(r) Exchange to CommuniGate Pro

The ex2cgp.exe command-line utility allows you to migrate user accounts, mailboxes, items, and address books from a Microsoft Exchange server to a CommuniGate Pro system.

The ex2cgpui.exe utility is a GUI (graphical user interface) "wrapper" for the ex2cgp.exe command-line utility.

You should use a freeware pwdump3 program to retrieve user passwords("password hashes") from a Windows/Exchange system. You can download the version 2 of this program from this site, or may want to look for a newer version on the Internet.

The ex2cgp.exe utility implements the following operations:

Export accounts from Exchange to a .csv file.
Export Global Addresses List Contacts from Exchange to a .ldif file.
Import accounts from the .csv file into CommuniGate Pro.
Set CommuniGate passwords from a file generated by pwdump3.
Transfer all folder contents (mail, calendars, task, journals, notes, contacts, etc) from Exchange to CommuniGate Pro.

Note: Because the Exchange Installer replaces several standard Windows system libraries with their modified versions, it is recommended to run the migration utilities on a Windows system that does NOT have the Exchange server software installed.

Migration Utility Download

Operating System	CPU	Download
Microsoft Windows	Intel

Graphical User Interface Wrapper

Open the Mail Control Panel and create a profile for an Exchange server connection. The profile login parameters should provide enough rights to access the Global Address List and to take ownership of all user mailboxes.

Prepare a .ini text file with the list of Exchange properties you want to retrieve and the names of CommuniGate Pro account settings these properties should be converted to. The utility software archive contains a default .ini file.

Use the freeware pwdump3 program to create a file with Exchange account passwords.

Start the ex2cgpui.exe application:

Source Microsoft Exchange System

Microsoft Exchange MAPI profile:: Use this field to select the MAPI profile you have created.
Export Accounts to CSV file:: Use this field to specify the name for a file that will store the account data exported from the Exchange server.
Export Global Address List to LDIF file:: Use this field to specify the name of a file that will store the exported Global Address List information.
Later you can use this file with the CommuniGate Pro WebAdmin Interface to import the Global Address List information into the Directory.
Target Subtree:: Use this field to specify the Base DN of the exported LDIF data.
Translate attributes using:: Use this field to specify the name of the .ini file with the list of Exchange attributes ("properties").
Export Distribution Lists to script file:: Use this field to specify the name of the CLI script to be generated for creating Exchange Distribution Lists as CommuniGate pro Group objects.

Target CommuniGate Pro System

Server:: Use this field to specify the name or the network address of the CommuniGate Pro server. If the IMAP and/or PWD ports differ from the default ones (143 and 106) append the correct ports, e.g.: 10.0.0.1:143:8106
Use a secure (SSL/TLS) connection: Select this option to use encrypted connections to the CommuniGate Pro server.
Administrator Name:: Use this field to specify the name of a CommuniGate Pro administrator account with necessary access rights.
Administrator Password:: Use this field to specify the password of the CommuniGate Pro administrator account.
Import Accounts from CSV file:: Use this field to specify the name of the file to import the account information from. Usually it is the file specified in the Export Accounts to CSV file field.
Create CommuniGate Pro accounts: Select this option to create CommuniGate Pro accounts for all names listed in the Import CSV file.
Create Aliases: Select this option to create aliases for CommuniGate Pro accounts.
Reverse Aliases: Select this option so CommuniGate Pro accounts are created with Exchange alias name and Exchange account name is used for CGPro account alias.
Copy Mailboxes (Folders): Select this option to copy all mailboxes/folders and messages from the listed Exchange accounts into the CommuniGate Pro accounts.
Map Public Folders to: Specify the name of CGPro account to store the data migrated form Exchange Public Folders.
Fix Folder names: Select this option to enable automatic fixing of the folder names (removing illegal characters, forwarding and trailing spaces).
Ignore Errors: Make the utility to ignore errors during the migration process.
Import passwords from:: Use this field to specify the name of the file containing passwords for the listed accounts.
Create Groups using script file: Use this field to specify the name of the script file used to create CGPro Group objects.

Command Line

This field contains the command line to be executed when you click the Process button.

Command Line Options

 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]

Commands:

mailboxes: Dump mailboxes existing in GAL (Global Address List) into a .csv file
ldif: Dump contacts from GAL into a .ldif file. The .ldif file should be imported into CommuniGate Pro Central Directory via WebAdmin interface
accounts: Create CommuniGate Pro accounts using the information in the .csv file
passwords: Update accounts passwords in CommuniGate Pro using the passwords file created with the pwdump3 program (make sure the Exchange aliases are equal to Windows account names)
transfer: Copy mailboxes and mailbox items form Exchange to CommuniGate Pro

Options:

--profile

Specify a MAPI profile to connect to Exchange server (be sure it has sufficient rights to access GAL and take ownership of user mailboxes)

--accounts

Specify the name of the .csv file to be used as the output of the accounts command, and as the source file for other commands.
There are 3 mandatory columns in this file: account (Windows NT account name for the Exchange mailbox), mailbox (mailbox SMTP address to be used as the CommuniGate Pro account name), RealName

--ldif

Specify the name of the .ldif file to be used for the ldif command output.

--target-dn

Specify the Base DN for the ldif command output.

--ini

Specify the name of the .ini file with custom attributes to be used for the accounts and ldif commands

--server

The Internet domain name of the CommuniGate Pro server, optionally followed with a colon, imap port number, colon and CLI port number:

     --server=mail.stalker.com:143:106

--ssl

flag requesting secure (SSL/TLS) connections

--port

The CommuniGate Pro MAPI or Admin port number (default is 143 for IMAP/MAPI and 106 for PWD/CLI)

--account

The name of the CommuniGate Pro administrator account with necessary access rights (default is postmaster@server)

--pwd

The password of the CommuniGate Pro administrator account

--passwds

the pwdump3 output file name

--fix-folders

flag enabling automatic fixing of bad folder names

Examples:

ex2cgp mailboxes ldif --ini=ex2cgp.ini --profile=msexch --accounts=accounts.csv --ldif=gal.ldif: Exports mailboxes and contacts from GAL into accounts.csv and gal.ldif files.
ex2cgp accounts passwords transfer --profile=msexch --accounts=accounts.csv --passwds=pwdump3.txt --server=mail.company.com --ssl: Creates acounts, updates passwords and migrates mail.

Sample `.ini` file (MAPI tag on the left, attribute name on the right)


[csv]
3A06001E=FirstName
3A11001E=LastName
3A16001E=Organization

[ldif]
;NAME
3001001E=cn
3A06001E=givenName
3A0A001E=initials
3A11001E=sn
39FE001E=mail
;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
3A08001E=telephoneNumber
3A23001E=officeFax
3A24001E=officeFax
3A21001E=officePager
;other
3004001E=comment
806F101E=info
;