X-Cart:Obtaining Upgrade Packs and Database Upgrade Scripts

This chapter provides instructions on how to fulfill tasks involved into the upgrade process directly. The tasks include obtaining and applying upgrade packs and database upgrades. For information concerning pre-upgrade and post-upgrade procedures consult the main Upgrading section.

Upgrading to Branch 4.3.x

Depending on what X-Cart branch and version your store belongs to, you can upgrade the store to branch 4.3.x either directly or through a series of transitional steps (upgrades). You will probably have to deal with the second option if you do not upgrade your store regularly because every new X-Cart branch is bundled with database upgrade packs for latest minor versions for two X-Cart branches antecedent to the current branch only.

This presumes that prior to upgrading to branch 4.3.x you must fulfill the following upgrade tasks:

• If your store belongs to branch 3.5.x, successively upgrade the database to version 4.1.12.
• If your store belongs to branch 4.0.x, successively upgrade the database to version 4.1.12.
• If your store belongs to branch 4.1.x, successively upgrade X-Cart to version 4.1.12.
• If your store belongs to branch 4.2.x, successively upgrade X-Cart to version 4.2.3.

Obtaining upgrade packs

Obtaining in-branch upgrade packs

To obtain an upgrade pack to a later minor version within a branch:

Branch 3.5.x

1. Log in to your Help Desk account at https://secure.qtmsoft.com .
2. Go to the File Area section and open the folder X-Cart -> X-Cart supporting files for prev versions -> X-Cart 3.5 -> Upgrade kits 3.5.x branch.
3. Locate an archive with the required upgrade pack. The archive must have one of the following formats:
   • [current_version]-[target_version]-gold_upgrade.tgz or [current_version]-[target_version]-gold_upgrade.zip
   • [current_version]-[target_version]-pro_upgrade.tgz or [current_version]-[target_version]-pro_upgrade.zip
     where the [current_version] part is the version of your current X-Cart installation, and the [target_version] part is the X-Cart version to which you are upgrading the store. Take note that the gold or pro part must coincide with the X-Cart edition you use: X-Cart Gold or X-Cart Pro, respectively.
4. Download the archive with the upgrade pack to your local computer.

Branch 4.0.x

1. Log in to your Help Desk account at https://secure.qtmsoft.com .
2. Go to the File Area section and open the folder X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.0 -> Upgrade kits 4.0.x branch.
3. Locate an archive with the required upgrade pack. The archive must have one of the following formats:
   • [current_version]-[target_version]-gold_upgrade.tgz or [current_version]-[target_version]-gold_upgrade.zip
   • [current_version]-[target_version]-pro_upgrade.tgz or [current_version]-[target_version]-pro_upgrade.zip
     where the [current_version] part is the version of your current X-Cart installation, and the [target_version] part is the X-Cart version to which you want to upgrade the store. Take note that the gold or pro part must coincide with the X-Cart edition you use: X-Cart Gold or X-Cart Pro, respectively.
4. Download the archive with the upgrade pack to your local computer.

Branch 4.1.x

1. Log in to your Help Desk account at https://secure.qtmsoft.com .
2. Go to the File Area section and click the Get upgrade pack tab.
   This will open the section Get upgrade pack.
3. Use the controls in the Get upgrade pack section to configure the required upgrade pack:
   • License: Select an X-Cart license that is registered for the store you want to upgrade.
   • Modules (optional): Select commercial add-on modules and skin templates that you want to upgrade together with the store.
   • Free modules: Select free add-on modules and skin templates that you want to upgrade together with the store.
   • Upgrade pack: Select a pack to upgrade your store from the current version to the target version.
   • Archive type: Select the type of an archive for the configured pack.
4. Click the Get upgrade pack button.
   The system will generate the upgrade pack and open a dialog box asking you what to do with the archive.
5. Select to save the archive to your local computer.

Branch 4.2.x

1. Log in to your Help Desk account at https://secure.qtmsoft.com .
2. Go to the File Area section and click the Get upgrade pack tab.
   This will open the section Get upgrade pack.
3. Use the controls in the Get upgrade pack section to configure the required upgrade pack:
   • License: Select an X-Cart license that is registered for the store you want to upgrade.
   • Modules (optional): Select commercial add-on modules and skin templates that you want to upgrade together with the store.
   • Free modules: Select free add-on modules and skin templates that you want to upgrade together with the store.
   • Upgrade pack: Select a pack to upgrade your store from the current version to the target version.
   • Archive type: Select the type of an archive for the configured pack.
4. Click the Get upgrade pack button.
   The system will generate the upgrade pack and open a dialog box asking you what to do with the archive.
5. Select to save the archive to your local computer.

Obtaining database upgrade scripts

To obtain a database upgrade pack:

Branch 3.5.x to branch 4.1.x

1. Log in to your Help Desk account at https://secure.qtmsoft.com .
2. Go to the File Area section and open the folder X-Cart -> X-Cart supporting files for prev versions -> X-Cart 3.5 -> Upgrade kits for 3.5.x branch.
3. Locate an archive with the required database upgrade script. The archive must have one of the following formats:
   • [current_version]-[target_version]_sql_upgrade.tgz
   • [current_version]-[target_version]_sql_upgrade.zip
4. Download the archive with the database upgrade script to your local computer.

Branch 4.0.x to branch 4.1.x

1. Log in to your Help Desk account at https://secure.qtmsoft.com .
2. Go to the File Area section and open the folder X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.0 -> Upgrade kits 4.0.x branch.
3. Locate an archive with the required database upgrade script. The archive must have one of the following formats:
   • [current_version]-[target_version]_sql_upgrade.tgz
   • [current_version]-[target_version]_sql_upgrade.zip
4. Download the archive with the database upgrade script to your local computer.

Branch 4.1.x to branch 4.3.x

1. Log in to your Help Desk account at https://secure.qtmsoft.com .
2. Go to the File Area section and open the folder X-Cart -> X-Cart 4.3.0 -> DB upgrader 4.1.12->4.3.0.
3. Locate an archive with the required database upgrade script. The archive must have one of the following formats:
   • [current_version]-[target_version]_sql_upgrade.tgz
   • [current_version]-[target_version]_sql_upgrade.zip
4. Download the archive with the database upgrade script to your local computer.

Branch 4.2.x to branch 4.3.x

1. Log in to your Help Desk account at https://secure.qtmsoft.com .
2. Go to the File Area section and open the folder X-Cart -> X-Cart 4.3.0 -> DB upgrader 4.2.3->4.3.0.
3. Locate an archive with the required database upgrade script. The archive must have one of the following formats:
   • [current_version]-[target_version]_sql_upgrade.tgz
   • [current_version]-[target_version]_sql_upgrade.zip
4. Download the archive with the database upgrade script to your local