Skip to content

Migrate API

Migrate API

Uses the Drupal 8 Migrate API, which "provides services for migrating data from a source system to Drupal 8.

The "source system" can be almost anything:

  • an Islandora 7 system
  • a group of scanned images and their metadata inside a CSV file
  • a web API

Why use the Migrate API?

  • You can (potentially) do everything with configs!
  • Leverage contrib module plugins.
  • Making plugins for more complex sources and processes is (relatively) simple.
  • Updating metadata is as simple as: drush mim node --update

A Migration Configuration defines an Extract, Transform, Load (ETL) process

  • Source plugins extract data from a source
  • Process plugins transform the data
  • Destination plugins load the data (create new entities)

We’ve built two tools for you using the Migrate API

Recap of migrate_islandora_csv

  • CSVs
    • Everyone understands and knows how to work with CSVs
  • Documented
    • It’s a step-by-step walkthrough
  • Process Metadata
    • Clean up / transform the metadata using processors
  • Build Relationships
    • Migrations can reference other migrated content or generate new content on the fly

Recap of migrate_7x_claw

  • Designed to migrate Islandora 7 data to Islandora 8.
  • DATASTREAMS
    • All of your datasteams, including the audit trail, are migrated
  • METADATA
    • Migrate metadata from Solr or any XML datastream
  • CUSTOMIZABLE
    • Migrate_7x_claw is a starting point, meant to be tailored to your metadata
To make migrate_7x_claw work you need
  • Access
    • You need credentials to both your Islandora 7 and 8 installs.
  • Migrate API Knowledge
    • The tutorial for migrate_islandora_csv Is still relevant
  • Config Sync
    • You need to understand Drupal config synchronization. Features knowledge helps too.
  • Command Line Skills
    • This is best done with shell access and drush

Migrate API demo video

Check out this video that demonstrates the Drupal Migrate API migration process: Islandora Webinar: Migrating from Islandora 7 to Islandora 8 (Nov 21, 2019)


Last update: August 11, 2021