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

From X-Cart 4 Classic
Jump to: navigation, search
m (Obtaining database upgrade scripts)
(Obtaining in-branch upgrade packs)
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
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 [[X-Cart:Upgrading|Upgrading]] section.
+
{{Note1| <b>NEED HELP?</b> Feel free to contact our support team via the Help Desk of your personal {{QA}} should you require any help in upgrading your X-Cart store to the latest version.}}
  
==Upgrading to Branch 4.4.x==
+
==Obtaining in-branch upgrade packs==
  
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.
+
To obtain an upgrade pack for upgrading to the latest minor version within a branch:<div id="47x"></div>
  
This presumes that prior to upgrading to branch 4.4.x you must complete the following upgrade tasks:
+
'''Branch 4.1.x-4.7.x'''
  
* If your store belongs to branch 3.5.x, successively upgrade the database to version 4.1.12.
+
# Log in to your {{QA}}..
* If your store belongs to branch 4.0.x, successively upgrade the database to version 4.1.12.
+
# Go to the '<u>File area</u>' section and click the '''Get upgrade pack''' tab.<br/> This will open the section '<u>Get upgrade pack</u>'.
* If your store belongs to branch 4.1.x, successively upgrade X-Cart to version 4.1.12.
+
# Use the controls in the '<u>Get upgrade pack</u>' section to configure the required upgrade pack:
* If your store belongs to branch 4.2.x, successively upgrade X-Cart to version 4.2.3.
+
#* License: Select an X-Cart license that is registered for the store you want to upgrade.
* If your store belongs to branch 4.3.x, successively upgrade X-Cart to version 4.3.2.
+
#* 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.
 +
# Click the '''Get upgrade pack''' button.<br/>The system will generate the upgrade pack and open a dialog box asking you what to do with the archive.
 +
# Select to save the archive to your local computer.
  
 +
'''Branch 4.0.x'''
  
===Obtaining upgrade packs===
+
# Log in to {{QA}}.
 
+
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.0 -> Upgrade kits for 4.0.x branch.
====Obtaining in-branch upgrade packs====
+
# Locate an archive with the required upgrade pack. X-Cart upgrade pack archives use the following name 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<br/>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.
 +
# Download the archive with the upgrade pack to your local computer.
  
To obtain an upgrade pack for upgrading to the latest minor version within a branch:
 
  
 
'''Branch 3.5.x'''
 
'''Branch 3.5.x'''
  
# Log in to your Help Desk account at https://secure.qtmsoft.com .
+
# Log in to your {{QA}}.
# 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.
+
# Go to the '<u>File area</u>' 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.
# Locate the archive with the required upgrade pack. The archive must have one of the following formats:
+
# Locate the archive with the required upgrade pack. X-Cart upgrade pack archives use the following name 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<br/>''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.''
 
# Download the archive with the upgrade pack to your local computer.
 
 
 
'''Branch 4.0.x'''
 
 
 
# Log in to your Help Desk account at https://secure.qtmsoft.com .
 
# 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.
 
# 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]-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<br/>''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.''
+
#* [current_version]-[target_version]-pro_upgrade.tgz or [current_version]-[target_version]-pro_upgrade.zip<br/>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.
 
# Download the archive with the upgrade pack to your local computer.
 
# Download the archive with the upgrade pack to your local computer.
  
'''Branch 4.1.x-4.4.x'''
+
==Obtaining database upgrade scripts==
 
 
# Log in to your Help Desk account at https://secure.qtmsoft.com .
 
# Go to the File Area section and click the Get upgrade pack tab.<br/> ''This will open the section Get upgrade pack.''
 
# 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.
 
# Click the '''Get upgrade pack''' button.<br/>''The system will generate the upgrade pack and open a dialog box asking you what to do with the archive.''
 
# Select to save the archive to your local computer.
 
 
 
====Obtaining database upgrade scripts====
 
  
To obtain a database upgrade pack:
+
To obtain a database upgrade script:
  
 
'''Branch 3.5.x to branch 4.1.x'''
 
'''Branch 3.5.x to branch 4.1.x'''
  
# Log in to your Help Desk account at https://secure.qtmsoft.com .
+
# Log in to your {{QA}}.
# 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.
+
# Go to the '<u>File area</u>' 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.
# Locate an archive with the required database upgrade script. The archive must have one of the following formats:
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 
#* [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
Line 66: Line 52:
 
'''Branch 4.0.x to branch 4.1.x'''
 
'''Branch 4.0.x to branch 4.1.x'''
  
# Log in to your Help Desk account at https://secure.qtmsoft.com .
+
# Log in to your {{QA}}.
# 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.
+
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.0 -> Upgrade kits 4.0.x branch.
# Locate an archive with the required database upgrade script. The archive must have one of the following formats:
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 
#* [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
Line 75: Line 61:
 
'''Branch 4.1.x to branch 4.4.x'''
 
'''Branch 4.1.x to branch 4.4.x'''
  
# Log in to your Help Desk account at https://secure.qtmsoft.com .
+
# Log in to your {{QA}}.
# 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.
+
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart 4.4.0 -> DB upgrader 4.1.12->4.4.0.
# Locate an archive with the required database upgrade script. The archive must have one of the following formats:
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 
#* [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
Line 84: Line 70:
 
'''Branch 4.2.x to branch 4.4.x'''
 
'''Branch 4.2.x to branch 4.4.x'''
  
# Log in to your Help Desk account at https://secure.qtmsoft.com .
+
# Log in to your {{QA}}.
# 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.
+
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart 4.4.0 -> DB upgrader 4.2.3->4.4.0.
# Locate an archive with the required database upgrade script. The archive must have one of the following formats:
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 
#* [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
Line 93: Line 79:
 
'''Branch 4.3.x to branch 4.4.x'''
 
'''Branch 4.3.x to branch 4.4.x'''
  
# Log in to your Help Desk account at https://secure.qtmsoft.com .
+
# Log in to your {{QA}}.
# 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.
+
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart 4.4.0 -> DB upgrader 4.3.2->4.4.0.
# Locate an archive with the required database upgrade script. The archive must have one of the following formats:
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 +
#* [current_version]-[target_version]_sql_upgrade.tgz
 +
#* [current_version]-[target_version]_sql_upgrade.zip
 +
# Download the archive with the database upgrade script to your local computer.
 +
 
 +
'''Branch 4.1.x to branch 4.5.x'''
 +
 
 +
# Log in to your {{QA}}.
 +
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart 4.5.0 -> DB upgrader 4.1.12->4.5.0.
 +
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 +
#* [current_version]-[target_version]_sql_upgrade.tgz
 +
#* [current_version]-[target_version]_sql_upgrade.zip
 +
# Download the archive with the database upgrade script to your local computer.
 +
 
 +
'''Branch 4.2.x to branch 4.5.x'''
 +
<div id="Branch_4.2.x_to_branch_4.5.x"></div>
 +
 
 +
 
 +
# Log in to your {{QA}}.
 +
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart 4.5.0 -> DB upgrader 4.2.3->4.5.0.
 +
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 
#* [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 computer.
 
# Download the archive with the database upgrade script to your local computer.
  
==Troubleshooting==
+
'''Branch 4.3.x to branch 4.5.x'''
  
===Checksum errors during upgrade===
+
# Log in to your {{QA}}.
 +
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart 4.5.0 -> DB upgrader 4.3.2->4.5.0.
 +
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 +
#* [current_version]-[target_version]_sql_upgrade.tgz
 +
#* [current_version]-[target_version]_sql_upgrade.zip
 +
# Download the archive with the database upgrade script to your local computer.
  
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 <u>Options</u>, <u>Configuration</u>, select the <u>Miscellaneous</u> tab and remove the tick from <b>'TAR file smart CR/LF conversion'</b>. After that unpack the files from the archive once again and re-upload the files to your server.
+
'''Branch 4.4.x to branch 4.5.x'''
  
Secondly, when you use FTP for uploading text files on the server it may alter your files (if it's in <b>'ASCII'/'Text'</b> 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 <b>'Binary'</b> mode and re-upload the upgrade package files on the server.
+
# Log in to your {{QA}}.
 +
# Go to the '<u>File area</u>' section and open the folder X-Cart -> X-Cart 4.5.0 -> DB upgrader 4.4.5->4.5.0.
 +
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
 +
#* [current_version]-[target_version]_sql_upgrade.tgz
 +
#* [current_version]-[target_version]_sql_upgrade.zip
 +
# Download the archive with the database upgrade script to your local computer.
  
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Latest revision as of 10:24, 18 October 2018

NEED HELP? Feel free to contact our support team via the Help Desk of your personal X-Cart Account should you require any help in upgrading your X-Cart store to the latest version.

Obtaining in-branch upgrade packs

To obtain an upgrade pack for upgrading to the latest minor version within a branch:

Branch 4.1.x-4.7.x

  1. Log in to your X-Cart Account..
  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.0.x

  1. Log in to X-Cart Account.
  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 for 4.0.x branch.
  3. Locate an archive with the required upgrade pack. X-Cart upgrade pack archives use the following name 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 3.5.x

  1. Log in to your X-Cart Account.
  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 the archive with the required upgrade pack. X-Cart upgrade pack archives use the following name 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.

Obtaining database upgrade scripts

To obtain a database upgrade script:

Branch 3.5.x to branch 4.1.x

  1. Log in to your X-Cart Account.
  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. X-Cart database upgrade script archives use the following name 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 X-Cart Account.
  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. X-Cart database upgrade script archives use the following name 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 X-Cart Account.
  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. X-Cart database upgrade script archives use the following name 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 X-Cart Account.
  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. X-Cart database upgrade script archives use the following name 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 X-Cart Account.
  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. X-Cart database upgrade script archives use the following name 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.5.x

  1. Log in to your X-Cart Account.
  2. Go to the 'File area' section and open the folder X-Cart -> X-Cart 4.5.0 -> DB upgrader 4.1.12->4.5.0.
  3. Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name 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.5.x


  1. Log in to your X-Cart Account.
  2. Go to the 'File area' section and open the folder X-Cart -> X-Cart 4.5.0 -> DB upgrader 4.2.3->4.5.0.
  3. Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name 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.5.x

  1. Log in to your X-Cart Account.
  2. Go to the 'File area' section and open the folder X-Cart -> X-Cart 4.5.0 -> DB upgrader 4.3.2->4.5.0.
  3. Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name 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.4.x to branch 4.5.x

  1. Log in to your X-Cart Account.
  2. Go to the 'File area' section and open the folder X-Cart -> X-Cart 4.5.0 -> DB upgrader 4.4.5->4.5.0.
  3. Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name 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.