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

22.


23.


24.
Get your timeline right!

25.
migration
current state
migration scope
timeline
budget

26.
HOW
should we migrate?
© Peter Gronemann

27.
MIGRATING CODE
3rd party code
Your code

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

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

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

31.
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/

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

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

34.
 <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

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

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

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

38.
Don‘t get confused

39.
Configuration:
check what was
(not) converted

40.
Dependencies
are not migrated(?)

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

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

43.
Generating mappings
yourself can be tricky

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

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

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

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

48.
 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

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

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

51.
Massive tool
Team is working on it

52.
Massive tool
Team is working on it
Schedule time

53.
Backup database
after install

54.
Make tool run through first,
then fix

55.
Keep config files
outside migration tool repo

56.
Divide config files

57.
Extensions
can‘t plug in (yet)

58.
Issues with long-living
stores

59.
Examine deltas

60.
 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)

61.
1 Be pragmatic
2 Work together
3 Learn together

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

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

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

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

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

67.
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/