Upgrading to MailSite Fusion 10
Document #:10528
Applies To:
Synopsis:
This document outlines the recommended steps when upgrading to MailSite 10. The document is designed to help system administrators plan MailSite server upgrades.
More Information:
The latest version of MailSite is available from the
MailSite Downloads Page.
When upgrading from a previous version of MailSite the installer will overwrite current MailSite Express and MailSite ExpressPro files. Therefore, any customizations/branding will need to be reapplied after upgrading.
For the Webmail related services, MailSite 10 requires IIS and the
Microsoft.NET Framework 4.0 to be installed on the server beforehand. The ActiveSync server will be automatically installed if you elect to install 'MailSite ExpressPro, Calendar & AirSync Services' when running the version 10 installer.
MailSite Express is no longer available by default in MailSite 9.4 and later. MailSite ExpressPro is now the default client shipped with the MailSite installer. For existing customers still needing Express, please open a support ticket with Technical Support.
MailSite V10 no longer supports SQL 2000. Please therefore upgrade to SQL 2005 or later before attempting a V10 installation or upgrade.
Registry Connector
If you are using the Registry Connector (typically customers with SE & LE keys) then you should:
- Back up your current accounts & settings. This can be done using the MSBACK tool*.
- Backup any Express, ExpressPro or Web Console customizations.
- If you are running MailSite 4.x, 5.x, 6.x**, 7.x, 8.x or 9.x then you can simply run the 10.x installer and it will upgrade your server. Any Express, ExpressPro or Web Console customizations will be overwritten and must be reapplied.
- For customers running webmail, it is recommended that the option to 'Overwrite virtual directory if it exists' is unselected during the installation. This will avoid the IIS settings/anonymous user from being reset.
- After the installation is complete, apply any hotfixes. Hotfix rollup packages are available from the Download section of the MailSite website. If there is no download package for hotfixes then check the following FTP site:
ftp://ftp.rockliffe.com/mailsite/latest/hotfixes. (paste link into Windows Explorer)
- Restart the MailSite services and ensure you can send and receive mail.
- Reapply any Express and ExpressPro customizations.
*The backup file created from MSBACK is only required should you need to roll back during the upgrade.
**Customers running MailSite 6.0.6 will need to upgrade to MailSite 6.0.11 first and then upgrade to 10.x. MailSite 6.0.11 is available from ftp://ftp.mailsite.com/mailsite/6.0.11/
SQL Connector
With the release of MailSite 9.5+,
support for Microsoft SQL Server 2000 has been removed. Customers running SQL server 2000 will need to upgrade to SQL Server 2005, 2008 or later.
The general upgrading steps are:
- Back up your SQL Database
- Back up any customizations to Express, ExpressPro and the Web console. These customizations will need to be reapplied to MailSite V10.
- Stop the MailSite services on the node you are upgrading.
- If you are running MailSite 4.x, 5.x, 6.x, 7.x, 8.x or 9.x then you can simply run the 10.x installer.
- For customers running webmail, it is recommended that the option to 'overwrite virtual directory if it exists' is unselected during the installation. This will avoid the IIS settings/anonymous user from being reset.
- During the installation de-select the option to automatically start the MailSite Services. Apply any hotfix rollup packages after the installer completes. Hotfix rollup packages are available from the Download section of the MailSite website. If there is no download package for hotfixes then check the following FTP site:
ftp://ftp.rockliffe.com/mailsite/latest/hotfixes. (paste link into Windows Explorer)
- After installation is complete open up the MailSite Console and navigate to the "SQL Connector" option under "Server". Run though the wizard and select to refresh the stored procedures. This will update your Database to the version 10 Tables and Stored Procedures.
- You can bypass step 7 and use MS SQL Server Management Studio to manually refresh the stored procedures and tables. These files are located in the MailSite directory tables.sql & procedures.sql. (Tables should be run first, followed by Procedures).
- Start the MailSite services and ensure you can send and receive mail.
- If you have more than one node you can continue to upgrade those servers. This can be done without interrupting the service (MailSite 9 engine can run against the MailSite 10 database).
- Reapply any Express or ExpressPro customizations.
Additional Information on Permissions
If the message store (commonly known as the BOX directory) is located within the MailSite directory and the size of the BOX directory is in the GB size range, then there may be a delay caused when the installer attempts to write the permissions to the MailSite installation directory. In MailSite 6.1.2x and later you will be given a prompt as to whether you want the installer to silently set the permissions or if you wish to do this manually. If your BOX directory is located somewhere other than the default then you will need to set the permissions manually (if any change is required). If you have already had MailSite running previously then most customers will not need to change any permissions on the BOX.
See the related knowledge base articles below for recommended permissions.
Related:
See these other knowledge base documents:
Last revised 2013-8-29