Upgrade Instructions for AbleCommerce 7

These upgrade instructions are intended for existing installations of AbleCommerce 7 (beta).  It is a free upgrade of all AbleCommerce 7.0 installations.


2/10/09 UPDATE:  After upgrading to the final build 9879, you can apply a free patch to Service Release 3 which includes an important security update to be PA-DSS (Payment Application Data Security Standard) compliant.


Overview of Upgrade

Take a moment to read this entire document before beginning.  After you upgrade, you may need to complete the Post-Upgrade steps below.



1)  Download Upgrade

To download the upgrade for AbleCommerce 7.x, you will need to obtain the FTP login information included in your upgrade notification. We will notify all subscription holders when a new version is available for download. If you are not notified and believe you are entitled to this upgrade, login to your Customer Account and use the request form at the bottom of your order invoice.


2)  Backup your Existing Files

  • Make a backup copy of the entire AbleCommerce install folder as well as the database.

  • Any customizations that you may have made should be located in the following folders of your <installpath>:

    • \ConLib\Custom\..

    • \App_Data\Scriptlets\Custom\..

    • \App_Themes\..(current store theme)..\*.css, *.skin

The upgrade will NOT overwrite your customizations located within these specific folders.


3)  Installation of New Files

  1. Unzip the files to a temporary location.

  2. Select all the new files, copy, and overwrite your existing files in the <installpath> program folder.

  3. Restart your web service.


4)  Upgrade your Database

WARNING: Make sure you have a backup of your database before upgrading.

  1. Browse to the <installpath>/install/upgrade.aspx page to run the database script.

    e.g. http://localhost/ac7/install/upgrade.aspx

  2. Follow the on-screen instructions to complete the upgrade:

    • Type BACKUP in the space provided to confirm you understand.

    • Choose Microsoft SQL Server 2005, Microsoft SQL Server 2000, or Microsoft SQL Server 2005 Express.

    • Initiate the upgrade.  When finished, you should receive confirmation.

  3. If you get an error during upgrade - STOP!  Copy the error for AbleCommerce support, and revert to your backups.


5)  Remove the Install Directory

  • When finished with the installation, make sure you remove the \Install\ folder.

    • Keep the file \install\updatekey.aspx and updatekey.aspx.cs (to manually update a license key in the future)


6)  Replace any Customizations (if applicable)

  • AbleCommerce will not replace any files located in the \Custom\ folders, however, you may need to restore customizations made to files (.css\.skin) within the \App_Themes\ folder.

    • \ConLib\Custom\..

    • \App_Data\Scriptlets\Custom\..

    • \App_Themes\..(current store theme)..\*.css, *.skin


7)  Complete Post-Upgrade Tasks

  1. Complete the steps, as needed, in the Post Upgrade Tasks section immediately following.

  2. Review the Release Notes to see if there are any changes that could impact your store.


Post Upgrade Tasks

Listed below are specific upgrade tasks that should be completed depending on which version you are upgrading from.  For example, if you are upgrading from Beta 2, you will need to complete all post-upgrade tasks given below.  If you are upgrading from RC1 or RC2, you will need to complete those post-upgrade tasks as well as the latest RC3 post-upgrade tasks.  If you are upgrading from RC3, you only need to complete the post-upgrade tasks for RC3.



Post Upgrade Tasks when upgrading from RC3

There are a few manual changes that must be made to prevent any errors if you are upgrading from RC3 (build 9381).

To complete the upgrade, go to Post Upgrade Tasks from RC3 to Final



Post Upgrade Tasks when upgrading from RC1 or RC2

You can remove the file PayPal.Web.Controls.dll located in the \bin\ folder.  This file is no longer used by AbleCommerce.

To update the default "Height" field for image uploads and option swatches:

  1. Login to your Merchant Menu.  

  2. From the Dashboard click on Website > Logo and Images.  

  3. Click the SAVE CHANGES button.

This change will only affect new image uploads that are resized automatically.  It will have an immediate effect on the option swatch images.



Post Upgrade Tasks when upgrading from Beta 2

There are a few manual changes that must be made to prevent any errors if you are upgrading from Beta 2 (builds 7971/7973).

To complete the upgrade, go to Post Upgrade Tasks from B2 to RC1