This document outlines the migration process to Drupal 8, highlighting the definitions, challenges, and tools required for both simple and complex projects. It explains the Migrate API, its core modules, and various contributed modules that facilitate the migration of content from Drupal 7 to Drupal 8. Additionally, it discusses common migration issues and limitations such as unsupported migrations for views and multilingual content.

1. Simplifying Migration to
Drupal 8
Sugandh Khanna | Drupal Developer, Srijan Technologies |
@sugandhkhanna92
#SrijanWW | @srijan

2. Simplifying Migrations to Drupal 8

3. Presentation Outline

4. #SrijanWW | @srijan

5. #SrijanWW | @srijan
Definition of Migration:
● Dictionary meaning: Movement
from one part of something to
another.
● In Drupal way: Migration is an
Extract, Transform, Load(ETL)
process.
● Flexible services and innovative
solutions at effective pricing

6. #SrijanWW | @srijan
Earlier approach of Migrations:
● Huge Sites
● Time consuming
● More than 100 content types and 2000
fields.

7. #SrijanWW | @srijan

8. #SrijanWW | @srijan
Can we suggest Drupal 8 right
away:
● for an existing SIMPLE project? -YES-
● for an existing COMPLEX project? -NO-
● for an NEW project? -YES-

9. #SrijanWW | @srijan
Why Migrate
API?
The migrate module provides a
flexible framework for migrating
content into Drupal from other
sources (e.g., when converting a
website from another CMS to
Drupal).
Out-of-the-box, support for creating
core Drupal objects such as nodes,
users, files, terms, and comments are
also included - it can easily be
extended for migrating other types
of content. Content is imported and
rolled back using a bundled web
interface (Migrate UI module) or
included Drush commands.

10. #SrijanWW | @srijan
Migrate API
Drupal 8 is shipped with 2 CORE Modules that provides API for
Migration
● migrate: This Drupal core module provides the underlying API
for migrating configuration and content to Drupal 8.
● migrate_drupal: This Drupal core module provides the classes
specifically needed to migrate configuration and content from a
Drupal site to Drupal 8.

11. #SrijanWW | @srijan

12. #SrijanWW | @srijan
Migration-Related Contributed Modules
● migrate_upgrade: The Drupal Upgrade contributed module provides the
tools necessary for performing an upgrade from Drupal 7 to drupal 8 --
both a simple user interface as well as drush commands.
● migrate_plus: The Migrate Plus contributed module provides optional
enhancements, including groups and prepareRow events, to the core
Migrate API.
● migrate_tools: Part of the Migrate Plus project, this module provides
optional drush and UI tools for managing your migrations.

13. #SrijanWW | @srijan

14. #SrijanWW | @srijan
Migrating Configurations
Via DrushVia migrate upgrade module UI

15. #SrijanWW | @srijan
Executing a Migration

16. #SrijanWW | @srijan
Executing a Drupal 7 to Drupal 8 migrate Prerequisites:
● PHP5.6 or greater.
● Install Drush 8.x
● A Drupal 7 site database (Source should be localised).
● The very latest version of Drupal 8.
● Having the Migrate Upgrade module downloaded and enabled,
which will turn on all the various dependencies (migrate_upgrade,
migrate_drupal, migrate).
● Write permissions for Drush to the config directory. Example sudo
chmod -R a+w sites/default/files/config__*/active

17. #SrijanWW | @srijan

18. #SrijanWW | @srijan
Migration Process

19. #SrijanWW | @srijan
$databases['legacy']['default'] = array (
'database' => 'd7database',
'username' => 'root',
'password' => 'root',
'prefix' => '',
'host' => 'localhost',
'port' => '3306',
'namespace' => 'DrupalCoreDatabaseDrivermysql',
'driver' => 'mysql',
);
Legacy: connecting to the source database (D7)

20. #SrijanWW | @srijan
Magic Drush command
drush migrate-upgrade
--legacy-db-url=mysql://user:pass@12.34.56.78/d6db
--legacy-root=http://myd6site.com
Legacy being the keyword to connect both databases. (explain further in next slide.)
Your database user
name
Your database
password
Your drupal 7
database

21. #SrijanWW | @srijan
.
drush migrate-upgrade --configure-only
--legacy-db-url=mysql://root:root@localhost/database7
--legacy-root=/path/to/sites/default/files
Generate migration configuration entities
Final touch...

22. #SrijanWW | @srijan
If you run drush migrate-status(ms), a hug list of migrations
will appear.
You can review then selectively execute the migrations by
using the following drush commands
#1 drush migrate-import {migrationname}
#2 drush migrate-import --all

23. #SrijanWW | @srijan
Migrate Tools
Drush commands supported include:
● migrate-status - Lists migrations and their status.
● migrate-import - Performs import operations.
● migrate-rollback - Performs rollback operations.
● migrate-stop - Cleanly stops a running operation.
● migrate-reset-status - Sets a migration status to Idle if it gets stuck.
● migrate-messages - Lists any messages associated with a migration import.

24. #SrijanWW | @srijan
Migrations that are not yet
supported:
● Views
● Multilingual content
● custom fields and content types
Migrations that supported:
● Only content, users, taxonomy, blocks,
menus, filter formats.

25. #SrijanWW | @srijan
Known Issues with the Drupal 7 -> 8:
● Blocked IPs: The id column from Drupal 7's ban_ip_table is not
migrated.
● Menu UI: The menu_primary_links_source and
menu_secondary_links_source variables not migrated, because they
do not have counterparts in drupal 8.
● PHP code: It will be replaced with filter_null, which simply displays an
empty string. PHP code is not supported in Drupal 8 core -- it's very
bad practice.
● Views: Views are not yet migrated.

26. #SrijanWW | @srijan
Any Questions?