|
|
Upgrading
This section is for users who are upgrading from a previous version of IMail Server. IMail Server is automatically installed in the same directory where you had the previous version or evaluation version. This directory should not be changed, moved, or renamed.
- (Start regedit.exe, locate this key and select Export Registry File from the Registry menu.)
- Follow the same instructions as for new installs.
Note: You must stop all IMail services and close the IMail Administrator interface before upgrading. Upgrading Using External Databases
When reinstalling IMail Server over an earlier version, in which one or more hosts use an external user database, new columns must be added to the database tables. This is due to additional user-level data which must be stored for use with the new Web Messaging and Web Calendaring features. The new columns must be added to the user table for each IMail Server host that uses an external database.
During the install, IMail Server will determine whether your system currently uses an external database. If the answer is yes, then a dialog is displayed giving you the three following options:
- Click Yes to have this install program automatically add the columns to all external database tables used to store IMail Server user settings.
- Click No to continue installation without updating the tables.
- Click Cancel if you want to manually add the necessary columns. The required columns can be found in the release notes. You will need to restart this install program when ready.
Note: If you click No and install anyway, be advised that IMail Server may not function correctly. If a custom ODBC driver was used with a previous version of IMail Server, the driver must be modified to use the new columns. Source code for the basic ODBCUser.dll driver (tailored for SQL Server and Access) can be downloaded from the IMail Support Center at:
http://ftp.ipswitch.com/Ipswitch/Product_Support/IMail/obdcuser.dll
Upgrading the LDAP Database
IMail 8.1 uses the OpenLDAP implementation. If you have an existing LDAP database with information that you want to retain after the upgrade, you must take the following precautions, otherwise your existing LDAP information will be deleted.
- Backup your LDAP database before upgrading to ensure that you do not lose any information in case an error occurs.
- Deselect Hide from Information Services before upgrading. This is done in IMail Administrator by expanding a host, and clicking on a User's folder. In the right panel, clear "Hide from Information Services".
Upgrading Web Messaging
The web messaging templates for IMail Server have changed format. The new format allows for easier customizations through the use of configuration files. This eliminates the need to edit HTML code in order to alter the appearance of templates. In order to use the new functionality in the 8.1 release, you must upgrade to the new format.
If the installation program detects that you have previously installed web templates for web messaging, a dialog is displayed which allows you to choose how to upgrade the templates. The dialog box, gives you the following options:
- Partial Installation. Overwrites all existing web messaging and web calendaring template files (files used to call a web page), but does not overwrite any existing configuration files (files in the format of config_filename.cgi).
- Complete Installation. Overwrites all existing web messaging, web calendaring, and configuration files with the templates for the new version.
- No Installation. Does not install any of the new web messaging calendaring or configuration files.
Your existing web messaging and web calendaring files are saved before being overwritten to the following locations:
If you have customized your existing files, note that the new template format is very different from previous versions. After upgrading, you must either edit the new templates or edit the new configuration files which make customizations much easier. For a list of web messaging files that have changes, see the IMail Server release notes (ntimsv.txt).
Upgrading Language Packs for Web Templates
If you have previously installed the IMail language packs for multi-lingual support in the web templates, you are presented with the following options to upgrade the language packs.
- Modify. Allows you to select which languages will be overwritten. You can also select new language packs to install, or clear language packs that you do not want t o install.
- Repair. Installs all languages that are currently installed. Note that if there are new language packs, this option does not install them.
- Remove. Uninstalls the Language packs, but not the web messaging templates.
Upgrading Anti-Spam Features
If you have previously installed IMail Server, you must decide whether to overwrite the antispam-table.txt file.During installation a dialog is displayed giving you the following options to overwrite the existing anti-spam-table.txt file.
- Merge. Adds new words to your existing file. Does not delete or alter any existing entries.
- Overwrite. Overwrites your existing file. Note that if you have added words or changed word values in this file, these will be overwritten, or deleted.
- Ignore. Does not modify the file.
Re-Installing IMail Server to a Different Location
When re-installing IMail Server to a different location, the WEBDOCS value in imonitor.ini is not updated. This causes the up.gif and down.gif files in IMonitor to be missing on the Service Status page. IMonitor produces the WEBDOCS value, but does not know when a reinstall has occurred, or when a web directory has been moved. If you change the install location of IMail Server, you MUST update the WEBDOCS field in the imonitor.ini file to point to the new location so the GIFs will be loaded properly.
![]() Ipswitch, Inc. http://www.ipswitch.com |
| ©Ipswitch 2004 | |||