Installing Cumulative Patches

Last Updated: Jun 23, 2015 02:48PM EDT

Overview

Important Note
Cumulative patches are fixes for issues that happen between version releases.  For example, if the current release version is v5.1.00 and a serious issue is reported.  A fix may be posted in the "Check for Updates" area so effected stores do not need to wait for v5.1.01.  This type of patch is tested by our development team, but also subject to change prior to the final software release.

Do you need it?

Generally, it is a good practice to periodically check for software updates.  Each update will be posted along with a description or change log.  If the issues defined in the change log apply to you, then we recommend you install the patches.

Back Up!

Cumulative patches typically don't require a database update or effect commonly modified files, however it is always a best practice to backup your existing files and database prior to installing any patches.

Downloading the Updated Files

You can download updates by using the "Check for Updates" feature in your ProductCart Control Panel. Depending on the version of ProductCart that you are using (Standard vs. Configurator (formerly BTO) vs. Configurator Plus) and the add-on's installed on your store, the Update Management System will prompt you to download the correct file.

Unzipping the Downloaded Files

  • Unzip the files to a new directory on your desktop (e.g. "v5 Patch Files").
  • Do not copy the unzipped files onto an existing set of ProductCart files.
  • If you need to synchronize customized files, see Synchronizing customized files
  • If you want to have a copy of the entire ProductCart folder on your desktop, including the latest files, download the store to your desktop after you have finished the update process.

Performing the update

Synchronize overwritten files

Patches will not likely contain files that are commonly modified. However, if your store is customized you need to follow the steps below for best results.

One commonly modified file is "languages.asp", so if you made changes to this file you will need to merge them with the version contained in any patch or update. There may be other files that you customized and that are included in this update. Please see: Synchronizing customized files.

Step 1 - Back up your store

If you haven't already done so, back-up your store.

Step 2 - Turn off your store

Log into your Control Panel and select General Settings > Store Settings Enter a descriptive message in the field Message displayed when store is off. Select Turn store off, then click on the Update button. This ensures that customers do not browse the store while you are updating it.

Step 3 - FTP new files to your server

Upload the files to their respective folders, overwriting the existing files. For instance, you will update the contents of the "pc" subfolder on your Web server with the files contained in the "pc" subfolder in the zip file that you have downloaded from the ProductCart Update Management System.

Please note that the "pcadmin" folder has likely been renamed on your store. We recommend that you rename the same folder in the update files locally on your computer so that when you FTP the files there is no chance that a new "pcadmin" folder is created, which would mean that some of your store files are not being updated.

DO NOT delete any of the files that are currently on your Web server.

 

Confirm successful transfer

FTP transfers sometimes fail. Make sure that once the process has finished, your FTP client reported a success message. Most FTP programs have a way to show you whether some files were not uploaded successfully. If that happens, make sure to upload them again until all files have been uploaded successfully. For example, Filezilla separately reports "Failed Transfers" and "Successful Transfers". The "Failed Transfers" tab should be empty.

Step 4 - Update the Store Database

The database will not be updated automatically with this ProductCart update. When you log into the Control Panel after uploading the files to the Web server, you will also be redirected to a script that updates the version number.

Step 5 - TO DO List

A message will confirm that the version number have been updated. If there are any "To Do" items, they will be mentioned here.

Step 7 - Turn your store back on

When all To Do items have been completed, you can now turn your store back on and verify that the storefront is working properly. We recommend that you place at least one test order to go through the entire checkout process.

Menu

647e99095133bd6d1ae916f97dc7f92f@productcart.desk-mail.com
https://cdn.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete