ZCS Administrator Guide 8.0
ZCS Administrator Guide 8.0
Network Edition


Provisioning User Accounts > Migrate Existing Accounts and Import Account Email

Migrate Existing Accounts and Import Account Email
You can provision multiple accounts at one time using the Account Migration Wizard from the administration console. You can import accounts from either a generic IMAP server or from another ZCS server.
Note:
You can also import account names to provision from an XML file that you create.
Note:
You can run the migration wizard one time to provision accounts and import data or you can run the migration wizard the first time to provision the accounts and then run the wizard again to import the provisioned accounts’ data.
Whether you get the account records from an LDAP directory or use an XML file, you need to set the password requirements for the newly provisioned accounts. The options are to have ZCS randomly create passwords for each account or to set the same password on each account. You have the option to force users to change the password when they sign in the first time.
When the provisioning is complete, the wizard generates a .csv file with a list of new accounts. This includes the passwords that are generated. You should download this file for future reference. Choose a secure location to store the file as it can contain password information for the user accounts you provisioned.
If you running a split domain configuration, you can set the SMTP host and port in the wizard. For more information about split domains, see the wiki article about split domains at http://wiki.zimbra.com/wiki/Split_Domain.
Migrate Accounts from a Zimbra Server
You can migrate accounts from a server running ZCS 7.2.0 or later to ZCS 8.0.
1.
2.
In the Type of mail server field, select Zimbra Collaboration.
3.
If you are provisioning accounts, select Yes to import the account’s records. If you are not going to import the data at this time, in the Would you like to import mail, select No.(
4.
Click Next.
5.
On the Overview dialog, Import from another Zimbra LDAP directory is selected. Click Next.
6.
On the Bulk provisioning options page, select whether to generate random passwords or to assign the same password for each account.
 
Option 
Description 
7.
Click Next.
8.
On the Directory connection dialog enter the information to connect to the server.
 
Option 
Description 
9.
Click Next.
The Account Migration Wizard connects to the directory server and generates a report showing the number of domains found; number of accounts found on the server and how many of those accounts are already created on ZCS. This dialog also shows the password options you configured.
10.
Review the report generated and then click Next. The accounts are provisioned on the ZCS server.
11.
Migrate Accounts from Generic IMAP Servers
These steps provision accounts on the Zimbra server.
1.
2.
In the Type of mail server field, select Generic IMAP Server.
3.
If you are provisioning accounts, select Yes to import the account’s records. If you are not going to import the data at this time, in the Would you like to import mail, select No.(
4.
Click Next.
5.
On the Overview dialog, Import from another LDAP directory is selected. Click Next.
6.
On the Bulk provisioning options page, select whether to generate random passwords or to assign the same password for each account.
 
Option 
Description 
7.
Click Next.
8.
On the Directory connection dialog enter the information to connect to the server.
 
Option 
Description 
In this field enter the LDAP search filter to run. Here you can define search criteria to collect the type of account information you want to import. The default filter in the field is (objectClass=organizationalPerson). This filter gathers account information, including email address, individual first, middle, last names, postal and phone number information if available. You can change the filter.
9.
Click Next.
The Migration Wizard connects to the directory server and generates a report showing the number of domains found; number of accounts found on the server and how many of those accounts are already created on ZCS. This dialog also shows the password options you configured.
10.
Review the report generated and then click Next. The accounts are provisioned on the ZCS server.
11.
Migrate Accounts using an XML File
Create an XML file with the account information and save it to a computer you can access.
1.
2.
In the Type of mail server field, select the type of server your are migrating from.
3.
If you are provisioning accounts, select Yes to import the account’s records. If you are not going to import the data at this time, in the Would you like to import mail, select No.(
4.
Click Next.
5.
On the Overview dialog, select Import from an XML file. Click Next.
6.
The Review options dialog displays the number of domains; number of accounts and the password options configured in the XML file.
7.
If this information is correct, click Next. If this information is not correct, fix your XML file before proceeding.
If you clicked Next, the accounts are provisioned on the ZCS server.
8.
Importing Email for Selected Accounts
You can specify the list of accounts whose mail you want to import by either selecting the accounts to import data or by using an XML file to select the accounts. The accounts must be provisioned on the ZCS server.
1.
2.
In the Type of mail server field, select the type of server your are importing the data from.
3.
In the Would you like to import account records menu, select No.
4.
In the Would you like to import mail menu, select Yes.
5.
Click Next.
6.
On the Import options dialog box, select which way you are going to specify the accounts whose mail is being imported. Click Next.
If you are selecting accounts, go to step 7. If you are using an XML file go to step 8.
7.
Add the accounts to the Accounts for data import column.
Click Next.
8.
9.
10.
Examples of XML Files
Below are three examples of the XML file structure to provision accounts and import data.
Example of provisioning accounts. The following example shows an XML file that is used to provision multiple email accounts without importing mail:
 
Example of provisioning accounts from externally hosted domains. The following example shows an XML file that is used to provision multiple email accounts for externally hosted domain without importing mail. In this example, the zimbraMailTransport attribute of newly provisioned accounts will be set to point to external SMTP server instead of the ZCS server.
 
Example of importing email. The following example shows an XML file that is used to import email for one account via IMAP from a gmail account without provisioning the email account in ZCS. The account must be provisioned on ZCS before running this type of XML file.
 
Copyright © 2012 VMware Inc.