Magento Cart Service Migration Guide

Source: Shopify, BigCommerce, 3dCart, Americommerce

Target: Magento.

For Source Store:

  • Please ensure you have the right privilege to login into your Source Store backend for creating API accounts.

Source Store can operate normally during migration as it requires a very limited resource for the process.

 

For Target Store:

It is strongly recommended to backup Magento Target Store first.

  • Target Store should be placed in a stable hosting or in localhost.
  • It also must not block connection to Source Store.
  • Webserver (mostly apache) should have full permission to write on /media folder.

PHP Compatibility:

  • Magento 1.x: PHP 5.3 or later.
  • Magento 2.x: PHP 5.6 or later.

Magento Compatibility: 1.7 or later.

Required PHP extensions:

  • pdo_mysql
  • simplexml
  • mcrypt
  • hash
  • GD
  • DOM
  • curl
  • mb_strings

Required PHP configurations:

  • memory_limit no less than 256Mb
  • allow_url_fopen must be On.

 

Disable email notification

To prevent email notification during customer import, it is recommended to disable it via Magento backend and reenable when migration is completed.

  • Login to Magento backend
  • Go to the System->Configuration menu ( Magento 1.x ), or Store -> Configuration ( Magento 2.x ).
  • On the left hand menu under the Advanced tab (at the bottom) select the System menu item.
  • Select ‘Mail Sending Settings’ from the selection on the right hand side.
  • Set Disable email communications to ‘Yes’, then no email will send through Magento.

After downloading the product zip file from our Store, please extract it into a folder. The module consists of Magento Data Migration .

cart-service-setup-1

Target Magento Data Migration Module Setup

For Magento 1.x

1. Check to see if Magento’s Compilation mode has been enabled. If it has, it’s vital to turn it off before installing an extension or making any code changes (go to System > Tools > Compilation).

2. Use upload file by ftp or uploaded directly to upload or copy all folders in the zip package to your Magento site root folder. This will not overwrite any existing files, just add new files to the folder structure.

3. If you are using Magento’s compilation mode, you need to hit the “Run Compilation Process” button to update the compiled state with the newly installed extension (go to System > Tools > Compilation).

4. Log into your Magento admin console and go to System/Cache Management. Click “Clear Storage Cache“.

5. Log out admin panel and log in again ( this is a normal behaviour of Magento ).

For Magento 2.x

1. Use upload file by ftp or uploaded directly to upload or copy all folders in the zip package to your Magento site root folder. This will not overwrite any existing files, just add new files to the folder structure.

2. In SSH console of your server navigate to your store root folder:

cd path_to_the_store_root_folder

run these commands:

php -f bin/magento module:enable LitExtension_Core

php -f bin/magento module:enable LitExtension_CartServiceMigration

php -f bin/magento setup:upgrade

php -f bin/magento setup:static-content:deploy

3. Flush store cache; log out from the backend and log in again.

4. Important: you should allow Admin Account Sharing, to ensure the migration progress will not be stopped when you login Admin from another place. Please go to Backend > Stores > Configuration > Advaced Tab > Admin > Admin Account Sharing change to “YES”.

 

For Shopify

Create API Key and Password for Shopify          

cart-service-setup-2                                                                                     

In order to enable data migration to or from Shopify, you will need to provide an API Password for your store. So, here is a step-by-step tutorial that will help you to get this information by your own.

  1. At first, log in to your store’s admin area and go to Apps Menu.
  2. Than, press Private Apps button
  3. Click Generate a Private App
  4. Enter the title of your new Private App and save the changes.
  5. Right after that, you will see your API Key and Password.

You will then need to copy and paste these info into migration Step 1.

 

For BigCommerce

Create Username, API Path and API Token for Bigcommerce

cart-service-setup-3

You need to retrieve Username, API Path and API Token from your Bigcommerce admin account.

  1. Please Login to your store’s control panel.
  2. Look at the top right conner, click on Setup & Tools > Advanced tools > Legacy API Accounts.
  3. Press Create a Legacy API Account.
  4. You will see Username, API Path and API Token.

You will then need to copy and paste these info into migration Step 1.

 

For 3dCart

cart-service-setup-4

Log into your 3dcart Online Store Manager and, using the left hand-navigation menu:

  1. Go to Modules
  2. Look for the SOAP API module and click on its + Icon to expand the selection.
  3. Click on the “Change Settings” link
  4. Place a mark in the “Enable API” checkbox.
  5. Copy your API key and click on the “Save” button at the top right.

The API key you just copied can now be used on whatever program you’re using that requires API.

You will then need to copy and paste these info into migration Step 1.

Plugins are purchased and setup separately into Magento Data Migration Module. They will provide additional functionalities to the tool. Normally plugins need to be customized and tweaked by LitExtension Team to fit customers requirements and will be sent to customers later on. There are a few types of plugin:

Products and Categories SEO Urls Plugin: helps migrate Products and Categories urls. Old urls will be saved in Target Magento Store and will be maintained to keep all current SEO ranking you have built up for years.

Custom Fields Plugin: help migrate custom fields from Source Store to Target Magento Store. This is useful in case customers have customized their store, for example: adding fields to database tables, and also want to migrate these fields into Magento Store.

Customer Password Plugin: special plugin which adds the ability to read passwords encrypted by Source Stores to Magento. All passwords are migrated over and remains encrypted, customers can login to the new shop right away without the need of resetting passwords. “Zencart to Magento” and “Magento to Magento” tools natively support migrating passwords and do not need this plugin.

For Magento 1.x

To install plugins, just copy plugin files into the instructed folder inside Cart Migration Magento Module, new functionalities will be enabled.

For Magento 2.x

To install plugins, just copy plugin files into the instructed folder inside Cart Migration Magento Module, new functionalities will be enabled. For Customer Password Plugin, you will also need to install it:

cd path_to_the_store_root_folder

run these 3 commands:

php -f bin/magento module:enable LitExtension_CustomerPassword

php -f bin/magento setup:upgrade

And flush store cache

License Key is an encoded string which comes with your download package. This key is needed to activate your Migration Tool.

  1. After purchasing the product, please login to our store and enter “My downloadable products” section. Here you will find download link and license key for the download package.cart-service-listen-key-1 cart-service-listen-key-2
  2. Login your Magento Target Store backend, select Cart Migration > Configuration, and copy and paste your license key here:

Please login your Magento Target Store backend, select Cart Migration > Migration

The migration will go through 3 simple steps. Just hit “Next” when you finish one step to advance.

 

Step 1: Source Cart Configuration

 

For Shopify

cart-service-migration-1

  • Cart Type: select corresponding source cart type (auto selected as Shopify)
  • Cart Url: shopify store original url ( the root url you may see when logging in backend )
  • API Key, Password: created in section 2. SETUP

For BigCommerce

cart-service-migration-2

  • Cart Type: select corresponding source cart type (auto selected as Bigcommerce)
  • Cart Url: bigcommerce store original url
  • Username, API Path, API Token: created in section 2. SETUP

For 3dCart

cart-service-migration-3

  • Cart Type: select corresponding source cart type (auto selected as 3dcart)
  • Cart Url: 3dcart store original url
  • API Key: created in section 2. SETUP

 

Step 2: Migration Configuration

cart-service-migration-4

  • Root Category: the category of current Magento store to import all source cart categories into.
  • Product Attribute Set: select an Attribute Set which is used to import products, all necessary attributes in migration process will be created in to this set.
  • Languages Mapping: If your Source Cart is multilingual, corresponding languages ( or storeviews) should be available in Target Magento Store. You may need to create additional languages in Magento Store to avoid data loss.
  • Currencies Mapping: Assign Source Cart currencies to proper Target Magento Store currencies. Creating currencies in Target Magento Store may be needed.
  • Orders Status Mapping: Assign Source Cart order statuses to proper Target Magento Store order statuses. Creating additional order statues in Target Magento Store may be needed.
  • Entities to Migrate: select all entities to migrate or just a part of them.cart-service-migration-5

Additional Options:

  • Migrate recent data: if you choose this option, it will migrate new data only. Supposed you have just finished a full migration from your current Source store to Target store, after that Source store is still live and continue getting new data, and you want to get your Target store updated with the new data, select this feature to avoid starting over again.
  • Clear current data on Target Store before Migration: if you choose this option, all current products, categories, manufacturers, customers, orders, product reviews, taxes will be cleared.
  • Migrate categories and products SEO URLs: if you choose this option, old SEF urls of source will be preserved in Target Magento Store, allowing you to maintain your Pagerank.
  • Transfer images in product descriptions to Target Store: download all images in product description into your store so that it won’t have to refer back to your source store or anywhere else for images.
  • Preserve Customer IDs on Target Store: this will help you preserve your old Customer IDs for easier reference.
  • Preserve Order IDs on Target Store: this will help you preserve your old Order IDs for easier reference

Step 3: Migration

The migration will take place automatically in this final step. In order for it to progress, you should not close your browser of remove Source Cart Connector.

After the migration is completed, click on “Clear Cache and ReIndex Data” to finish. If you don’t want to run it right here or it returns false for any reason, you can do that manually in System > Cache Management and System > Index Management.

When a problem occurring on the migration process, Magento Migration Tool provides the ability to resume the process:

  1. Automatically resume on the spot: the tool will automatically resume after a failure until all data is imported.cart-service-resum-1
  2. Manually resume: you can refresh the page to go back to Step 1 and click on “Resume”, this is helpful when you want to temporarily stop migration and resume when you want to.cart-service-resum-2cart-service-resum-3

Access Advanced Configuration by going to Cart Migration > Configuration from Magento backend menu. All default values are configured to work with most cases, thus it is recommended to change these values only when it is necessary to.

cart-service-advanced

  • XXX Per Batch: Cart Migration splits each entity data into small batches (or chunks) and import them in turn. This option defines batch size to process in each turn. Depending on your Magento hosting resource you can change the values accordingly. The lower the value is, the less time and resource Magento spends to process a batch, also the longer overall time to import full data.
  • Delay Time: the sleeping time between each batch. This option defines the “break time” for both Source Store and Target Store. It is also helpful to prevent Timeout issue if Source Store has been setup to limit the number of requests in a period of time.
  • Auto Retry After: if by some reason, the batch process fails, the tool will automatically retry after a period of time defined by this option.
  1. Default data

Migrated data should be checked in Target Store backend because information displayed on frontend might go through filters, modifications by the store template which does not fully justify how the data was migrated.

  1. SEO Urls

How SEO Urls Plugin works: “Products and Categories SEO Urls Plugin” helps migrate Products and Categories urls. Old urls will be saved in Target Magento Store and will be maintained to keep all current SEO ranking you have built up for years.

In most cases, you would likely have an old source store at : http://my-source-store.com and want to migrate your data to another location http://my-target-store.com , after that you want to put this store back to your old domain ( http://my-source-store.com ).

If you have used SEO Plugin to migrate old product and category urls over to target store, you can check the result by following these steps:

  1. Customer Password

If you have Customer Password Plugin, after migration, customers can immediately use their old passwords to login in the new store, without the need of resetting or any further action.

  1. Product import stops permanently at some specific point, how to resolve?Prestashop-import-frequently

Cause: php execution time too low

Solution:

  • Go to Cart Migration Configuration, change value “Products per Batch” to a lower number
  • Increase you server php max_execution_time value
  1. “Magento database isn’t working” when hitting Next on Step 1?cart-service-frequently-2

Cause: there was an issue with the installation, the module could not create its additional tables into Magento database.

Solution: login mysql admin, run this script:

DELETE FROM `core_resource` where code = “lecamg_setup”

After that, refresh the Step 1 page.

  1. Can the tool migrate customer passwords?

Yes!

The tool can migrate passwords with “Customer Password Plugin”. This is a special plugin which adds the ability to read passwords encrypted by source stores to Magento. All passwords are migrated over and remains encrypted, customers can login to the new shop right away without the need of resetting passwords. “Zencart to Magento” and “Magento to Magento” tools natively support migrating passwords and do not need this plugin.

  1. Can the tool migrate products and categories old Urls to preserve SEO ranking?

Yes!

“Products and Categories SEO Urls Plugin” helps migrate Products and Categories urls. Old urls will be saved in Target Magento Store and will be maintained to keep all current SEO ranking you have built up for years.

For us to create the plugin, please provide your source cart url, we will diagnose and create the plugin to send to you within 24 hours. There are cases which we also require FTP of your source cart.

  1. My Source Store has some custom data which I have manually added, can we migrate such data to my target store?

Yes!

“Custom Fields Plugin” helps migrate custom fields from Source Store to Target Magento Store. This is useful in case customers have customized their store, for example: adding fields to database tables, and also want to migrate these fields into Magento Store.

For us to create the plugin, please provide FTP of your source cart, we will diagnose and create the plugin to send to you within 24 hours.

  1. More questions?

Please drop us a message at: http://litextension.com/contacts/

Or email us at: contact@litextension.com

We are striving to get your questions answered within 24 hours.