The document discusses migrating from Magento 1 to Magento 2. It recommends treating the migration as a platform switch rather than a 1:1 copy, deciding what data to keep, and rethinking strategies and goals. It also covers using the official migration tools to migrate code, data, and settings in a multi-step process, and highlights some common challenges like mapping customizations and third-party extensions.

1. Migrating
from Magento 1
to Magento 2
Matthias Zeis
2016-05-13

2. Vienna, Austria
mzeis
mzeis
mzeis
matthias-zeis.com

3. SCENARIO
Merchant wants to migrate
from M1 to M2
© Rebecca Slegel

4. Get the best out of
Magento 1  Magento 2

5. WHAT?
WHEN?
HOW?

6. WHAT
should we migrate?
© Ron Cogswell

7. Treat it like a platform
switch

8. Treat it like a platform
switch
because it is

9. migration scope
no 1:1 copy
streamline
strategy and goals
new features

10. migration scope
no 1:1 copy
streamline
strategy and goals
new features

11. Don't build a 1:1 copy of your
current store

12. migration scope
no 1:1 copy
streamline
strategy and goals
new features

13. Decide what you
really need to keep

14. Decide what you
really need to keep
Don‘t forget
your data!

15. migration scope
no 1:1 copy
streamline
strategy and goals
new features

16. Re-think your strategy and
goals

17. migration scope
no 1:1 copy
streamline
strategy and goals
new features

18. Stuff
you didn't implement in M1

19. New features in Magento 2

20. migration scope
no 1:1 copy
streamline
strategy and goals
new features

21. WHEN
shoud we migrate?
© David Lofink

23. 

24. 

28. Get your timeline right!

29. migration
current state
migration scope
timeline
budget

30. HOW
should we migrate?
© Peter Gronemann

31. MIGRATING CODE
3rd party code
Your code

32. 3rd party
functionality
DELETE
needed
in new store?
missing
in M2 core?
USE
M2 CORE
continue
with vendor?
other 3rd party
or custom?
M2 extension
available?
OTHER
3RD PARTY
DO IT
YOURSELF
USE M2
EXTENSION
no no
3rd party custom
yes yes yes yes
no no

33. Your M1
functionality
DELETE
needed
in new store?
missing
in M2 core?
USE
M2 CORE
3rd party
or custom?
3RD PARTY
DO IT
YOURSELF
no no 3rd party custom
yes yes

34. rewrite extension
automated testing
document
M1 behaviour
platform
independent code
coding standards

35. rewrite extension
automated testing
document
M1 behaviour
platform
independent code
coding standards
Awesome integer_net article series:
https://www.integer-net.com/magento-
1-magento-2-shared-code-extensions/

36. migrate extension
clean M1 code
document
M1 behaviour
platform
independent code
refactor

37. Official
code migration tool
 magento/code-migration

38.  <src> Code to be migrated (excluding core)
 Prerequisites
 <m1> M1 project code including vanilla core
 <m2> M2 vanilla core
 <dst> Empty directory for generated code

39. 1 Migrate directory structure
php bin/migrate.php migrateModuleStructure <src> <dst>
2 Migrate layout
php bin/migrate.php convertLayout <dst>
3 Migrate configuration
php bin/migrate.php convertConfig <dst>
4 Migrate PHP code
php bin/migrate.php convertPhpCode <dst> <m1> <m2>

40.  Does
 Namespaces
 Configuration XML files
 Layout XML files
 Magento code interaction
 Module directory structure

41.  Does  Doesn‘t
 Namespaces
 Configuration XML files
 Layout XML files
 Magento code interaction
 Module directory structure
 Template files & design
 Changes in business logic

42. Don‘t get confused

44. Configuration:
check what was
(not) converted

45. Dependencies
are not migrated(?)

46. USE
OUT OF THE BOX
MAPPING
Is your Magento 1 version
current?
noyes GENERATE
YOUR OWN
MAPPING

47. 1 php bin/utils.php generateClassDependency <m1>
2 php bin/utils.php generateClassMapping <m1> <m2>
3 php bin/utils.php generateModuleMapping <m1> <m2>
4 php bin/utils.php generateTableNamesMapping <m1>
5 php bin/utils.php generateViewMapping <m1> <m2>
6 php bin/migrate.php generateAliasMapping <m1> <m2>
7 php bin/migrate.php generateAliasMappingEE <m1> <m2>

48. Generating mappings
yourself can be tricky

49. MIGRATING DATA
Core data
3rd party data
Your data

50. Official
data migration tool
 magento/data-migration-tool

51. 1 Migrate settings
php bin/magento migrate:settings /path/to/config.xml
2 Migrate data
php bin/magento migrate:data /path/to/config.xml
3 Migrate delta
php bin/magento migrate:delta /path/to/config.xml

52.  Does
 Products & categories
 Orders & invoices
 Shipments & credit memos
 Core configuration
 Customers
 Wishlists & ratings

53.  Does  Doesn‘t
 Products & categories
 Orders & invoices
 Shipments & credit memos
 Core configuration
 Customers
 Catalog DB layout updates
 Web API credentials
 Wishlists & ratings
 Admin users & privileges
 Media files
 Custom data
 3rd party data

54. Add mappings for custom
data and 3rd party
extensions

55. A FEW LEARNINGS
(a.k.a. what bit me)

56. Massive tool
Team is working on it

57. Massive tool
Team is working on it
Schedule time

58. Backup database
after install

59. Make tool run through first,
then fix

61. Keep config files
outside migration tool repo

62. Divide config files

63. Extensions
can‘t plug in (yet)

64. Issues with long-living
stores

65. Examine deltas

66.  Alternatives
 ubertheme/module-ubdatamigration
Alternative to official data migration tool
 firegento/FireGento_FastSimpleImport2
Wrapper for Magento 2 ImportExport functionality
 firegento/FireGento_ExtendedImport2
Extended features for Import (ported from AvS_FastSimpleImport)

67. 1 Be pragmatic
2 Work together
3 Learn together

68. Imagine 2016 migration tool presentation by Sergii Shymko
http://imagine.magento.com/sites/default/files/Mon.Margaux1.1
630.SS7%2C8.Technical.pdf
Migration diary by Max Pronko
http://www.maxpronko.com/story
 Resources

69. Official data migration guide
http://devdocs.magento.com/guides/v2.0/migration/bk-
migration-guide.html
Data migration experience by Marcin Szterling (English, Youtube)
Marcin Szterling - Data Migration from Magento 1 to Magento 2
 Resources

70. Data migration experience by Sven Wappler (German)
https://www.wapplersystems.de/blog/slides-zum-vortrag-
magento-002-migriere-an-einem-anderen-tag-sind-online/
Data migration experience by Eugen Bogdanovich (English)
http://oyenetwork.com/articles/data-migration-to-magento2-
case-study/
 Resources

71. Matthias Zeis
mzeis
mzeis
mzeis
matthias-zeis.com
Thank you! Questions?

72. Matthias Zeis
mzeis
mzeis
mzeis
matthias-zeis.com
Thank you! Questions?
Slides will be online:
http://www.slideshare.net/mzeis/

73. Matthias Zeis
mzeis
mzeis
mzeis
matthias-zeis.com
Thank you! Questions?
Slides will be online:
http://www.slideshare.net/mzeis/
LimeSoda is hiring!
https://www.limesoda.com/jobs/