Converting from Imail to MailSite This document provides a guide on how to use the built in command line utilities to migrate from Imail to MailSite.

Migrating Mail Accounts

1. Install MailSite on the server with the services turned off
2. Start the LDAP service in Imail
3. In MailSite, create the required email domains.
4. Click on the default domain, then select domain properties. Under the 'Mailbox Root directory' enter a path such as 'c:\mailsite\box' or somewhere outside of the MailSite installation directory.
5. Note down how many mailboxes are present in each domain in Imail
6. Run the msconvuser command to convert the mail accounts. A suggested command is provided below:
   
   msconvuser -t -s Imaildomain.com -m imail MailSitedomain.com > msconvuser.txt
   
   Where: Imaildomain.com is the name of the domain in Imail, and MailSitedomain.com is the name of the domain in MailSite you want to migrate the mailboxes. Some deployments of Imail have domains specified in mail.domain.com format. For example a domain test.com would be mail.test.com. In MailSite you simply specify test.com
   
   Note: The '> msconvuser.txt' is an optional command used to pipe the results of the command to a text file. In situations where you have a lot of mailboxes to convert, the command window may not display all the results. With the pipe command the results are written to a text file for post analysis.
   
   
7. The above command will create a file called msconvuser.txt in the MailSite directory which contains the tracing.
8. There is a known issue where if an existing Imail mailbox has a password that is greater than 16 characters, the conversion utility will fail. If this occurs, you should reset the password for the duration of the migration, then have the user reset the password once you are running MailSite.
9. After the command has finished, count the number of mailboxes in MailSite, make sure it adds up to the mailboxes in Imail.
10. You will need to run this command for all domains you wish to migrate.

Migrating the Message Store

1. Once the mail accounts have been migrated, you will need to migrate the message store. If the majority of your users are POP users, there will only be a small amount of data to transfer.
2. The msconv tool is used for this. A suggested command is provided below:
   
   msconv -t -s imaildir -m imail c:\mailsite\box
   
   Where imaildir is the path of the users folder in imail for the default domain and c:\mailsite\box is the path you specified in step 4 under 'Migrating Mail Accounts'. This is the path where email for the default domain will be stored
3. This needs to be run for each of your domains.
4. Typically MailSite stores email for additional domains using the following convention
   
   c:\program files\mailsite\box\~joescompany.com
   c:\program files\mailsite\box\~bob.com
   
   
5. When running the command for a virtual (or additional domain) you would use the following command:
   
   msconv -t -s imaildir1 -m imail c:\mailsite\box\~domain.com
   
   Where imaildir1 is the path of the users folder in imail for the additional domain you want to convert and c:\mailsite\box\~domain.com is the path where MailSite will store email for this domain.

Known Limitations

• When you migrate the message store, the NTFS timestamps are reset on the messages. When viewing the messages through MailSite Express, the messages will appear new with today's date. This is because MailSite Express uses the NTFS time. ExpressPro will display the messages correctly. MailSite ExpressPro uses the time from the headers.
• Msconvuser will fail if a mailbox has a password that is greater than 16 characters in length. Reset such passwords to a smaller length.