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

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

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

Get the best out of
Magento 1  Magento 2

WHAT?
WHEN?
HOW?

WHAT
should we migrate?
© Ron Cogswell

Treat it like a platform
switch

Treat it like a platform
switch
because it is

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

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

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

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

Decide what you
really need to keep

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

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

Re-think your strategy and
goals

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

Stuff
you didn't implement in M1

New features in Magento 2

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

WHEN
shoud we migrate?
© David Lofink





Get your timeline right!

migration
current state
migration scope
timeline
budget

HOW
should we migrate?
© Peter Gronemann

MIGRATING CODE
3rd party code
Your code

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

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

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

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/

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

Official
code migration tool
 magento/code-migration

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

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>

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

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

Don‘t get confused

Configuration:
check what was
(not) converted

Dependencies
are not migrated(?)

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

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>

Generating mappings
yourself can be tricky

MIGRATING DATA
Core data
3rd party data
Your data

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

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

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

 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

Add mappings for custom
data and 3rd party
extensions

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

Massive tool
Team is working on it

Massive tool
Team is working on it
Schedule time

Backup database
after install

Make tool run through first,
then fix

Keep config files
outside migration tool repo

Divide config files

Extensions
can‘t plug in (yet)

Issues with long-living
stores

Examine deltas

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

1 Be pragmatic
2 Work together
3 Learn together

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

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

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

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

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

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/