Casbay Knowledge Base

Search our articles or browse by category below

Upgrade SugarCRM

Last modified: April 19, 2021
You are here:
Estimated reading time: 1 min

Upgrade SugarCRM to SuiteCRM

What is SugarCRM?

SuiteCRM is a popular open source CRM application derived from SugarCRM and comes with some additional features and bug fixes. This guide explains the process of upgrading from SugarCRM to SuiteCRM.

Assumptions And Upgrade Prerequisites

This guide assumes that:

  • You are running SugarCRM 6.x. If you are using an older version, you must first upgrade to SugarCRM 6.x. Kindly refer to the SugarCRM documentation of your version for detailed upgrade instructions.

  • You have created a backup of the application database and files before the upgrade process.
  • Step 1: Configure PHP Settings

    1. Log in to the server console using SSH.

    2. Edit the /opt/casbay/php/etc/php.ini file and modify some key PHP variables with this:

    3. max_execution_time=6000
      post_max_size=80M
      upload_max_filesize=80M
      max_input_time=6000
      memory_limit=256M
    **IMPORTANT: Remember the original values so you can restore them after the upgrade process is complete.

    1. Restart the Apache server:

    2. sudo /opt/casbay/ctlscript.sh restart apache

    Step 2: Download & Install the Upgrade Package

    1. Download the “SugarCE Migration 6.x to Suite 7.6.6” migration package from the SuiteCRM upgrade page to your local system.
    Upgrade SugarCRM
    1. Log in to the SugarCRM administration console and browse to the “Admin -> Upgrade Wizard” page.

    2. On the “Welcome” page, click “Next” to perform a system check.

    3. Confirm that the system check is fine and click “Next”.

    4. On the “Upload Upgrade Package” page, select the “SugarCE Migration 6.x to Suite 7.6.6” file downloaded earlier and click the “Upload Package” button.
      **The upload may take a few minutes to complete.

    5. Once the package has been uploaded, click “Next” to proceed.

    6. Once you receive confirmation that all pre-flight tests have passed, click “Next” to begin the upgrade process.

    7. Wait until all files are copied and you see a success notification. Click “Next” to confirm layouts and finalize the upgrade.
    8. **IMPORTANT:As the upgrade is finalized, you may see a “Gateway Timeout” error. This is a transient error that can safely be ignored. Wait a few minutes and reload the application welcome page again.

    9. Your upgrade should now be completed and you should see the SuiteCRM dashboard.

    Step 3: Restore Previous PHP Settings

    1. Edit the /opt/casbay/php/etc/php.ini file and restore the values of the PHP variables modified earlier.

    2. Restart the Apache server:

      sudo /opt/casbay/ctlscript.sh restart apache
    Was this article helpful?
    Dislike 0
    Views: 12