MAGENTO Migration Tools - LitExtensionlitextension.com/docs/cart_migration_user_guide.pdf · Magento Migration Tools: User Guide Page 4 Disable email notification To prevent email

MagentoMigrationTools:UserGuide Page1

MAGENTOMigrationTools

UserGuide

Copyright©2014LitExtension.com.AllRightsReserved.


Content

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

2.Setup...........................................................................................5

3.PluginsSetup...............................................................................7

4.MigrationSpeedOptimization......................................................8

5.EnterLicenseKey.........................................................................9

6.Migration...................................................................................10

7.MigrationResuming...................................................................14

8.AdvancedConfiguration.............................................................16

9.UseCases...................................................................................17

10.DataVerification......................................................................18

11.FrequentlyAskedQuestions.....................................................19


1.PreparationForSourceStore:

- PleaseensureyouhavetherightpermissiontouploadfilesintoyourSourceStore.

- ItmustnotblockaccessfromTargetStoretotheconnector.

SourceStorecanoperatenormallyduringmigrationasitrequiresaverylimitedresourceforthe

process.

PHPCompatibility:PHP4.xorlater.

ForTargetStore:

ItisstronglyrecommendedtobackupMagentoTargetStorefirst.

- TargetStoreshouldbeplacedinastablehostingorinlocalhost.

- ItalsomustnotblockconnectiontoSourceStore.

- Webserver(mostlyapache)shouldhavefullpermissiontowriteon/mediafolder.

PHPCompatibility:PHP5.3orlater.

MagentoCompatibility:1.7orlater.

RequiredPHPextensions:

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

RequiredPHPconfigurations:

- memory_limitnolessthan256Mb- allow_url_fopenmustbeOn- base64_decodeshouldbeallowed


Disableemailnotification

Topreventemailnotificationduringcustomerimport,itisrecommendedtodisableitviaMagento

backendandreenablewhenmigrationiscompleted.

• LogintoMagentobackend

• GototheSystem->Configurationmenu.

• OnthelefthandmenuundertheAdvancedtab(atthebottom)selecttheSystemmenu

item.

• Select‘MailSendingSettings’fromtheselectionontherighthandside.

• SetDisableemailcommunicationsto‘Yes’,thennoemailwillsendthroughMagento.


2.SetupAfterdownloadingtheproductzipfilefromourStore,pleaseextractitintoafolder.Themodule

consistsoftwomainparts:MagentoDataMigrationModule(“app”and“skin”folder)andSource

CartConnector(“Magento_connector”folder)

1.MagentoDataMigrationModuleSetup

MagentoDataMigrationModuleisaMagentoModulewhichactslikeahubatMagentosideto

receivedataandimportitintoMagentodatabase.ItcanbeinstalledjustlikeallotherMagento

Modules,pleasefollowourgeneralInstallationGuide:

http://litextension.com/docs/litextension_installation_guide.pdf

2.SourceCartConnectorSetup

Extract“Magento_connector”intoSourceCartrootfolder.AfterfinishedpleasemakesureMigration

Connectorcanbereachedat:http(s)://yourstore.com/magento_connector/connector.php


Ifyouhaveanyproblemreachingthelinkpleaseensureyouhavehtaccessconfiguredcorrectlyand

thefilehasexecutionpermission.

Forsecurity,pleaseopenconnector.php,findthisveryfirstline:

define('LECM_TOKEN','123456');

Andchange"123456"toanotherstring,thiswillbeusedtoentertotheMigrationForm(CartToken)

andactslike"password"topreventunauthorizeddataaccesstoyoursourcestore.

Note:pleasedonotusespecialcharactersintokenorelsethemigrationtoolmightfailtowork,it

shouldcontainnumberandalphabetcharactersonly.Examples:

- Goodtoken:12ab34cd56

- Badtoken:#Fr35h#Mi!5


3.PluginsSetupPluginsarepurchasedandsetupseparatelyintoMagentoDataMigrationModule.Theywillprovide

additionalfunctionalitiestothetool.Normallypluginsneedtobecustomizedandtweakedby

LitExtensionTeamtofitcustomersrequirementsandwillbesenttocustomerslateron.Therearea

fewtypesofplugin:

-ProductsandCategoriesSEOUrlsPlugin:helpsmigrateProductsandCategoriesurls.Oldurlswill

besavedinTargetMagentoStoreandwillbemaintainedtokeepallcurrentSEOrankingyouhave

builtupforyears.

-CustomFieldsPlugin:helpmigratecustomfieldsfromSourceStoretoTargetMagentoStore.Thisis

usefulincasecustomershavecustomizedtheirstore,forexample:addingfieldstodatabasetables,

andalsowanttomigratethesefieldsintoMagentoStore.

-CustomerPasswordPlugin:specialpluginwhichaddstheabilitytoreadpasswordsencryptedby

SourceStorestoMagento.Allpasswordsaremigratedoverandremainsencrypted,customerscan

logintothenewshoprightawaywithouttheneedofresettingpasswords."ZencarttoMagento"and

"MagentotoMagento"toolsnativelysupportmigratingpasswordsanddonotneedthisplugin.

Toinstallplugins,justcopypluginfilesintotheinstructedfolderinsideCartMigrationMagento

Module,newfunctionalitieswillbeenabled.


4.MigrationSpeedOptimizationForSourceStore:

- ThefasterSourcestorecanbeaccessed,thefastermigrationspeedwillbe.

ForTargetStore:

- AsmigrationprocessisprocessedmostlyonTargetstore,itiscriticaltohaveafastmagentoserver.Recommendedserverconfiguration:4coresorhigher,4Gmemoryorhigher.

- Compilationshouldbeenabledtoimprovespeed(System>Tools>Compilation).- Cacheshouldbeenabledtoimprovespeed(System>CacheManagement).


5.EnterLicenseKeyLicenseKeyisanencodedstringwhichcomeswithyourdownloadpackage.Thiskeyisneededto

activateyourMigrationTool.

1.Afterpurchasingtheproduct,pleaselogintoourstoreandenter“Mydownloadableproducts”

section.Hereyouwillfinddownloadlinkandlicensekeyforthedownloadpackage.

2.LoginyourMagentoTargetStorebackend,selectCartMigration>Configuration,andcopyand

pasteyourlicensekeyhere:


6.MigrationPleaseloginyourMagentoTargetStorebackend,selectCartMigration>Migration

Themigrationwillgothrough3simplesteps.Justhit“Next”whenyoufinishonesteptoadvance.

Step1:SourceCartConfiguration

• CartType:selectcorrespondingsourcecarttype(osCommerce,ZenCart,VirtueMart,

WooCommerce,…..)

• CartUrl:sourcecartfullurl

• CartToken:thetokenstringwhichhasbeenconfiguredinconnector.php


Step2:MigrationConfiguration

• RootCategory:thecategoryofcurrentMagentostoretoimportallsourcecartcategories

into.

• ProductAttributeSet:selectanAttributeSetwhichisusedtoimportproducts,allnecessary

attributesinmigrationprocesswillbecreatedintothisset.

• LanguagesMapping:IfyourSourceCartismultilingual,correspondinglanguages(or

storeviews)shouldbeavailableinTargetMagentoStore.Youmayneedtocreateadditional

languagesinMagentoStoretoavoiddataloss.

• CurrenciesMapping:AssignSourceCartcurrenciestoproperTargetMagentoStore

currencies.CreatingcurrenciesinTargetMagentoStoremaybeneeded.

• OrdersStatusMapping:AssignSourceCartorderstatusestoproperTargetMagentoStore

orderstatuses.CreatingadditionalorderstatuesinTargetMagentoStoremaybeneeded.

• EntitiestoMigrate:selectallentitiestomigrateorjustapartofthem.


AdditionalOptions:

• Migraterecentdata:ifyouchoosethisoption,itwillmigratenewdataonly.Supposedyou

havejustfinishedafullmigrationfromyourcurrentSourcestoretoTargetstore,afterthat

Sourcestoreisstillliveandcontinuegettingnewdata,andyouwanttogetyourTargetstore

updatedwiththenewdata,selectthisfeaturetoavoidstartingoveragain.

• ClearcurrentdataonTargetStorebeforeMigration:ifyouchoosethisoption,allcurrent

products,categories,manufacturers,customers,orders,productreviews,taxeswillbe

cleared.

• MigratecategoriesandproductsSEOURLs:ifyouchoosethisoption,oldSEFurlsofsource

willbepreservedinTargetMagentoStore,allowingyoutomaintainyourPagerank.

• TransferimagesinproductdescriptionstoTargetStore:downloadallimagesinproduct

descriptionintoyourstoresothatitwon’thavetoreferbacktoyoursourcestoreor

anywhereelseforimages.

• PreserveCustomerIDsonTargetStore:thiswillhelpyoupreserveyouroldCustomerIDsfor

easierreference.


• PreserveOrderIDsonTargetStore:thiswillhelpyoupreserveyouroldOrderIDsforeasier

reference

Step3:Migration

Themigrationwilltakeplaceautomaticallyinthisfinalstep.Inorderforittoprogress,youshould

notcloseyourbrowserofremoveSourceCartConnector.

Afterthemigrationiscompleted,clickon“ClearCacheandReIndexData”tofinish.Ifyoudon’twant

torunitrighthereoritreturnsfalseforanyreason,youcandothatmanuallyinSystem>Cache

ManagementandSystem>IndexManagement.


7.MigrationResumingWhenaproblemoccurringonthemigrationprocess,MagentoMigrationToolprovidestheabilityto

resumetheprocess:

1.Automaticallyresumeonthespot:thetoolwillautomaticallyresumeafterafailureuntilalldatais

imported.

2.Manuallyresume:youcanrefreshthepagetogobacktoStep1andclickon“Resume”,thisis

helpfulwhenyouwanttotemporarilystopmigrationandresumewhenyouwantto.



8.AdvancedConfigurationAccessAdvancedConfigurationbygoingtoCartMigration>ConfigurationfromMagentobackend

menu.Alldefaultvaluesareconfiguredtoworkwithmostcases,thusitisrecommendedtochange

thesevaluesonlywhenitisnecessaryto.

• XXXPerBatch:CartMigrationsplitseachentitydataintosmallbatches(orchunks)and

importtheminturn.Thisoptiondefinesbatchsizetoprocessineachturn.Dependingon

yourMagentohostingresourceyoucanchangethevaluesaccordingly.Thelowerthevalue

is,thelesstimeandresourceMagentospendstoprocessabatch,alsothelongeroverall

timetoimportfulldata.

• DelayTime:thesleepingtimebetweeneachbatch.Thisoptiondefinesthe“breaktime”for

bothSourceStoreandTargetStore.ItisalsohelpfultopreventTimeoutissueifSourceStore

hasbeensetuptolimitthenumberofrequestsinaperiodoftime.

• AutoRetryAfter:ifbysomereason,thebatchprocessfails,thetoolwillautomaticallyretry

afteraperiodoftimedefinedbythisoption.


9.UseCases1.Clearcurrentdataandfreshmigratealldata

ProceednormalytoStep2,herepleasechoose“Allentities”and“Clearcurrentdataoftargetstore”.HitnexttoproceedtoStep3.

2.Clearcurrentdataandfreshmigratesomespecificentities

ProceednormalytoStep2,herepleasechooseonlyentitiesyouwanttomigrateand“Clearcurrentdataoftargetstore”.HitnexttoproceedtoStep3.Note:“Clearcurrentdataoftargetstore”willonlycleardataofselectedentities.

3.Incrementalmigration

LetssayyouhavesuccessfullyperformedfirstmigrationfromSourcestoretoTargetstoreforafew/allentities.Datahasbeenimportedproperly.Afewdayslater,yourSourcestorehassomemoredataandyouwanttoimportthisnewdataonly(incrementalmigration).Hereishowtodoit:

- Incrementalmigrationcanonlybedoneformostrecentmigratedentities.Example:ifyouhavemigratedallentitiesforthefirsttime,inthesecondtimeyoucanincrementallymigratenewdataofallentities.IfyouonlymigratedforexampleCustomers+Ordersonly,thenexttimeyoucanonlyperformincrementalmigrationforCustomers+Orders.

- ProceednormallytoStep2.Herepleasechooseentitiesyouwanttomigrate(mustbethesameentitesyoumigratedlasttime)and“Migraterecentdata”.

- ProceedtoStep3.


10.DataVerification1. Defaultdata

MigrateddatashouldbecheckedinTargetStorebackendbecauseinformationdisplayedonfrontendmightgothroughfilters,modificationsbythestoretemplatewhichdoesnotfullyjustifyhowthedatawasmigrated.

2. SEOUrls

HowSEOUrlsPluginworks:"ProductsandCategoriesSEOUrlsPlugin"helpsmigrateProductsandCategoriesurls.OldurlswillbesavedinTargetMagentoStoreandwillbemaintainedtokeepallcurrentSEOrankingyouhavebuiltupforyears.

Inmostcases,youwouldlikelyhaveanoldsourcestoreat:http://my-source-store.comandwanttomigrateyourdatatoanotherlocationhttp://my-target-store.com,afterthatyouwanttoputthisstorebacktoyourolddomain(http://my-source-store.com).

IfyouhaveusedSEOPlugintomigrateoldproductandcategoryurlsovertotargetstore,youcanchecktheresultbyfollowingthesesteps:

1) Pickaproducturl(orcategoryurl)fromyoursourcestore,example:http://my-source-store.com/troika-black-carbon-pen

2) Whenthisproduct(category)ismigratedtoyourtargetstore,itwouldlikelyanewurl,example:http://my-target-store.com/troika-black-carbon-pen-new-url-123.Thisurlisautogeneratedbyyournewstoreplatformandcannotbechanged.Typetheoldrelativeurlonyourtargetdomain,example:http://my-target-store.com/troika-black-carbon-pen.Thisurlshouldworkanddisplaythecorrectproduct/category,andwouldbeidenticaltothenewurl(http://my-target-store.com/troika-black-carbon-pen-new-url-123).

3) Whenyoureplacethesourcestorewithyournewtargetstore,thislink(http://my-source-store.com/troika-black-carbon-pen)willbemaintainedandcanhelppreservesearchranking.Pleasenote:alongwithit,thenewlink(http://my-source-store.com/troika-black-carbon-pen-new-url-123)willalsobeavailable.

3. CustomerPassword

IfyouhaveCustomerPasswordPlugin,aftermigration,customerscanimmediatelyusetheiroldpasswordstologininthenewstore,withouttheneedofresettingoranyfurtheraction.


11.UninstallAftermigrationiscompleted,themigrationtoolmightnotbeneededanymore.Itisrecommendedtouninstall/disablethetool.

1.Removetheconnector:theconnectorcanbesafelydeletedonyoursourcestore.

2.Disablemigrationmodule:thisishelpfulwhenyouwanttoquickdisablethemoduleanddon’twanttoremoveit:

Open/app/etc/modules/LitExtension_CartMigration.xml

change:<active>true</active>

to:<active>false</active>

Afterthat,clearMagentocache.

3.Uninstallmigrationmodule:

Manuallydeleteallfiles/foldersyouofthemodules.

Afterthat,clearMagentocache.


12.FrequentlyAskedQuestions1. Productimportstopspermanentlyatsomespecificpoint,howtoresolve?

Cause:phpexecutiontimetoolow

Solution:

• GotoCartMigrationConfiguration,changevalue“ProductsperBatch”toalowernumber

• Increaseyouserverphpmax_execution_timevalue

2. Atstep2,thetoolcannotreadmymappingdata?


Cause:migrationtoolcannotreadyoursourcestoredatabase

Solution:checkCartMigrationConfigurationandensureyouentercorrecttableprefixforyour

sourcedatabase

3. “Magentodatabaseisn'tworking”whenhittingNextonStep1?

Cause:therewasanissuewiththeinstallation,themodulecouldnotcreateitsadditionaltablesinto

Magentodatabase.

Solution:loginmysqladmin,runthisscript:


DELETEFROM`core_resource`wherecode="lecamg_setup"

Afterthat,refreshtheStep1page.

4. Canthetoolmigratecustomerpasswords?

Yes!

Thetoolcanmigratepasswordswith"CustomerPasswordPlugin".Thisisaspecialpluginwhichadds

theabilitytoreadpasswordsencryptedbysourcestorestoMagento.Allpasswordsaremigrated

overandremainsencrypted,customerscanlogintothenewshoprightawaywithouttheneedof

resettingpasswords."ZencarttoMagento"and"MagentotoMagento"toolsnativelysupport

migratingpasswordsanddonotneedthisplugin.

5. CanthetoolmigrateproductsandcategoriesoldUrlstopreserveSEOranking?

Yes!

"ProductsandCategoriesSEOUrlsPlugin"helpsmigrateProductsandCategoriesurls.Oldurlswillbe

savedinTargetMagentoStoreandwillbemaintainedtokeepallcurrentSEOrankingyouhavebuilt

upforyears.

Forustocreatetheplugin,pleaseprovideyoursourcecarturl,wewilldiagnoseandcreatethe

plugintosendtoyouwithin24hours.TherearecaseswhichwealsorequireFTPofyoursourcecart.

6. MySourceStorehassomecustomdatawhichIhavemanuallyadded,canwemigratesuch

datatomytargetstore?

Yes!

"CustomFieldsPlugin"helpsmigratecustomfieldsfromSourceStoretoTargetMagentoStore.This

isusefulincasecustomershavecustomizedtheirstore,forexample:addingfieldstodatabase

tables,andalsowanttomigratethesefieldsintoMagentoStore.

Forustocreatetheplugin,pleaseprovideFTPofyoursourcecart,wewilldiagnoseandcreatethe

plugintosendtoyouwithin24hours.

7. Morequestions?

Pleasedropusamessageat:http://litextension.com/contacts/

Oremailusat:[email protected]

Wearestrivingtogetyourquestionsansweredwithin24hours.

Documents

MAGENTO Migration Tools - LitExtensionlitextension.com/docs/cart_migration_user_guide.pdf · Magento Migration Tools: User Guide Page 4 Disable email notification To prevent email