Site Information

Forum Rules

Portal > CubeCartForums.org Documentation > CubeCart v4 > Upgrading from v3 > Preparation

Permanent Link Print This Page

CubeCart Version 4 Documentation - Preparing to upgrade CubeCart from v3

Google Translate:

Preparing to upgrade CubeCart from v3

Page Contents

The latest CubeCart v4 release can be downloaded from the CubeCart.com Downloads page.

You will find the latest upgrade instructions within a 'Read Me.txt' file amongst the top level of the unzipped files.

Before upgrading to Version 4 from Version 3, there are two aspects to CubeCart which are important to note:

The files: Unzipping the files will show all the CubeCart files needed to upload to the webserver, to the location you current have CubeCart v3 installed.
The database: This is where all your products and orders are stored. The database itself is not stored in the file system, therefore not accessible using your FTP software.

IMPORTANT: It is important to also mention that any mods applied to the Version 3 store will not work with Version 4.

Customised skins will also need to be upgraded to work with Version 4.

BACKUP, BACKUP, BACKUP

It is VERY important to backup your current store prior to upgrading CubeCart. If something should go wrong, your only course of action is to rely on the backup you made prior.

The files are accessible using your FTP software, download your entire store files to a safe place.

The database can be backed up using an application like 'phpMyAdmin', or something similar. Exporting the tables will ensure you have the ability to re-import them restoring the information that makes up your CubeCart database.

You may have the facility to do a domain backup using your hosting control panel, if so this should backup all files and databases associated with your domain account. This might be the easier option to follow, ask your hosting company for more information.

Once you have a backup, it may be advisable to put your store in 'offLine' mode, to ensure no orders are made during the upgrade process.

Version 3 Mods and Skins

It is important to note that all modifications to the v3 code will be overwritten with this upgrade. Therefore, if the mod functionality is not in the core v4 distribution, you will need to re-apply a CubeCart v4 version of the mod.

Custom skins will also need to be upgraded to make them work with CubeCart v4.

CubeCart v3 skins will not work with CubeCart v4 without modification.

Homepage

Take a backup of your homepage content, as it will be replaced with default text after the upgrade.

Removing Version 3 Files

Once you have a backup you are confident of, you need to remove some of the Version 3 files and directories from your hosting server. Delete the following files and folders, or move the to another folder on the server as a temporary measure.

Folders:

/admin/
/classes/
/docs/
/extra/
/js/
/language/
/modules/
/pear/
/skins/

Leaving 'images' and 'includes'.

Files:

/cart.php
/confirmed.php
/download.php
/offLine.php
/switch.php

Leaving 'index.php'.

Uploading the Version 4 files

The version 4 files can now be uploaded to the same directory in which the files you have just deleted/moved were located, using your FTP client software. Overwrite any remaining files if prompted.

Once the files have been uploaded you can now proceed with the upgrade process.

For minimal downtime, you can upload all the v4 files to a separate directory before removing the live store files. You can then just move the v4 files to the live store directory in a flash.

Essential Pre-requisites

There are a few pre-requisited you need to do before continuing with the upgrade process.

Find the following directory, and CHMOD it to '0777'.

/cache/

Find the following file, and CHMOD it to '0777'.

/includes/global.inc.php

Installing CubeCart v4

Using your browser, browse to your store, and add 'setup/' to the end of the address, ie 'http://www.mydomain.com/store/setup/', hit enter.

The installer will then start, and you will see the first page as shown here.

index » Options Page >

Comments, Feedback, Suggestions and Documentation Submissions please post in the Documentation Chat Forum.

CubeCartForums.org Documentation Area