Instructions for Multiple Step Upgrades

1)  Download Upgrade

To download the upgrade for AbleCommerce 7.0.7, you will need to have an active subscription or a license key for this version.  We will notify all subscription holders when a new version is available for download.  To obtain the file, login to the ablecommerce.com website and go to the Customer Account pages.  From there, click on the Downloads tab to see available software downloads.  License keys are requested through your order.

Do not install the upgrade unless your license's subscription is valid through the "release date" of the build you are installing.  

There are two ways to see if you have a valid subscription for this upgrade:

a. Login to your AbleCommerce Merchant Menu and go to the Configure > Security > Licensing page. The "License Details" section will indicate whether a subscription is included with your license, and the subscription's expiration date will be shown.

OR

b. Open the "commercebuilder.lic" file located in the \app_data\ folder with a txt program such as notepad.
 

e.g. <subscription>2011-04-01</subscription>

If your license purchase included a subscription, a line similar to the one above will be shown in your key file.  
Make sure the date is on, or after, APRIL 1st, 2011, which is the release date for version 7.0.7.  
 

• Incremental Upgrades and subscriptions can be purchased from our store.

2)  Backup your Existing Files

• Make a backup copy of the entire AbleCommerce install folder and 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\..(your custom store theme)..\*.css, *.skin

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

After the upgrade, you are responsible for merging any changes to the new "control" objects or .aspx files.

3)  PRE-upgrade tasks if you are upgrading from version 7.0.0 through 7.0.3 only

These are steps that you need to do BEFORE copying the new files into place.    

Prior to applying the upgrade files, locate and delete the entire "FCKEditor" folder from your install location.  
A new version of FCKEditor is included in the upgrade and this step ensures that no legacy files will remain.

Locate the file App_Code/TaxHelper.cs file and delete it prior to accessing the Upgrade.aspx script.  
If you do not remove this file, the upgrade script will display an error.  Older versions of AbleCommerce may not have this file so you can skip this step.

4)  Installation of New Files

1. Double-click the .exe file to extract the contents to a temporary location.

2. Stop the IIS web service* application to release a lock on the DLL files in the \bin\ folder.

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

4. Restart the IIS web service application.

  * If you are unable to stop the web service, try to perform the update during a slow time.  DO NOT access your store while uploading the files via FTP.  Double-check to make sure that ALL files are updated, especially the .DLL's in the \BIN\ folder.

5) Permission for updates

During upgrades, we may need to remove files that are no longer used or perform updates that require additional permission.  This means that AbleCommerce will need to have write and delete permissions on folders that might not ordinarily require it.  If possible, you should temporarily add 'write' and 'delete' permission to the entire store website for the ASPNET user (e.g. Network Service).

If adding additional permissions is not an option, you may receive errors during the upgrade.  These errors will need simply be warnings to indicate which files and/or folders could not be removed by the program.  You can still complete the upgrade, however, you will need to complete these steps after upgrading:

1. Remove unused files and/or folders

2. Update web.config and global.asax  

6)  Upgrade your Installation

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
   
   If you are prompted to enter a new license key, you may do so at this time.  After successfully updating the license key, return to the URL noted in the beginning of this step.

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

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

   • You can optionally have AbleCommerce upgrade the web.config and global.asax files.  Check the box to confirm you've made backups.

   • Initiate the upgrade.  When finished, you should receive confirmation.  
     You may also receive some information on changes made during the upgrade.

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

4. If you get an error AFTER upgrading, then make sure to double-check that -

   1. the application pool was recycled, or better, the web application service (IIS manager) has been restarted.

   2. that all files within the upgrade build have been applied to your installation.

   3. that any control customization, located in the \conlib\custom\ folder has been merged with the latest control changes.

   4. you followed the instructions from start to finish....

7)  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 if you are not using a custom Theme.

• • \ConLib\Custom\..

  • \App_Data\Scriptlets\Custom\..

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

If you have customized the control objects located in the \ConLib\ folder, they will be overwritten by the upgrade.  Control objects that are modified should always be placed in the \ConLib\Custom\ folder and referenced by the scriptlet accordingly.   

If you have created copies of the .aspx files, and need to merge any customizations, we recommend that you use a file compare and merge utility such as WinMerge.  WinMerge is Open Source file compare and merge utility which runs on all modern Windows versions.  Latest WinMerge version and other WinMerge information is available at http://winmerge.org

8)  Complete Post-Upgrade Tasks

For this next step, you will need to know the version of AbleCommerce you have just upgraded from.  The sections below summarize each upgrade release and any steps that need to be taken after your upgrade will be indicated for each version, as well as steps that are applicable to all version upgrades.

1. First, complete the steps as necessary in the Post Upgrade Tasks section immediately following.  This is REQUIRED for ALL upgrades.

2. Next, find the version you have just upgraded FROM in the list below and BEGIN there, working down.  Each section will summarize the changes made, provide a link to the full document, and indicate steps that you may need to take.  The number of upgrade steps you need to complete will depend on the version you are upgrading from.   
   
   Review each section carefully!  If you miss a step, your installation may not upgrade successfully.   

Post Upgrade Tasks - (Applicable to ALL Versions)

Step 1)  - Web.config and Global.asax updates

YOU CAN SKIP THIS STEP IF YOU ARE UPGRADING FROM VERSION 7.0.2 OR HIGHER.  

The upgrade can automatically handle required changes to your web.config and global.asax files when you are upgrading from AbleCommerce version 7.0.2 and higher.  

• IMPORTANT:  If you are upgrading from AbleCommerce 7.0.0 or 7.0.1 (aka. 7.1), you MUST Update web.config and global.asax files before continuing.

Step 2)  - Enable Taxes

If you are using AbleCommerce Tax Rules, you must visit the Configure > Taxes > Settings page in the merchant administration.  Please confirm that taxes are enabled and that the display settings are satisfactory.

Step 3) - Finish any post-upgrade tasks that are version specific

The gray sections below show each AbleCommerce 7.0.x upgrade released, with a link to the upgrade instructions.  Go to this page and find a section at the bottom named "RELEASE NOTES".  This will contain a summary of the changes made, and additional steps that you may need to take to complete the incremental upgrade step.  Not all steps apply so make sure to review each section carefully!  If you miss a step, your installation may not upgrade successfully.
 

1. 1. Determine the version of AbleCommerce you have just upgraded FROM

   2. Review each section below until you find the version you are upgrading from in bold black text in the title.  

   3. This is where you will begin, working downwards, until the post-upgrade steps for EACH VERSION have been completed.

e.g.  If you are upgrading from AbleCommerce 7.0.0, begin with "Upgrade from 7.0.0 to 7.0.1".  Complete EACH section following.

e.g.  If you are upgrading from version 7.0.1, then you can skip the first section, and begin at "Upgrade from 7.0.1 to 7.0.2", and so on...

1. 4. Not all sections will require changes, but you MUST COMPLETE EACH SECTION UNTIL YOU HAVE REACHED THE END*.

* If you are NOT upgrading to the latest version, then only complete individual sections below as needed.

Upgrade from 7.0.0 to 7.0.1

Release Notes:  See Upgrade from 7.0.0 to 7.0.1 for Release Notes which would include any special post-upgrade steps that are necessary to complete for this upgrade.   

Upgrade from 7.0.1 to 7.0.2

Release Date:  2/10/2009

Release Notes:  See Upgrade from 7.0.1 to 7.0.2 for Release Notes which would include any special post-upgrade steps that are necessary to complete for this upgrade.

Upgrade from 7.0.2 to 7.0.3

Release Date:  06/01/2009

Release Notes:  See Upgrade from 7.0.2 to 7.0.3 for Release Notes which would include any special post-upgrade steps that are necessary to complete for this upgrade. 

Upgrade from 7.0.3 to 7.0.4

Release Date:  12/12/2009

Release Notes:  See Upgrade from 7.0.3 to 7.0.4 for Release Notes which would include any special post-upgrade steps that are necessary to complete for this upgrade.

Upgrade from 7.0.4 to 7.0.5

Release Date:  06/01/2010

Release Notes:  See Upgrade from 7.0.4 to 7.0.5 for Release Notes which would include any special post-upgrade steps that are necessary to complete for this upgrade.
 

Upgrade from 7.0.5 to 7.0.6

Release Date:  11/10/10

Release Notes:  See Upgrade from 7.0.5 to 7.0.6  for Release Notes which would include any special post-upgrade steps that are necessary to complete for this upgrade.
 

Upgrade from 7.0.6 to 7.0.7

Release Date:  04/01/11

Release Notes:  See Upgrade from 7.0.6 to 7.0.7  for Release Notes which would include any special post-upgrade steps that are necessary to complete for this upgrade.