This presentation discusses content migration from Drupal 7 to Drupal 8 using various tools. It covers performing a one-click upgrade via the web interface as well as customizing migrations using the Migrate and Migrate Plus modules. The presentation demonstrates migrating content types, fields, users, menus and other site elements. It addresses limitations of the standard upgrade process and provides options for customizing migrations to handle additional needs.

2. Site Building Track
Case Study :: Work in Progress
https://events.drupal.org/nashville2018/sessions/one-click-upgrade-drupal-8-how-why-and-when
Irina Zaks
irina.zaks@fibonacciwebstudio.com
Content Migration into Drupal 8
with One Click Ease
for Site Builders

3. About me
• https://www.drupal.org/u/irinaz
• https://opensource.stanford.edu/
• http://fibonacciwebstudio.com/about-us

4. In this presentation
We will talk about
Content Migration Tools
● Drupal Upgrade via web interface
● Using Migrate module
● Using drush for migrations
● Customizing migration paths
We will not present today
● Views upgrades
● Theme upgrades
● Functionality upgrades
● Composer
● Drupal Console
● Configuration Split
● All great new things in Drupal 8
● World Peace
● .... and many more

5. WARNING!
● This demo uses dev tools
● Things might and will break
● Interface and features can and
will change without notification
STAY CALM and
DRUPAL ON

6. WHY DO WE NEED TO MIGRATE CONTENT

7. Website supports your organization
o Websites change, grow, shrink as do organizations that these sites
support
o Websites change with technology and fashion
o Website’s average lifetime is 4-5 years

8. Why do you change your website
1. Our organization has changed and website needs to reflect it
2. We want new fresh feel and look
3. Our site needs to be mobile friendly
4. Our site is very difficult to manage
5. Everyone is on Drupal 8 now
6. Drupal 7 will not have security updates
WE GOT BUDGET – LET’s BEGIN!

9. What to migrate - Review
o Information architecture
○ Data models
○ Relationships
o Content – pages, images, documents
o Designs
○ Index pages
○ Pages layout
o Editor’s UX and UI
o Functionality and workflows
Document your
findings

10. What to migrate - Decide
o What do you want to keep
o What do you want to delete
o What do you want to change
o What do you want to add
if (enough content to keep)
{ Migration }
else
{ Build new website }

11. Ready for
Moving

12. Example website migration
Problems to solve
o Non-responsive theme
o Poor experience for content
managers
Keep good stuff
o Well defined content types
and relationships
o Good content, images, video

13. Simple Tools for Everyone

15. Brief history of Drupal migrations
o Upgrades between major versions of Drupal was a major undertaking
before Drupal 8
o My Drupal migration journey started with moving 4.7 to D6
o Upgrade in D8 was one of the most pleasant surprises

16. 4.7 to 5 to 6 - Always an adventure
Early Migrate module, SQL scripts

17. 6 to 7 - Routine exercise
Migrate / Feeds Modules

18. 6 to 7 - Routine exercise
Tools and Features
o Feeds or Migrate
o Unlimited import
o Rollback / Reimport
Process
o Set up new Drupal 7 site
o Create content types in D7
o Set data export in D6
o Set data import in D7

19. 6/7 to 8
Pleasant walk in the park

20. D8 upgrade
NEW - D7 to D8
o Set up new Drupal 8 site
o Create content types
o Set data export
o Set data import
o Click Upgrade or run Migrate
OLD - D6 to D7
o Set up new Drupal 7 site
o Create content types in D7
o Set data export in D6
o Set data import in D7

21. Two ways to upgrade
“One-click “ upgrade via
web interface
Configuration >
Development-> /upgrade
Set up migrations via
drush and manage in
Migrations tab
Structure-> Migrations
/admin/structure/migrate

22. GETTING READY
OLD SITE REVIEW, NEW SITE SETUP

23. Source D7 site - Review
o Person content type with various
fields
○ Text
○ Date
○ Entity reference
○ Image, etc.

24. Source D7 site - Review
o Page layout / display
o Image styles
o URL’s – aliases, patterns
o Views
o Menu
o Front page

25. DevOps
Thanks to Pantheon for providing all tools
o Dev / test / multidev instances
o Backups
o Db / files export/import
o Drush

26. Destination - New site D8
o Setup new blank Drupal 8 site
http://dev-drupal-8-content-migration.pantheonsite.io/
o Many major modules are now in core
○ Views
○ Path

27. Destination - New site D8
o Add “your” basic set of modules
1. Admin Toolbar (replaces Admin Menu)
2. Pathauto (requires token and ctools)
3. Devel
4. Ctools
5. Token
6. Diff

28. MIGRATION DEMO

29. Enable Migration modules
o Core
○ Migrate
○ Migrate Drupal
○ Migrate Drupal UI
o Good Admin experience
○ Admin menu for convenience of all operations
○ Pathauto to ensure migration of aliases if needed

30. Start Upgrade

31. Connect to Source site db
●Db
●User
●Password
●port
●File path

32. Use Clean Instance
o If you have added users, theme logo, any content, before migration you
will see conflict message

33. List of default migration paths
o ## available upgrade paths
○ core modules
o ## missing upgrade paths
○ contrib modules
○ custom modules
○ other features
o Continue

34. Demo – Recent Log messages
admin/reports/dblog?page=1

35. Drupal is setting your Migration
o Creates content types / fields even if there are no nodes of this content
type
o Creates users and roles
○ User id’s and roles are preserved
o Reports every step of upgrade in a log

36. Content import
o Content imported – nid’s are preserved
o Url aliases but not pathauto patterns
o Menu items – set in menus, not views
o Not found or access denied links go to front page by default

37. Limitations of standard upgrade
o One time migration – no rollback (we used Pantheon Backups)
○ Reimport entire source site if content has been updated
○ New features coming… https://www.drupal.org/project/drupal/issues/2687849
o Fields Content imported, not display and form display
o Field collections do not have upgrade path
o “Plain HTML” format does exist in D8, new format created during
migration

38. Dealing with limitations
o We are discovering other issues as we do more migrations
o Solutions
○ Write custom script to solve each issue
○ Develop features missing in D8 now and commit to drupal.org

39. ENTERS DRUSH

40. Custom updates with drush
o Add modules
○ Drupal Upgrade
○ Migrate Tools
○ Migrate Plus
○ Migrate Manifest

41. Creating Migration
o drush migrate-upgrade [options] – config-only (does not move content)
o drush @pantheon.your-site.dev --strict=0 migrate-upgrade --legacy-db-
url=mysql://dbusername:dbpasswordhere@mysql-
user.stanford.edu/dbname

42. Web interface for Migration
o “Execute” button added to web UI in February, get dev versions here
o https://www.drupal.org/node/2202391/git-instructions/8.x-
4.x/nonmaintainer
o https://www.drupal.org/node/2609548/git-instructions/8.x-
4.x/nonmaintainer

43. Web interface for Migration
o Migration tab
○ /admin/structure/migrate
o Migration group
○ /admin/structure/migrate/manage/group_name/migrations
o Specific migration
○ /admin/structure/migrate/manage/group_name/migrations/upgrade_d7_node_stanfor
d_person/execute

44. Migrate Options
o Import
o Rollback
o Stop
o Reset

45. CUSTOMIZING MIGRATIONS

46. Migrate Manifest
o Standard manifest installed with Migrate Manifest Module in root
directory /manifest.yml
o Intercept standard upgrade and launch custom manifest(s)
○ /manifest2.yml
○ /manifest-news.yml
○ /manifest-date.yml

47. Custom Migrations
Field Format – work in progress
Drupal 7 – text field Drupal 8 – new field

48. FEEDS + MIGRATE?

49. Current status of Feeds Module
o .csv import is working
o .xml import is about to be released
o Tamper UI is working
o Demo (if there is time)
o Join discussion Feeds weekly meetup
https://drupal.slack.com/messages/C34CECZAL/details/ every Thursday
11 am PST

50. Feeds UI with Migrate back end?
o Join us at Sprints on Thursday at 11 am (on the first floor in Sprint
Lounge, room 104A)
o Join discussion at
https://drupal.slack.com/messages/C34CECZAL/details/ every Thursday
1 pm Nashville time, 11 am PST

51. Summary – Tools for Moving Content
o One time full migration via Update
○ One instance of D6/7 to clean D8
o Ongoing updates from Drupal 7 to Drupal 8 sites via Migrate Tools+Plus
o Migration customization using Migrate Manifest
o Feeds
○ Import from various sources

53. Experience is
something you don’t
get until just after you
need it
Steven Wright / Internet
“ “

54. Join us for
contribution sprints
Friday, April 13, 2018
9:00-12:00
Room: Stolz 2
Mentored
Core sprint
First time
sprinter workshop
General
sprint
#drupalsprint
9:00-12:00
Room: Stolz 2
9:00-12:00
Room: Stolz 2

55. What did you think?
Locate this session at the DrupalCon Nashville website:
https://events.drupal.org/nashville2018/sessions/one-click-upgrade-
drupal-8-how-why-and-when
Take the Survey!
https://www.surveymonkey.com/r/nashiville