A quickstart project for Drupal 8 migrations.
- Composer, Install Composer Globally
- A Drupal 7 Source site. (The site to be upgraded.)
- A Drupal 8 Target site. (The site to upgrade to.)
- Backup the Drupal 7 source site and setup a copy locally.
- Setup the Drupal 8 target site locally also.
- Note: Do not add any content or otherwise to the D8 site or it will be lost in the migration process.
Run the following command to install a Drupal 8 site with dependencies managed by Composer.
composer create-project drupal-composer/drupal-project:8.x-dev some-dir --no-interaction
Note: This composer create-project process will take several minutes to complete.
The following modules need to be enabled in order to perform a migration.
- Mirate
- Migrate Drupal
- Migrate Drupal UI
- Visit http://source7.local/upgrade and enter the Drupal 7 Source site's database connection settings.
- Run the upgrade migration check if the connection to the DB was successful.
- Check DB connection settings in settings.php on the Drupal 7 site if connection fails.
- See Known Issues below for DB issues inside container tools like DDEV.
- Database connection issues in DDEV.
- A VM seems to work much better for DB connection compatibility.