Sugar Open Source Installation Guide Version 4.5.1

Upgrading Sugar Suite

This section describes how to upgrade from version 4.2.1 and 4.5.0 to Sugar Suite 4.5.1. It is recommended that you run the upgrade process on a copy of your production system.

Important Upgrade Information

•	The Upgrade Wizard is the only supported method for upgrading to Sugar Suite 4.5.1. The Upgrade Wizard includes critical upgrade logic as well as the SQL commands needed to upgrade to Sugar Suite 4.5.1.

Attempting to manually upgrade by simply replacing files and running the upgrade SQL will not work and is not supported. You must use the Upgrade Wizard.

•	On MYSQL, the upgrade process will change the datatypes of three columns (Description, Description_HTML, and Raw_Source) in the Emails table. Therefore, depending on the size of your Email table and the abilities of your database server the upgrade may take longer than usual.

•

If you have implemented Campaign Management in your 4.2.1 release, ensure that queued emails from existing email marketing campaigns have been run to completion before upgrading to 4.5.1. Navigate to Admin > Manage Email Queue to ensure that the queue is empty. If any items are in the queue, click Send Queued Campaign Emails to process those items.

•	Backup your system first. Before beginning the upgrade process, it is imperative to perform a backup of your current Sugar directory and your database.

To upgrade to Sugar Suite 4.5.1

1.	Download the SugarSuite Upgrade .zip file.

2.	Log into your existing Sugar Suite application as the administrator and click on the admin option at the right-hand corner of the page.

3.	In the Systems panel of the Administration Home page, click Upgrade Wizard, and follow the steps outlined in the System Administration chapter of the Sugar Open Source Administration Guide.

4.	Upon successful upgrade, you will see a large body of text representing the SQL statements executed to upgrade the database and a list of the files that were overwritten. Click Return to Upgrade Wizard to go back to the Upgrade Wizard.

5.	You must rebuild the relationships and extensions. Go to the Admin screen and click the Rebuild Relationship and Rebuild Extensions links.

6.	If you unchecked any files to prevent the Upgrade Wizard from overwriting then manually merge the files by extracting the skipped file from the patch zip file. Merge the file that was installed in the Sugar application directory.