The Media: Acquia DAM (Widen) to Acquia DAM (Widen) migration tool lets you transfer media types within the Drupal application.

Features

The tool offers several key features and capabilities:

• Transfers media types with associated assets efficiently between different modules.
• Preserves site and user authentication during the migration of digital assets and associated metadata.
• Integrates key features such as embed and download options with no disruption to ongoing workflows.
• Enhances platform capabilities and functionalities, which enables users to migrate media types to Acquia DAM (Widen) with no effect on the media system.
• Provides the flexibility to uninstall the media_acquiadam module.

Scope of migration

The migration covers:

• Transition of integration from the media_acquiadam

The Media: Acquia DAM (Widen) to Acquia DAM (Widen) migration tool lets you transfer media types within the Drupal application.

Features

The tool offers several key features and capabilities:

• Transfers media types with associated assets efficiently between different modules.
• Preserves site and user authentication during the migration of digital assets and associated metadata.
• Integrates key features such as embed and download options with no disruption to ongoing workflows.
• Enhances platform capabilities and functionalities, which enables users to migrate media types to Acquia DAM (Widen) with no effect on the media system.
• Provides the flexibility to uninstall the media_acquiadam module.

Scope of migration

The migration covers:

• Transition of integration from the media_acquiadam module to the acquia_dam module.
• Migration of all media assets, such as images, videos, and PDFs, along with associated metadata.
• Configuration of the Media Library and Acquia DAM (Widen) integration features.

Important considerations

Be aware of the following changes in the new module:

• Entity Browser support has been discontinued, use the Media Library instead.
• Copy-paste of asset_id in the media add form is not supported in Acquia DAM (Widen), use the Media Library instead.

Pre-migration requirements

Before you start the migration process, do the following:

1. Complete a full backup of your Drupal site's database and file system.
2. Verify your administrative permissions to access the migration dashboard.
3. Confirm your permissions to update modules in Drupal.
4. Uninstall the Media: Acquia DAM (Widen) - Reporting module, as this reporting functionality is not currently supported in the new Acquia DAM (Widen) module.

Steps to migrate

If your system already uses the latest version of the media_acquiadam module (2.1.x) and acquia_dam version 1.1.5 or newer, and you have previously performed the database update, you may skip the version upgrade and database update.

Upgrade to the latest version (2.1.x): 

Upgrade the module with Composer or through the Drupal UI.

composer require drupal/media_acquiadam:^2.1

Run database update: 

You must run the database update to apply necessary database schema changes and configuration updates. This step ensures that the new version of the Media Acquia DAM (Widen) module functions correctly. Use the drush updb -y command or navigate to the /update.php page in your Drupal installation. This process also enables the media_acquiadam module.

Use the migration dashboard to perform migration

After the upgrade and database update steps are completed, navigate to the migration path /admin/config/acquia-dam/migration within the Drupal user interface. This leads to the Migration Dashboard, which provides a clear overview of the migration status.
A 3-step wizard guides you through the migration process to ensure a smooth and structured migration experience.

1. Media Source Selection
2. Media Type Selection
3. Pre-Migration Review

You can progress through the steps sequentially, with options to review, confirm, and proceed at your own pace.

Media source selection

This dashboard helps you migrate legacy media types to Acquia DAM (Widen). It provides a map between media_acquiadam media types to their corresponding media sources in Acquia DAM (Widen).
The table displays the media types, the total number of media items, the display handler for media assets, and the target media source that requires migration. This dashboard enables you to track the progress and completion of the migration.

The details of each column are:

• Media type label and name: You may change the label during the migration to the Acquia DAM (Widen) system.
• Number of media items: Count of DAM assets in each media type that requires migration.
• Method to handle media files: Two methods are provided:
  • Sync: This method renders assets locally.
  • Embed: This method renders assets from the Widen CDN. 

Target source type: You receive a list of Acquia DAM (Widen) media sources. You must select the target source for asset migration.

Media type selection

This page displays a list of new media types from the Acquia DAM (Widen) module. Select the checkbox on the same row as any media type that you do not want to keep. You must indicate if you want to keep the suggested media types. Select them for deletion if they are not required.

Pre-migration review

After you review and confirm the media types selected for deletion, click Save & Next to move to the final step. This action takes you to the pre-migration report, which provides a summary of the current status before the migration begins.

Migration interfaces

After the configuration is saved, migration can be performed through either of the following:

• Admin user interface
• Command-line interface

Through the Admin user interface

Verify the data and click Migrate to begin the migration process. The assets migrate in batches. A progress bar displays the status of the migration in real time.

At the end of the process, the system displays a migration summary. This summary provides a detailed overview of the media items successfully migrated, categorized by each media type.

Through the command-line interface

After you click Save on the last page of the migration dashboard, you can choose to do the asset migration with the Drush command:

drush acquiadam:migrate

Validate migration

After the migration, ensure that:

• All media types and associated assets are transferred and visible in the Acquia DAM (Widen) Library at /admin/content/media.
• Metadata, files, and references remain intact in the content.
• Duplicate media types are deleted from the system.

Asset data migration 

To finalize the asset data migration, complete the following steps:

1. Migrate asset data with the following Drush command:

   copy

   drush acquiadam:migrate-data

2. Clear the Drupal cache to ensure that the site reflects all changes.

Post migration 

To finalize the migration process, complete the following steps:

1. If you use the Acquia DAM (Widen) Asset Importer module, switch to the Acquia DAM (Widen) Bulk Asset Import submodule. To migrate the configuration from the Acquia DAM (Widen) Asset Importer contributed module to the Acquia DAM (Widen) Bulk Asset Import submodule, complete the following steps:

   1. Remove the Acquia DAM (Widen) Asset Importer contributed module with the following Composer command:  

      copy

      composer remove drupal/acquiadam_asset_import

   2. Run database updates to ensure that the system applies necessary database schema changes and configuration updates for the Acquia DAM (Widen) Bulk Asset Import submodule with the following Drush command:

      copy

      drush updb

   3. Clear the cache.

2. Ensure that permissions for content editors and administrators work as expected.
3. After you ensure that the integration works:

   1. Remove unnecessary legacy fields with the following Drush command:

      copy

      drush acquiadam:post-migrate

   2. Clear the Drupal cache to ensure that the site reflects all changes.
   3. Uninstall the module.

Asset update and synchronization

To synchronize the asset after data migration, complete the following steps:

1. All assets are missing both the version_id and external_id, meaning the assets are out of sync. To make all assets in sync, complete the following steps:

   1. For assets that do not have version_id or external_id, run the following Drush command separately for each media type:

      copy

      drush acquia-dam:update-assets --media-type=<media_type_id>

   2. Ensure that the asset update queue: acquia_dam_media_item_update is empty before you upload or retrieve media with the Drush command:

      copy

      drush queue:list

   3. If the queue is not empty, process the asset update queue to fetch the version_id and external_id of the asset from Acquia DAM (Widen) with the Drush command:

      copy

      drush queue:run acquia_dam_media_item_update

   4. After the update, clear the Drupal cache to ensure that the system reflects the changes:

      copy

      drush cr

2. If you selected the Sync option during Media Type Migration, you may optionally complete the following steps to download assets into the dam directory. If skipped, assets are served from the legacy acquiadam directory.

   1. To ensure that assets are correctly located after migration, run the following Drush command for each migrated media type:

      copy

      drush acquia-dam:download-assets <media_type_id> --redownload

   2. After the update, clear the Drupal cache to ensure that the system reflects the changes:

      copy

      drush cr

3. Ensure that the Acquia DAM (Widen) integration works correctly. Test media uploads, retrievals, and rendering within the content of the site.