Upload
vutruc
View
235
Download
5
Embed Size (px)
Citation preview
MagentoMigrationTools:UserGuide Page1
MAGENTOMigrationTools
UserGuide
Copyright©2014LitExtension.com.AllRightsReserved.
MagentoMigrationTools:UserGuide Page2
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
MagentoMigrationTools:UserGuide Page3
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
MagentoMigrationTools:UserGuide Page4
Disableemailnotification
Topreventemailnotificationduringcustomerimport,itisrecommendedtodisableitviaMagento
backendandreenablewhenmigrationiscompleted.
• LogintoMagentobackend
• GototheSystem->Configurationmenu.
• OnthelefthandmenuundertheAdvancedtab(atthebottom)selecttheSystemmenu
item.
• Select‘MailSendingSettings’fromtheselectionontherighthandside.
• SetDisableemailcommunicationsto‘Yes’,thennoemailwillsendthroughMagento.
MagentoMigrationTools:UserGuide Page5
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
MagentoMigrationTools:UserGuide Page6
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
MagentoMigrationTools:UserGuide Page7
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.
MagentoMigrationTools:UserGuide Page8
4.MigrationSpeedOptimizationForSourceStore:
- ThefasterSourcestorecanbeaccessed,thefastermigrationspeedwillbe.
ForTargetStore:
- AsmigrationprocessisprocessedmostlyonTargetstore,itiscriticaltohaveafastmagentoserver.Recommendedserverconfiguration:4coresorhigher,4Gmemoryorhigher.
- Compilationshouldbeenabledtoimprovespeed(System>Tools>Compilation).- Cacheshouldbeenabledtoimprovespeed(System>CacheManagement).
MagentoMigrationTools:UserGuide Page9
5.EnterLicenseKeyLicenseKeyisanencodedstringwhichcomeswithyourdownloadpackage.Thiskeyisneededto
activateyourMigrationTool.
1.Afterpurchasingtheproduct,pleaselogintoourstoreandenter“Mydownloadableproducts”
section.Hereyouwillfinddownloadlinkandlicensekeyforthedownloadpackage.
2.LoginyourMagentoTargetStorebackend,selectCartMigration>Configuration,andcopyand
pasteyourlicensekeyhere:
MagentoMigrationTools:UserGuide Page10
6.MigrationPleaseloginyourMagentoTargetStorebackend,selectCartMigration>Migration
Themigrationwillgothrough3simplesteps.Justhit“Next”whenyoufinishonesteptoadvance.
Step1:SourceCartConfiguration
• CartType:selectcorrespondingsourcecarttype(osCommerce,ZenCart,VirtueMart,
WooCommerce,…..)
• CartUrl:sourcecartfullurl
• CartToken:thetokenstringwhichhasbeenconfiguredinconnector.php
MagentoMigrationTools:UserGuide Page11
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.
MagentoMigrationTools:UserGuide Page12
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.
MagentoMigrationTools:UserGuide Page13
• PreserveOrderIDsonTargetStore:thiswillhelpyoupreserveyouroldOrderIDsforeasier
reference
Step3:Migration
Themigrationwilltakeplaceautomaticallyinthisfinalstep.Inorderforittoprogress,youshould
notcloseyourbrowserofremoveSourceCartConnector.
Afterthemigrationiscompleted,clickon“ClearCacheandReIndexData”tofinish.Ifyoudon’twant
torunitrighthereoritreturnsfalseforanyreason,youcandothatmanuallyinSystem>Cache
ManagementandSystem>IndexManagement.
MagentoMigrationTools:UserGuide Page14
7.MigrationResumingWhenaproblemoccurringonthemigrationprocess,MagentoMigrationToolprovidestheabilityto
resumetheprocess:
1.Automaticallyresumeonthespot:thetoolwillautomaticallyresumeafterafailureuntilalldatais
imported.
2.Manuallyresume:youcanrefreshthepagetogobacktoStep1andclickon“Resume”,thisis
helpfulwhenyouwanttotemporarilystopmigrationandresumewhenyouwantto.
MagentoMigrationTools:UserGuide Page16
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.
MagentoMigrationTools:UserGuide Page17
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.
MagentoMigrationTools:UserGuide Page18
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.
MagentoMigrationTools:UserGuide Page19
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.
MagentoMigrationTools:UserGuide Page20
12.FrequentlyAskedQuestions1. Productimportstopspermanentlyatsomespecificpoint,howtoresolve?
Cause:phpexecutiontimetoolow
Solution:
• GotoCartMigrationConfiguration,changevalue“ProductsperBatch”toalowernumber
• Increaseyouserverphpmax_execution_timevalue
2. Atstep2,thetoolcannotreadmymappingdata?
MagentoMigrationTools:UserGuide Page21
Cause:migrationtoolcannotreadyoursourcestoredatabase
Solution:checkCartMigrationConfigurationandensureyouentercorrecttableprefixforyour
sourcedatabase
3. “Magentodatabaseisn'tworking”whenhittingNextonStep1?
Cause:therewasanissuewiththeinstallation,themodulecouldnotcreateitsadditionaltablesinto
Magentodatabase.
Solution:loginmysqladmin,runthisscript:
MagentoMigrationTools:UserGuide Page22
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.