Date post: | 22-Apr-2018 |
Category: |
Documents |
Upload: | duongkhanh |
View: | 224 times |
Download: | 5 times |
Volusion to Magento Migration Tool: User Guide Page 1
VOLUSION to MAGENTO Migration Tool
User Guide
Copyright © 2014 LitExtension.com. All Rights Reserved.
Volusion to Magento Migration Tool: User Guide Page 2
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
Volusion to Magento Migration Tool: User Guide Page 3
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.
Volusion to Magento Migration Tool: User Guide Page 4
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.
Volusion to Magento Migration Tool: User Guide Page 5
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:
Volusion to Magento Migration Tool: User Guide Page 6
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.
Volusion to Magento Migration Tool: User Guide Page 7
• 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.
Volusion to Magento Migration Tool: User Guide Page 9
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.
Volusion to Magento Migration Tool: User Guide Page 10
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.
Volusion to Magento Migration Tool: User Guide Page 11
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.
Volusion to Magento Migration Tool: User Guide Page 12
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
Volusion to Magento Migration Tool: User Guide Page 13
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.
Volusion to Magento Migration Tool: User Guide Page 14
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?
Volusion to Magento Migration Tool: User Guide Page 15
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.