Cleaning up assets with the same ID in Elvis 6

Info: This feature requires Elvis 6.8.1 or higher.

In rare cases it can be possible to have multiple assets with the same asset ID in the system.

Because an asset ID should be unique for each asset, this issue needs to be resolved. This can be done by moving duplicate assets to a dedicated folder and assigning a unique ID to each asset, or by removing the duplicate assets from the system.

Definition of 'duplicate'

The distinction between the original asset and any duplicate assets is made based on the assetModified field:

• The original asset is considered to be the asset with most recent assetModifed value.
• Duplicate assets are all other assets with the same asset ID as the asset that is considered to be the original asset.

Resolving assets with duplicate IDs

The process involves performing a scan to see if any assets with duplicate IDs exist, followed by separate steps to move these assets to a dedicated folder and assigning unique IDs, or to remove them from the system.

Note: The action of moving assets to a different folder and assigning unique IDs is not supported when the assets are stored on a S3 storage engine on Amazon AWS.

Scanning for assets with duplicate IDs

This will scan all indexes and shows an overview of all assets with same ID. No action on the assets themselves is taken.

Use the following POST API call:

<Elvis Server URL>/services/system/asset/cleanup?dryRun=true

Moving duplicate assets and assigning unique IDs

Note: This action is not supported when the assets are stored on a S3 storage engine on Amazon AWS.

This will move all assets with a duplicate ID to the following folder and assign a unique ID to each asset:

/Rescued/duplicates/<assetPath>

Use the following POST API call:

<Elvis Server URL>/services/system/asset/cleanup?dryRun=false

Removing duplicate assets

This will remove all duplicate assets from the system.

Use the following POST API call:

<Elvis Server URL>/services/system/asset/cleanup?dryRun=false&rescueDuplicates=false