This document is designed to guide you through a multiple step upgrade. It is important that you take a moment to review the Release Notes for each upgrade step as it may contain information that could affect you. The primary goal of this upgrade guide is to summarize each release and document only the necessary steps to be taken before and after your upgrade.
These instructions apply to installations running AbleCommerce 7.0.0 - 7.0.5 (you must not have a build number lower than 9879)
Before you begin, DETERMINE YOUR CURRENT VERSION. View the Help > About page from the Merchant Menu.
We highly recommended that you read through this entire document before beginning.
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.
b. Open the "commercebuilder.lic" file located in the \app_data\ folder with a txt program such as notepad.
If your license purchase included a subscription, a line similar to the one above will be shown in your key file.
2) Backup your Existing Files
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.
Locate the file App_Code/TaxHelper.cs file and delete it prior to accessing the Upgrade.aspx script.
4) Installation of New Files
* 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:
6) Upgrade your Installation
WARNING: Make sure you have a backup of your database before upgrading !!!!
7) Replace any Customizations (if applicable)
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.
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.
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.
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...
* 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.1Release Date: 11/14/2008
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.
A division of Able Solutions Corporation, headquarters located in Vancouver, WA