Difference between revisions of "X-Cart:Obtaining Upgrade Packs and Database Upgrade Scripts"

From X-Cart 4 Classic
Jump to: navigation, search
(Obtaining database upgrade scripts with 4.4.x)
m (Obtaining database upgrade scripts)
Line 89: Line 89:
 
#* [current_version]-[target_version]_sql_upgrade.tgz
 
#* [current_version]-[target_version]_sql_upgrade.tgz
 
#* [current_version]-[target_version]_sql_upgrade.zip
 
#* [current_version]-[target_version]_sql_upgrade.zip
# Download the archive with the database upgrade script to your local
+
# Download the archive with the database upgrade script to your local computer.
  
 
'''Branch 4.3.x to branch 4.4.x'''
 
'''Branch 4.3.x to branch 4.4.x'''
Line 98: Line 98:
 
#* [current_version]-[target_version]_sql_upgrade.tgz
 
#* [current_version]-[target_version]_sql_upgrade.tgz
 
#* [current_version]-[target_version]_sql_upgrade.zip
 
#* [current_version]-[target_version]_sql_upgrade.zip
# Download the archive with the database upgrade script to your local
+
# Download the archive with the database upgrade script to your local computer.
  
 
==Troubleshooting==
 
==Troubleshooting==

Revision as of 21:34, 2 September 2011

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.4.x

Depending on the branch and version your X-Cart store belongs to, you can upgrade the store to branch 4.4.x either directly or through a series of transitional steps (upgrades). You are likely to deal with the second option if you do not upgrade your store regularly, as every new branch of X-Cart is bundled with the 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.4.x you must complete 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.
  • If your store belongs to branch 4.3.x, successively upgrade X-Cart to version 4.3.2.


Obtaining upgrade packs

Obtaining in-branch upgrade packs

To obtain an upgrade pack for upgrading to the latest 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 the 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 match 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 match 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-4.4.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.4.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.4.0 -> DB upgrader 4.1.12->4.4.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.4.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.4.0 -> DB upgrader 4.2.3->4.4.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.3.x to branch 4.4.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.4.0 -> DB upgrader 4.3.2->4.4.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.

Troubleshooting

Checksum errors during upgrade

Firstly, if you use WinZip to extract files from the upgrade/distribution kit, you need to change the default configuration in the following way: Click Options, Configuration, select the Miscellaneous tab and remove the tick from 'TAR file smart CR/LF conversion'. After that unpack the files from the archive once again and re-upload the files to your server.

Secondly, when you use FTP for uploading text files on the server it may alter your files (if it's in 'ASCII'/'Text' mode). It replaces the line-break symbols that are different for Unix and Windows systems whereas all the other text is left the same. These changes are not visible, but X-Cart checks files checksum and the values appear different from the expected ones. In order to solve the problem you should set your FTP client in the 'Binary' mode and re-upload the upgrade package files on the server.