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

From X-Cart 4 Classic
Jump to: navigation, search
m
(Obtaining in-branch upgrade packs)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This chapter focuses on obtaining and applying upgrade packs and database upgrades. For information on the pre-upgrade and post-upgrade procedures, please consult the section [[X-Cart:Upgrading#Upgrading_X-Cart_step_by_step|Upgrading X-Cart step by step]].
+
{{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 and database upgrade scripts===
+
# 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 '<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.
 
# 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. X-Cart upgrade pack archives use the following name formats:
 
# Locate the archive with the required upgrade pack. X-Cart upgrade pack archives use the following name formats:
Line 29: Line 37:
 
# 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==
 
 
# Log in to your Help Desk account at https://secure.qtmsoft.com .
 
# 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.
 
# 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.
 
 
 
'''Branch 4.1.x-4.4.x'''
 
 
 
# Log in to your Help Desk account at https://secure.qtmsoft.com .
 
# 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>'.
 
# Use the controls in the '<u>Get upgrade pack</u>' 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 script:
 
To obtain a database upgrade script:
Line 57: Line 43:
 
'''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 '<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.
 
# 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:
 
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
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 '<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.
 
# 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. X-Cart database upgrade script archives use the following name formats:
 
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
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 '<u>File area</u>' 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. X-Cart database upgrade script archives use the following name formats:
 
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
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 '<u>File area</u>' 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. X-Cart database upgrade script archives use the following name formats:
 
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
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 '<u>File area</u>' 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. X-Cart database upgrade script archives use the following name formats:
 
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
Line 100: Line 86:
 
# Download the archive with the database upgrade script to your local computer.
 
# Download the archive with the database upgrade script to your local computer.
  
===Applying upgrade packs and database upgrade scripts===
+
'''Branch 4.1.x to branch 4.5.x'''
  
====Applying upgrade packs====
+
# Log in to your {{QA}}.
To apply an upgrade pack to your X-Cart installation:
+
# 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.
# Place the files of your upgrade pack in the X-Cart root directory on your server or hosting account.
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
#* ''If you use a Windows-based server, or a UNIX-based server without terminal access:''<br />Decompress the upgrade pack archive to a directory on your system using your favorite compression program (WinZIP or any other archiver with support for TAR files).<br />Use an FTP client to upload all the files of the decompressed archive (retaining the directory structure) to the X-Cart root directory on your server or your hosting account.
+
#* [current_version]-[target_version]_sql_upgrade.tgz
#* ''If you use a UNIX-based server with terminal access:''<br />Use an FTP client to upload the upgrade pack archive to the X-Cart root directory on your server or your hosting account.<br />Decompress the archive using the following command:<br /><pre>tar -xzvf <archive_filename></pre>
+
#* [current_version]-[target_version]_sql_upgrade.zip
# Make sure that the files that will be patched during the upgrade have world writable permissions. Names of the files to be patched are listed in the file <xcart_dir>/upgrade/[source-version]-[target-version]/file.lst.<br />If you use a UNIX-based server, to set world writable permissions to the required files you can run the following shell command:<br /><pre>for i in `sed -e 's/,.*$//g' < upgrade/[source-version]-[target-version]/file.lst`; do chmod 666 $i ; done</pre>replacing the [source-version] and [target-version] parts with the source and target versions of the X-Cart installation that you upgrade.{{Note1|Important! You must run the command from the X-Cart root directory.}}
+
# Download the archive with the database upgrade script to your local computer.
# Log in to the X-Cart Admin area.
 
# Go to the '<u>Patch/Upgrade Center</u>' page (Tools menu -> Patch/Upgrade. Before X-Cart 4.4.x: Administration menu -> Patch/Upgrade).
 
# In the 'Upgrade' section of the '<u>Patch/Upgrade Center</u>' page, use the '<u>Target version</u>' drop-down box to select the version to which you are going to upgrade your store (This corresponds to the upgrade pack you have uploaded). Also, in the 'I confirm that:' list, select all the checkboxes that apply. Click the '''Apply''' button.<br />X-Cart will test whether the files that need to be patched by the upgrade pack can be patched successfully and will list the respective files showing their status. The file status definitions are as follows:<br />
 
#* OK - File can be patched successfully.
 
#* Checksum error - Patch is corrupted. Try to download the patch again.
 
#* Non-writable - File does not have write permissions. Set write permissions on the file.
 
#* Not a file - Target is not a file. The original X-Cart structure has been modified and you need to apply the patch manually.
 
#* Not exists - File is missing. The original X-Cart structure has been modified and you need to apply the patch manually.
 
#* Could not patch - Patch cannot be applied to the file automatically, as the original X-Cart structure has been modified, and you need to apply the patch manually.
 
#* Already patched - File has been patched already.<br />If your Patch/Upgrade center detects any problems (errors - marked in red), you will not be able to proceed with upgrading your X-Cart based store until these problems are resolved. You will have to go back, make the necessary corrections and run the upgrade pack applicability test once again.<br />As soon as the applicability test has been passed successfully, you can continue with the upgrade pack application.
 
# Click the '''Apply patch''' button at the bottom of the page.<br>X-Cart will start patching the files. After the upgrade pack has been applied, X-Cart will display the list of patched files and a detailed report about the changes that have been made.
 
# Click the '''Finish''' button at the bottom of the page to complete the upgrade pack application.
 
  
====Applying database upgrade scripts====
+
'''Branch 4.2.x to branch 4.5.x'''
 +
<div id="Branch_4.2.x_to_branch_4.5.x"></div>
  
To apply a database upgrade script:
 
  
# Place the database upgrade script in the X-Cart root directory on your server or hosting account.<br />
+
# Log in to your {{QA}}.
#* ''If you use a Windows-based server, or a UNIX-based server without terminal access:''<br />Decompress the database upgrade archive to a directory on your system using your favorite compression program (WinZIP or any other archiver with support for TAR files).<br />Use an FTP client to upload all the files from the decompressed archive (retaining the directory structure) to the X-Cart root directory on your server or your hosting account.
+
# 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.
#* ''If you use a UNIX-based server with terminal access:''<br />Use an FTP client to upload the database upgrade archive to the X-Cart root directory on your server or your hosting account.<br />Decompress the archive using the following command:<br /><pre>tar -xzvf <archive_filename></pre>
+
# Locate an archive with the required database upgrade script. X-Cart database upgrade script archives use the following name formats:
# In a web browser, run the upgrade script <xcart_dir>/upgrade_sql.php replacing the <xcart_dir> part with the actual URL of your X-Cart installation. For example, http://www.example.com/xcart/upgrade_sql.php.
+
#* [current_version]-[target_version]_sql_upgrade.tgz
# Read the X-Cart License Agreement and click the '''Proceed with Upgrade''' button.<br />The script will display the progress of the upgrade procedure and finally report the results.
+
#* [current_version]-[target_version]_sql_upgrade.zip
 +
# Download the archive with the database upgrade script to your local computer.
  
# Retrieve the value of the variable $blowfish_key from the file config.php in the root directory of your existing X-Cart installation and temporarily save it somewhere on your local computer.<br />You will be asked to provide the Blowfish key later in order that X-Cart to decrypt the data in the upgraded database.
+
'''Branch 4.3.x to branch 4.5.x'''
# Install a fresh copy of X-Cart 4.3.x as described in the section Installing X-Cart earlier in this manual. Make sure the copy of X-Cart that you are going to install is the same as the the version of the upgraded database.<br />When installing X-Cart:
 
#* If you install X-Cart to the directory on your server or hosting account where a previous version of X-Cart is located, at the first step of the installation wizard select the radio button New Installation and enter the Auth code for the existing X-Cart installation. If you do not remember the code, retrieve the value of the variable $installation_auth_code from the file <xcart_dir>/include/install.php.
 
#* At the step Preparing to Install X-Cart Database of the installation wizard, select the check box Update config.php only and enter Blowfish key for the upgraded database.
 
  
==Troubleshooting==
+
# 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.
  
===Checksum errors during upgrade===
+
'''Branch 4.4.x to branch 4.5.x'''
  
Checksum errors during upgrade are typically the result of corruption of the upgrade pack files either by the archiver program that was used to extract the upgrade archive or by the FTP client that was used to upload the upgrade pack files to 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.
If the upgrade pack files were extracted from the archive using WinZip, and now you are getting checksum errors, check your WinZip configuration to see if it is causing the problem: click <u>Options</u>, then <u>Configuration</u>, then select the <u>Miscellaneous</u> tab. The option <b>'TAR file smart CR/LF conversion'</b> must be turned off. If it is not, clear this option and extract the files from the archive once again.
+
# 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
Also, ensure that your FTP client is set to transfer data in <b>'Binary'</b> mode. If, instead of the <b>'Binary'</b> mode, your FTP client is using the <b>'ASCII'/'Text'</b> mode, the files of your upgrade pack may end up being corrupted due to the incorrect translation of line break character codes between Windows and Unix systems. Although the changes are not visible, the test performed by X-Cart returns checksum values that do not match the checksums of the original files; thus, you get checksum errors. To resolve this problem, you should set your FTP client to the <b>'Binary'</b> mode and upload the upgrade pack files to the server again.
+
#* [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.