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

From X-Cart 4 Classic
Jump to: navigation, search
(Obtaining in-branch upgrade packs)
 
(22 intermediate revisions by 6 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_X-Cart|Upgrading X-Cart]] 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.3.x==
+
==Obtaining in-branch upgrade packs==
  
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.
+
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.3.x you must fulfill 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.
 +
#* 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 to a later 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 an 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]-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 coincide with 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.0.x'''
+
==Obtaining database upgrade scripts==
 +
 
 +
To obtain a database upgrade script:
 +
 
 +
'''Branch 3.5.x to branch 4.1.x'''
 +
 
 +
# Log in to your {{QA}}.
 +
# 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. 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.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 upgrade pack. 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]-gold_upgrade.tgz or [current_version]-[target_version]-gold_upgrade.zip
+
#* [current_version]-[target_version]_sql_upgrade.tgz
#* [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 coincide with the X-Cart edition you use: X-Cart Gold or X-Cart Pro, respectively.''
+
#* [current_version]-[target_version]_sql_upgrade.zip
# Download the archive with the upgrade pack to your local computer.
+
# Download the archive with the database upgrade script to your local computer.
  
'''Branch 4.1.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 click the Get upgrade pack tab.<br/> ''This will open the section Get upgrade pack.''
+
# 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.
# Use the controls in the Get upgrade pack section to configure the required upgrade pack:
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
#* License: Select an X-Cart license that is registered for the store you want to upgrade.
+
#* [current_version]-[target_version]_sql_upgrade.tgz
#* Modules (optional): Select commercial add-on modules and skin templates that you want to upgrade together with the store.
+
#* [current_version]-[target_version]_sql_upgrade.zip
#* Free modules: Select free add-on modules and skin templates that you want to upgrade together with the store.
+
# Download the archive with the database upgrade script to your local computer.
#* 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.2.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 click the Get upgrade pack tab.<br/>''This will open the section Get upgrade pack.''
+
# 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.
# Use the controls in the Get upgrade pack section to configure the required upgrade pack:
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
#*License: Select an X-Cart license that is registered for the store you want to upgrade.
+
#* [current_version]-[target_version]_sql_upgrade.tgz
#* Modules (optional): Select commercial add-on modules and skin templates that you want to upgrade together with the store.
+
#* [current_version]-[target_version]_sql_upgrade.zip
#* Free modules: Select free add-on modules and skin templates that you want to upgrade together with the store.
+
# Download the archive with the database upgrade script to your local computer.
#* 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====
+
'''Branch 4.3.x to branch 4.4.x'''
  
To obtain a database upgrade pack:
+
# Log in to your {{QA}}.
 +
# 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. 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 3.5.x to branch 4.1.x'''
+
'''Branch 4.1.x to branch 4.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 for 3.5.x branch.
+
# 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. 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
 
# Download the archive with the database upgrade script to your local computer.
 
# Download the archive with the database upgrade script to your local computer.
  
'''Branch 4.0.x to branch 4.1.x'''
+
'''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 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 4.5.0 -> DB upgrader 4.2.3->4.5.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
 
# Download the archive with the database upgrade script to your local computer.
 
# Download the archive with the database upgrade script to your local computer.
  
'''Branch 4.1.x to branch 4.3.x'''
+
'''Branch 4.3.x to branch 4.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 4.3.0 -> DB upgrader 4.1.12->4.3.0.
+
# 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. 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
 
# Download the archive with the database upgrade script to your local computer.
 
# Download the archive with the database upgrade script to your local computer.
  
'''Branch 4.2.x to branch 4.3.x'''
+
'''Branch 4.4.x to branch 4.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 4.3.0 -> DB upgrader 4.2.3->4.3.0.
+
# 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. 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
# Download the archive with the database upgrade script to your local
+
# Download the archive with the database upgrade script to your local computer.
 +
 
 +
[[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.