Latest Version: Service Release 2, Build 1389
Release Date: January 25th, 2007
Applies To: Existing installations of AbleCommerce 5.5 CFMX (build 1357 - 1379)
Downloads:
AbleCommerce 5.5 CFMX Windows (build 1389)
AbleCommerce 5.5 CFMX Linux (build 1389)
IMPORTANT: If you have previously upgraded to SR1 (build 1382), you should follow the SR2 upgrade instructions instead.
UPGRADE INFORMATION:
The SR1 release corrects a number of issues between builds 1357 and 1382. It is highly recommended that you upgrade if you are still running a build earlier than 1382. The SR2 release corrects a few issues between builds 1382 and 1389. If you are experiencing any of the issues listed, you should upgrade to SR2. Before upgrading, make sure you review the upgrade options below.
If you are running a version earlier than AbleCommerce 5.5 CFMX (build 1357), then you should download AbleCommerce 5.5 CFMX and complete all steps of the upgrade instructions below. Then, continue with the final upgrade to Service Release 1 or 2.
If you are running AbleCommerce 5.5 CFMX (build 1357 through build 1379), you should acquire the latest release, using the download links above, and choose the best upgrade path for your installation -
To upgrade a customized installation or live store: review and complete the alternate upgrade instructions instead.
To upgrade a development store, or live store with minimal traffic: review and complete the upgrade instructions on the page below.
If you are running AbleCommerce 5.5 CFMX SR1, (builds 1380 - 1385), you may upgrade to AbleCommerce 5.5 CFMX SR2 using the instructions here.
If you do not know which version or build you are running, then please see this FAQ on our website.
(Use the Detailed Upgrade Instructions for a customized or live store upgrade)
DEFINITIONS
[INSTALL_DIR] - This is where you installed AbleCommerce. This directory contains the AbleCommerce program files. The default location is C:\Program Files\Able Solutions\acb\...
[CFMX_DIR] - This is the webroot (wwwroot folder) where your ColdFusion program is installed. The default location may be similar to C:\CFusionMX7\wwwroot\
[ACTEMP] - This is a temporary
location on your server where the new AbleCommerce program has been extracted
to for the purpose of the upgrade.
Step 1) - Backup the Existing Installation
Before upgrading, the following items must be backed up:
Step 2) - Download latest build
Download the applicable file to the server. (see above)
Extract the
contents of the archive into a temporary folder which will be referred
to as [ACTEMP]
Step 3) - Update the existing AbleCommerce Program Files
Copy the contents of the extracted files from [ACTEMP] to your [INSTALL_DIR]. Only copy the contents, not the folder itself.
WARNING: DO NOT
REPLACE the following (2) files at any time during the upgrade process.
[INSTALL_DIR]\acb.cfm
[INSTALL_DIR]\WEB-INF\ablecommerce.key
Step 4) - Update ColdFusion with new AbleCommerce files
WARNING: DO NOT
REPLACE the following file at any time during the upgrade process.
[CFMX_DIR]\WEB-INF\web.xml
Stop ColdFusionMX services.
Remove all .jar files
whose name start with "ablecommerce5" from -
[CFMX_DIR]/WEB-INF/lib/
From the AbleCommerce install directory, copy
all of the library files -
from [INSTALL_DIR]/WEB-INF/lib/*.*
to [CFMX_DIR]/WEB-INF/lib/
From the AbleCommerce install directory, copy
the contents of 'classes' folder -
from [INSTALL_DIR]/WEB-INF/classes/*.*
to [CFMX_DIR]/WEB-INF/classes/
Restart ColdFusionMX services to register the new library files. Be sure to give CFMX time to start completely before going to the next step.
NOTE: When using CFMX in the 'multi-server' JRun configuration, you will need to add the WEB-INF/classes to the classpath in JRun by using the JMC or editing {Jrun4_home}/bin/jvm.config
Step 5) - Upgrade Database
After updating the program files in the prior steps, login to the Master Administration Menu and click on the Manage Store Groups menu item.
NOTE: The Service Release 1 upgrade may force you to change your password when logging in. If this occurs, update your password following the new password rules.
Find and click either the “Upgrade All” link, or the "Upgrade" link under Actions to upgrade one database at a time. You will be presented with a page like the one shown below.
Read the information on this page, check the box if you have made your backups, and click the Next button.
The selected AbleCommerce database(s) will be upgraded as necessary. You will be able to watch the upgrade progress as it is reported on the screen during this process.
You should save a copy of the database upgrade report when it is completed. This can be used by AbleCommerce technicians to troubleshoot any potential issues after upgrading.
Step 6) - Update the AbleCommerce store templates (OPTIONAL, BUT RECOMMENDED)
The store templates are often changed to correct bugs and include necessary updates. We strongly suggest updating the store templates during the upgrade process.
If you have been using the built-in Themes and Wizards, and have not customized your .cfm files directly, the store upgrade should be relatively easy. The following step will over-write all your store templates, includes, css files, etc.
Warning: MAKE
A BACKUP BEFORE PROCEEDING.
You need to backup all files in the store folder (*.cfm, *.wzc, *.wzct)
and all sub-folders (/includes, /css, /images, etc.)
DO NOT REPLACE the following (2) files at any time during the upgrade process.
[INSTALL_DIR]\stores\1\acb.cfm
[INSTALL_DIR]\stores\1\includes\storeid.cfm
(Actual location of store templates may vary)
By default, the templates for the first store are located here -
[INSTALL_DIR]/stores/1/*all files and sub-folders*
If you are not sure where your store files are located, click on the STORES icon from the Master Admin menu. Then, click on the linked store name and you will view the Edit Store configuration page. The physical path setting indicates the location of the store files. Each store of the installation must be upgraded individually. Repeat as needed.