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:

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
;

CommuniGate® Pro Guide. Copyright © 2003, Stalker Software, Inc.