Zimbra Outlook PST Import Wizard Tips

Revision as of 22:38, 17 July 2007 by Bobby (talk | contribs)

Zimbra Outlook PST Import Wizard Tips

Sometimes you may have difficulty importing your PST with the Zimbra PST Import Wizard. This may be due to the version of your PST file (i.e. Outlook 2000), the condition of your PST file, or emails with unusually large attachments. Here are a few tips that might help solve some sticky PST import problems.

Outlook Version

  • You must have Outlook XP or 2003 installed on the machine you are running the Import Wizard on (ideally Outlook 2003). Outlook 2000 and earlier is not supported. If you can't locate a machine with Outlook XP/2003, then you can install Microsoft's trial version of Office 2003. The import wizard does not actually load Outlook during the conversion, but does access some of its libraries therefore it must be installed.

PST Preparation

  • Make a backup of your PST file! If you are going to use your old Outlook 97-2002 PST to do the import, it may not work with the older Outlook versions after loading it with Outlook 2003.
  • You may need to re-export your old PST to a new Outlook 2003 PST. This will clean up any inconsistencies and make the import wizard's job much easier. This may be particularly the case if your PST came from Outlook 2000 and earlier.
  • Use SCANPST.EXE to repair your PST beforehand to clean up any problems with your PST before you import. You can find SCANPST.EXE by searching for it in Windows ((START => Search => For files or folders)). For an en-US Outlook 2003 installation it should be located under c:\program files\common files\system\msmapi\1033\.

Message size limitations

  • By default, the migration tools have a local 10MB limit on the encoded size of uploaded messages. Do not confuse this encoded size with Outlook's reported attachment size. A file with an 8MB attachment will encode to an email over 10MB, and will therefore not be imported. A 12MB attachment = 16MB encoded, a 14MB attachment = 19MB encoded.
  • The 10MB limit can be adjusted by adding a registry key to the Windows machine running the Import Wizard. The key/value is:

You can adjust this using RegEdit (Start -> Run -> regedit). Add a key called HKEY_CURRENT_USER\Software\ZCSMigWiz. Then add a DWORD Value called MaxAttachSizeMB and assign it a value (in MB obviously; e.g 15 = 15MB). The next time the Import Wizard runs, it will use this value.

Note: The default mta settings on the Zimbra server also limit attachments (and complete mime-encoded messages) to 10mb.

RAM Requirement

  • Importing PSTs with large attachments requires a lot of physical RAM in the Zimbra server. It is best that you have the minimum required RAM according to the Zimbra specs (1GB). However you may be able to import most or all of your messages with less. An email with a 14MB attachment may not import to a machine with 768MB of RAM and standard heap settings. If you really must live with less physical RAM, a temporary workaround for migration purposes is to increase the Tomcat/Java heap size on the server. The heap size defaults to 30% of all available physical RAM. You can increase that percentage (for example, to 40%) by using the following commands on the Zimbra server:
# su - zimbra
$ zmlocalconfig -e tomcat_java_heap_memory_percent=40
$ tomcat stop
$ tomcat start

WARNING: Remember to set the heap size back to the previous value after you are done!

Jump to: navigation, search