acquia / acquia-migrate-accelerate
An enhanced UI and assistant for Drupal migrations. See https://www.acquia.com/drupal9/accelerate-your-migration.
Installs: 59 551
Dependents: 0
Suggesters: 0
Security: 0
Stars: 13
Watchers: 11
Forks: 3
Type:drupal-module
Requires
- acquia/drupal-environment-detector: ^1.2
- composer/semver: ^3.0
- drupal/core: ^9.0.6
- drupal/decoupled_pages: ^1.0
- drupal/migmag: ^1.3
- drupal/migrate_plus: ^5
- league/uri: ^6.3
- league/uri-components: ^2.2.1
Requires (Dev)
Conflicts
- drupal/migrate_tools: *
- 1.7.0
- 1.6.2
- 1.6.1
- 1.6.0
- 1.5.1
- 1.5.0
- 1.4.4
- 1.4.3
- 1.4.2
- 1.4.1
- 1.4.0
- 1.3.4
- 1.3.3
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.0
- 1.0.x-dev
- 1.0.8
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- 1.0.0-rc24
- 1.0.0-rc23
- 1.0.0-rc22
- 1.0.0-rc21
- 1.0.0-rc20
- 1.0.0-rc19
- 1.0.0-rc18
- 1.0.0-rc17
- 1.0.0-rc16
- 1.0.0-rc15
- 1.0.0-rc14
- 1.0.0-rc13
- 1.0.0-rc12
- 1.0.0-rc11
- 1.0.0-rc10
- 1.0.0-rc9
- 1.0.0-rc8
- 1.0.0-rc7
- 1.0.0-rc6
- 1.0.0-rc5
- 1.0.0-rc4
- 1.0.0-rc3
- 1.0.0-rc2
- 1.0.0-rc1
- 1.0.0-beta11
- 1.0.0-beta10
- 1.0.0-beta9
- 1.0.0-beta8
- 1.0.0-beta7
- 1.0.0-beta6
- 1.0.0-beta5
- 1.0.0-beta4
- 1.0.0-beta3
- 1.0.0-beta2
- 1.0.0-beta1
This package is auto-updated.
Last update: 2024-09-29 05:36:28 UTC
README
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.