Migration from Litecommerce 3 to X-Cart 5
page last edited on 27 February 2017
This document describes the process of upgrade Litecommerce 3 to X-Cart 5.
- Step 1. Install the module Migrate2XCN.
- Step 2. Open the Migrate2XCN module settings page and enter your X-Cart 5 license key.
- Step 3. Change the marketplace URL in the file config.php.
- Step 4. Clear the marketplace cache.
- Step 5. Upgrade your store.
- Step 6. Activate the license key.
- Step 7. Update your etc/config.php file.
Step 1. Install the module Migrate2XCN.
- Download the module Migrate2XCN here: http://www.litecommerce.com/download/migrate
- Open the page ‘Manage add-ons’ in you admin area (admin.php?target=addons_list_installed)
- Click the ‘Upload add-on’ button and follow the instructions
Step 2. Open the Migrate2XCN module settings page and enter your X-Cart 5 license key.
Once you have installed the Migrate2XCN module, go to its settings:
and insert your X-Cart 5 license key there (you should have received this license key by email from X-Cart team)** **
Step 3. Change the marketplace URL in the file config.php.
Open the file
<litecommerce-dir>/etc/config.phpin a text editor
Find out these lines there:
Replace the url option as shown below:
Step 4. Clear the marketplace cache.
Open the page admin.php?target=addons_list_marketplace&action=clear_cache
Step 5. Upgrade your store.
After that you will see one of the links (‘Updates available’ or ‘Upgrade available’) in the header of the Admin area.
Click this link and upgrade your Litecommerce 3 store.
After that you will see the following message:
Stock Chart and Wishlist modules are just for example here. You may see other modules during this step as it depends on which modules have been installed in your Litecommerce 3. At least, the module Migrate2XCN will be displayed there. Do not worry, this is correct behaviour. Click the Continue button and follow further upgrade steps.
Step 6. Activate the license key.
Step 7. Update your etc/config.php file.
It is recommended to adjust the config.php file after upgrade.
Create a backup of the
<litecommerce-dir>/etc/config.phpfile (e.g. copy this to file config.bak.php)
Copy the file
Open both the files
<litecommerce-dir>/etc/config.phpand config.bak.php in a text editor.
Copy the contents of the following sections from config.bak.php to
[database_details] [host_details] [installer_details]
If any other sections in your config.php file have been changed, e.g. [clean_urls], [skin_details], etc, transfer them to the new config.php as well.
Error: maximum execution time of 30 seconds exceeded during cache regeneration or upgrade operation.
This problem might be caused by a large quantity of installed modules. Try to reload the page or adjust the max_execution_time PHP variable.
Problem: X-Cart 5 displays only text without design during the upgrade.
Try to reload the pages, it usually happens if there are many installed modules in your LiteCommerce.
Problem: You are seeing inconsistency in design after upgrade.
Try to clear the browser’s cache.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.