Migration Wizard for Exchange Install Guide 6.0, Rev 7/2010
Table of Contents Previous Next


Migrating from Microsoft Exchange to Zimbra Collaboration Suite : Appendix A  About XML files used in the Migration Wizard

Appendix A  About XML files used in the Migration Wizard
The following XML files can be created and used in the ZCS Migration Wizard for Exchange.
The following section describe the XML elements for each type.
Preparing an XML File for One-Step Migration
You can create an XML document with data and use the file to migrate users from Exchange to ZCS. Run the ZCS Migration Wizard and select One-Step Migration on the Import Destination dialog to migrate the files from Exchange.
The format for the XML configuration file is a follows.
 
                <User>
                  <ExchangeMail></ExchangeMail>
                  <password></password>
                  <zimbraPasswordMustChange></zimbraPasswordMustChange>
 
Understanding the XML Elements
 
Import mail, contacts, tasks, calendar items, deleted items (Trash), and junk
Invalid SSLOk. Set this value to 1 if you do not install a valid commercial SSL certificate on ZCS before the migration. The Migration Wizard accepts the ZCS server’s SSL certificate even if it is not a valid commercial certificate. The Migration Wizard does not proceed with the migration if the SSL certificate is invalid.
The value for elements under <Options> can be set as 1 (TRUE) or 0 (FALSE). If no value is entered for an element, the value is considered as 1 (TRUE).
The <ZimbraServer> element contains all the Zimbra server details. These values are used by the Migration Wizard to log in to the ZCS server and execute the provisioning tasks.
<serverName>. The host name of the ZCS server
<port>. The default admin services port, usually 7071
<adminUserName>, <password>. ZCS administrator’s name, password
<adminSSLenabled> This value is set to 1
<domain>. The ZCS domain name where account are migrating to. This domain must already exist on the ZCS server
<profile>. Outlook profile name
<server>. Exchange server name
<logonUserDN>. Logon DN used to access the Exchange server for the migration.
When you run one-step migration, the Migration Wizard automatically creates a migration account on the Exchange server and generates a MAPI profile. When the migration is completed, the account and MAPI profile are deleted.
    
The <ImportUser> value is the names of accounts on the Exchange Server that are migrating.
<user>. N number of users are added under this element <User>name</User. The following are subset elements for <User>
<ExchangeMail>. This is the user’s Exchange email address.
<password>. The user password.
<zimbraPasswordMustChange>. Whether this password must be changed on the ZCS server. TRUE or FALSE. Default is TRUE.
The <UserProvision> elements describe default and general options for account provisioning.
<provisionUsers>. To provision accounts on ZCS set this to 1. If this is set to 0, when the migration wizard runs, no accounts are created.
<COS>.(optional) Specify the Class of Service to assign to the accounts being migrated. If a COS is not specified, the default COS for the domain specified in <domain> is used.
<initialPassword>. This value is the default password to be set for user accounts. This value is used only when the <User> element does not contain the <password> element.
<zimbraPasswordMustChange>. Whether the <initialPassword> value must be changed on the ZCS server. TRUE or FALSE. Default is TRUE.
Mapping Exchange User IDs to ZCS User IDs
You can create an XML file that maps the user’s common name on the Exchange server to the user’s common name to be used on the ZCS server. When you run the migration wizard and prepare the source and destination mailboxes, you select UserMap and select the XML file to be used.
The format for the XML configuration file is a follows.
 
 
The Exchange server from where the user account information is extracted.
<ExchangeMail>. This element is user address (“mail” attribute) of the Exchange user that is being migrated.
<ZimbraAccount>. This element is the account on the ZCS server where the user mailbox would be migrated.
Example of the <User> element:
 
The destination ZCS domain is configured on the Destination Domain dialog. During the migration, the destination account ID is created by appending this domain name to the <ZimbraAccount> value. For example, if the destination domain name is zimbradomain.com, the above XML data would create an account ID called zimbraexample1@zimbradomain.com, and the user’s Exchange mailbox is migrated.
 

Migrating from Microsoft Exchange to Zimbra Collaboration Suite : Appendix A  About XML files used in the Migration Wizard

Table of Contents Previous Next
Migration Wizard for Exchange Install Guide 6.0, Rev 7/2010
Copyright © 2010 Zimbra Inc.