https://github.com/acquia/acquia-migrate-accelerate
An enhanced UI and assistant for Drupal migrations.
https://github.com/acquia/acquia-migrate-accelerate
Last synced: 12 days ago
JSON representation
An enhanced UI and assistant for Drupal migrations.
- Host: GitHub
- URL: https://github.com/acquia/acquia-migrate-accelerate
- Owner: acquia
- License: other
- Created: 2020-07-09T13:34:08.000Z (almost 5 years ago)
- Default Branch: 1.0.x
- Last Pushed: 2023-06-12T12:55:06.000Z (almost 2 years ago)
- Last Synced: 2025-04-12T03:38:21.538Z (15 days ago)
- Language: PHP
- Homepage: https://www.acquia.com/drupal9/accelerate-your-migration
- Size: 1.48 MB
- Stars: 13
- Watchers: 10
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Acquia Migrate Accelerate
## What's this then?
This is a Drupal 9 module that provides a set of tools for accelerating a Drupal 7 → Drupal 9 migration.
### Features:
- Provides a React-based UI for performing Drupal 7 → 9 migrations
- Migration Dashboard provides an overview of overall data migration progress
- Supports Import/Rollback/Rollback and Import of migrations
- Is smart about dependencies: dependencies must be imported first
- Preview displays incoming content prior to importing
- Messages pane allows viewing/filtering migration messages
- Catches entity validation errors in addition to migration errors
- and so much more! 😊
## Specifying source database and files
Note: This step will no longer be required once the environment is generated from Acquia Cloud.
You only need to set the private file path if applicable.
Open your Drupal 9 site's `sites/default/settings.php`, create a new `$databases['migrate']` entry (the key must be named `migrate`!), and specify the Drupal 7 source database. Also specify the **base path** for your Drupal 7 site (so that `sites/default/files` is a subdirectory). Like so:
```
$databases['migrate']['default'] = array (
'database' => 'my_d7_site_database',
'username' => 'root',
'password' => 'root',
'prefix' => '',
'host' => 'localhost',
'port' => '3306',
'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql',
'driver' => 'mysql',
);
// The directory specified here must contain the directory specified in the
// "file_public_path" Drupal 7 variable. Usually: "sites/default/files".
$settings['migrate_source_base_path'] = '/web/vhosts/my-d7-site.com';
// The directory specified here must contain the directory specified in the
// "file_private_path" Drupal 7 variable. Usually outside the web root.
$settings['migrate_source_private_file_path'] = '/somewhere/private';
```
## Troubleshooting
### I go to `/acquia-migrate-accelerate/migrations` I get "An unrecognized error occurred." What gives?!
This is normally caused by Drupal issuing a 500 error. Go to `/admin/reports/dblog` and see if that holds any clues. Another common troubleshooting step is to clear the cache. (Navigate to `/admin/config/development/performance` or run `drush cr`)
### I'm getting a ton of "can't find files" errors when attempting to migrate Public files. HALP!
Remember that public files need the _base_ path to the files directory (in other words, the _parent_ directory of where the `/files` path resides), not the files directory itself.
### I found something not listed here, or I have other feedback!
Please file a Zendesk ticket against the 'Beta Programs' ticket type.
## License
Use of _Acquia Migrate Accelerate_ is subject to the terms in the included `LICENSE.txt` and the included Subscription and Services Agreement.