Upgrading X-Cart v.4.1.6 and Below to Use the 4.1.7 PayPal Integration

If you are using X-Cart 4.1.6 or earlier and wish to use X-Cart's PayPal integration as provided by X-Cart 4.1.7, you need to upgrade your X-Cart software.

The complexity of the process of upgrading will vary depending on the version of X-Cart you are using and on the number and complexity of customizations (modifications) implemented in the store.

Below are instructions for upgrading X-Cart to the version 4.1.7. Please choose a method that best suits the type of your X-Cart installation.

If the version of your X-Cart lies in the range 4.1.0-4.1.6, all you need to do is apply an upgrade pack that will convert the version you are currently using to 4.1.7. The necessary upgrade pack can be created using the Help Desk.

3.	In the list of your licenses, find the license of the shop that you wish to upgrade and click on the link 'Upgrade' opposite this license.

You are redirected to a section titled 'Get upgrade pack for [license_number] X-Cart ([license_URL])'. In this section, a drop-down box labeled 'Licenses' displays the license you have just selected. The 'Modules' list below the 'Licenses' drop-down box shows a list of add-on modules and skin sets available on the selected license.

3.	Make sure the license shown in the 'Licenses' drop-down box is the one that needs to be upgraded (if not, use the drop-down box to select a different license).

4.	In the 'Modules' list, select the add-ons and skin sets that need to be upgraded with the shop (Select the appropriate check boxes).

5.	From the 'Upgrade pack' drop-down box, select the upgrade pack that is intended for upgrading your store version to 4.1.7.

The system generates the upgrade pack and offers to save it to your computer in the form of a TGZ file. The extension .tgz means that it is an archive: a bundle of files packaged with tar and subsequently compressed with gzip.

Now you can apply the upgrade pack to your X-Cart installation. Before applying the upgrade pack, be sure to back up your store.

1.	Upload the upgrade pack TGZ file to the store server and unpack it to the directory in which X-Cart is installed.

2.	In the administration back-end of your store (Admin area), go to the section 'Patch/Upgrade center' (Administration menu->Patch/Upgrade).

3.	In the 'Upgrade' dialog box, use the 'Target version' selector to select the version 4.1.7.

4.	Click the Apply button at the bottom of the 'Upgrade' dialog box.

5.	Follow the instructions on the screen to complete the upgrade.

The upgrade script will automatically patch all the files it can patch; the files that have not been patched by the script automatically will need to be patched manually. To be able to apply patches manually, one needs experience in PHP, HTML and MySQL. If you need assistance with applying patches, please feel free to contact X-Cart technical support.

Non-customized or slightly customized stores, other X-Cart branches (4.0.x, 3.5.x):

If the version of your X-Cart belongs to the 3.5.x or the 4.0.x branch, upgrading to 4.1.7 will be a very complicated task. You will need to do the following:

1.	Apply one or more patches to bring your X-Cart version to the latest version of the branch (3.5.14 or 4.0.19 respectively).

The necessary patches can be downloaded from the Help Desk File area. Unfortunately, there are no upgrade packs for the 3.5.x and 4.0.x branches that can bring the older versions to the latest version of the branch directly. To upgrade an older version from the 3.5.x or 4.0.x branch to 3.5.14 or 4.0.19 respectively, you will probably need to apply several upgrade patches successively one after another. For example, you cannot just upgrade from 4.0.6 to 4.0.19: first, you will have to upgrade from 4.0.6 to 4.0.17 (using a jump patch), then from 4.0.17 to 4.0.18, and then from 4.0.18 to 4.0.19. You should understand that you will be able to apply the upgrade patches automatically through your store's Patch/Upgrade center only if your store is not customized. If your store has customizations, the patches will have to be applied manually, which requires experience in PHP, HTML and MySQL.

Upgrading of the database can be performed using a database upgrader provided in the Help Desk File area. It is a utility that upgrades your store's database from the latest version of the branch to 4.1.7. Please note that you will be able to use the database upgrader only if your store's database structure has not been changed by a customization. Make sure you back up your store's database before upgrading it.

b)	In the File area, find the database upgrader:

▪	3.5.14-4.1.7_sql_upgrade.tgz - for the 3.5.x branch

▪	4.0.19-4.1.7_sql_upgrade.tgz - for the 4.0.x branch

c)	Download the database upgrader TGZ file to your local computer.

d)	Upload the TGZ file to the store server and unpack it to the directory in which X-Cart is installed.

e)	Run the script upgrade_sql.php. To do so, point your web browser to the location <Your_X-Cart_store_URL>/upgrade_sql.php (like http://www.example.com/xcart/upgrade_sql.php) and press Enter.

3.	Install a new 4.1.7 X-Cart store. While running the 4.1.7 installer, specify the upgraded store database as the database to be used with the new installation. Also, select the checkbox 'Update config.php only' to keep the existing data.

4.	If your older store has any customizations, re-install them in the 4.1.7 store. Be prepared to resolve any conflicts that might arise as a result of transferring the code of your customizations to the newer X-Cart version.

If you cannot perform the upgrade yourself using the instructions above, feel free to order upgrade services from X-Cart technical support.

If your store has a lot of customizations, upgrading your X-Cart store will be very difficult, regardless of the version. It is best to order upgrade services from X-Cart technical support.