volusion to magento - litextensionvolusion to magento migration tool: user guide page 4 2. set-up...

Volusion to Magento Migration Tool: User Guide

VOLUSION to MAGENTO Migration Tool

User Guide

Copyright © 2014 LitExtension.com. All Rights Reserved.


Contents

1. Preparation ................................................................ 3

2. Set-up ........................................................................ 4

3. Set-up ........................................................................ 4

4. License Key validation ............................................... 5

5. Migration .................................................................... 6

6. Migration Resuming ................................................ 12

7. Advanced Configuration .......................................... 12

8. Frequently Asked Questions ................................... 14


1. Preparation 1.1 For Source Store:

- Please ensure you have the right permission to your Source Store.

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

the process.

1.2 For Target Store:

- Target Store should be placed in a stable hosting or in localhost.

- PHP Curl must be enabled.

- PHP Fopen (allow_url_fopen) must be On.

- It also must not block connection to Source Store.

- Webserver (mostly apache) should have full permission to write on /media folder.

It is strongly recommended to backup Magento Target Store first.


2. Set-up After downloading the product zip file from our Store, please extract it into a folder.

Volusion to Magento Migration Tool is a Magento extension which acts like a hub at Magento

side to receive data and import it into Magento database. It can be installed just like all other

Magento Modules, please follow our general Installation Guide:

https://drive.google.com/viewerng/viewer?url=http://litextension.com/docs/litextension_installatio

n_guide.pdf

3. Set-up Extensions are purchased and setup separately into Migration Tool. 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 2 types of plugin:

- Products and Categories SEO Urls Plugin: help migrate Products and Categories urls.

Old urls will be saved in Target Magento Store and it will create 301 redirects from old urls to

new urls.

- Custom Fields Plugin: help migrate custom fields from Volusion 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.

To install plugins, just copy plugin files into the instructed folder inside Migration Tools. New

functionalities will be enabled.


4. License Key validation 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.

2. Login your Magento Target Store backend, select Cart Service Migration > Configuration,

and copy and paste your license key here:


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

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

advance.

5.1 Export Volusion Store data to CSV

Proceed with the following steps for required data tables:

• Sign in to your Volusion admin account.

• Go to Inventory -> Import/Export and click on "Standard Export" button.

• Select the appropriate data table from "Export from" drop-down.

• Select all Columns using checkbox.


• Select "CSV - Comma Delimited Text File" from "File Format" drop-down.

• Click on the "Export" button.

• Download generated file to your local computer.

Please note if the size of downloaded CSV file exceeds 20MB limit (How to change this

limit: https://www.google.com/search?q=change+php+upload+file+size)

Step 1: Source Cart Configuration

• Cart Url: source cart full url

• Upload CSV files in the corresponding field below.


Step 2: Migration Configuration

• 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.


Additional Options:

• 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.

• 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

• 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.


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.

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 here, you can do that manually in System >

Cache Management and System > Index Management.


6. Migration Resuming 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.

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.

7. Advanced Configuration Access Advanced Configuration by going to Cart Service 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.

• 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.


8. Frequently Asked Questions 1. Product import stops permanently at some specific point, how to resolve?

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

2. At step 2, the tool can not read my mapping data?


Cause: migration tool can not read your source store database

Solution: check Cart Migration Configuration and ensure you enter correct table prefix for

your source database

3. “Magento database isn't working” when hitting Next on Step 1?

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.

volusion to magento - litextensionvolusion to magento migration tool: user guide page 4 2. set-up...

Documents