Products: IMail Server Plus, IMail Server Premium, Collaboration WorkgroupShare, IMail Server

How to move IMail to a new server

« Go Back


This article describes the most streamlined process for moving an existing IMail installation to a new server.  Detailed steps are below, but the general process is as follows:
  • Export configurations and data from old server.
  • Import configurations and data to new server.
  • Shut down the old server.
  • Migrate IP addresses if needed.
  • Run the IMail installer on the new server.
  • Confirm new server functionality
Note: This process should work regardless of the IMail version on the old server, but it is recommended that you install 12.1 or later on the new server to ensure proper conversion of databases.
Note:  IMail licensing will not allow activation of the same license on two machines at the same time. If you wish to perform a mock run of the migration process, you can download a trial version of IMail to run temporarily on the new machine:  Otherwise, you will need to be prepared to deactivate IMail on the old server before installing IMail on the new machine.
  1. Using the Registry Editor, export the following registry keys from the old server:
    • HKEY_LOCAL_MACHINE\SOFTWARE\Ipswitch\IMail\Domains
    • HKEY_LOCAL_MACHINE\SOFTWARE\Ipswitch\IMail \Global
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SMTPD32
  2. Copy the registry export file to the new server and import it into the registry of the new server. If the old machine is 32bit and the new machine is 64bit, you MUST use the 32bit registry editor (c:\windows\syswow64\regedt32.exe from the run command) to import the 32bit registry into the 32bit Node on the 64bit server.
    • Note: You must close the 64 bit registry editor before you try running the 32 bit registry editor, otherwise it defaults back to the 64 bit editor.
    • Note: If drive or path structure is going to change, for example, on old server the install path was C:\IMail but on new it will be D:\Imail, you need to edit the registry file to reflect this change before moving forward.
    • Note: If the IP address scheme on the new server is also going to change, you must edit the registry file to reflect this change before moving forward.)
  3. If you are using an external user database, create the new ODBC System DSN on the new server.
    • Note: If the new server is a 64 bit, you must use the 32 bit ODBC  (c:\windows\syswow64\odbcad32.exe from the run command) to create the new DSN.
  4. If you are using SQL Express for the WorkgroupShare database on the old server:
    • Back up the SQL database on the old server and move the backup file to the new machine.
    • Install SQL Express on the new machine using the following instructions.
    • Restore the database backup from within SQL Express on the new machine.
  5. Stop All IMail services on the old machine.
  6. Copy All of the Domain/User’s data from the old server to the new using the same data paths, unless you changed them in step 2.
    • To determine a domain's top directory, open the IMail Administrator and check the domain's properties for the "Top Directory" value. Copy the entire domain directory to the new server, unless the domain’s top directory is the same as the IMail install directory (c:\IMail for example).
    • If the domain top directory and IMail install directory are the same, then copy the following folders and files:
      • Users folder
      • Lists folder
      • Group aliases (aliasName.lst)
      • ab.txt - Attachment Blocking List
      • antispam-table.txt - Anti-Spam Word List
      • Kill.lst - SMTP Kill File
      • orules.ima - Outbound Rules
      • phrase-list.txt - Anti-Spam Phrase List
      • rules.ima - Inbound Rules
      • smtpd32.acc - SMTP Control Access List
      • smtpd32.loc - SMTP Relay for Addresses List
      • smtpd32.ewl - SMTP White List
      • spamblks.txt - Enabled DNS Blacklist
      • spamblkm.txt - All DNS Blacklist configured in IMail
      • url-domain-bl.txt - URL Domain Black List
      • white-list.txt - White List
      • spamskip.txt - List of trusted IPs
      • Workgroupshare.mdb from …\workgroupshare\data and place it in the same path (If using SQL for the Workgrouphshare database, this file does not need to be moved)
  7. If you were running a version of IMail on the old server that was older than 9.0 and your users had webmail contacts, you will need to run a conversion utility import them into the new database. To do this, run wgscvt.exe from the IMail top directory.  This may take some time if you have alot of users/contacts.
  8. Shut the old server down, and add the old server’s IP addresses to the new server, unless you changed the IP addresses in step 2.
  9. Run the IMail installer and ensure that the install path(s) are correct during the installation setup, and when it asks about the WorkroupShare database, select:
    1. If Using SQL: "Use Existing SQL Server" and select the server set up in step number 4 above.
    2. If using Access: Use Access DB.
  10. Open the console admin and check for domains/users and correct paths.
  11. Log into web mail and send a message to test functionality.  
  12. If a trial license was used, you can now deactivate your paid license on the old server and apply it to the new server. How to Activate/Deactivate IMail
  13. If you are licensed for and using Bitdefender or Symantec AV you may install it at this time. CYREN AV is included with the IMail installation if you are licensed for it.
  14. Migration completed.
VersionAll Versions

Customer Service Softwaresalesforce.comHome | Product