How does MigrationWiz prevent duplicates?
MigrationWiz uses a system of watermarks to track items that have previously been migrated. There are a number of advantages to using watermarks instead of detecting items by their names, titles, or other properties.
How are watermarks created and stored for later use?
As items are migrated, a small watermark is embedded in the header of each item, allowing us to track it once it resides in the Destination. This watermark also specifies certain information, such as the endpoint type specified in MigrationWiz.
At the same time, we place a matching watermark in one of our databases. We do not store any content data from the item, only the watermark data. Our database holds the items that have been migrated, and prevents items from being remigrated if they are deleted by users at the Destination.
Because we track watermarks in two different places, there is a double layer of protection against the creation of duplicates.
How does MigrationWiz use these watermarks during delta passes?
When a Delta Migration begins, we scan the Destination for watermarks so we will know what data has been migrated. We will also scan our watermark database to prevent remigration of items that were deleted or moved at the Destination, between passes. This scanning process occurs at the beginning of every Delta pass. The larger the quantity of data migrated, the longer this process will take. For example, a migration that previously transferred 20GB of data will generally take longer to scan for watermarks than a migration with 20MB transferred.
We do not migrate watermarked items a second time. Only items found without a watermark will be migrated.
What happens to items at the Source?
We do not modify any data at the Source, including watermarks.
How do I delete these watermarks?
If a user manually deletes a migrated item from the Destination, we will not migrate this item because we still track it on the back end.
To delete our end of the watermarks database, simply checkmark the box next to the migration you want to do this for, and click the circular Reset Items button on the toolbar at the top of the user list. This will only clear our end of the database.
If you would like to delete watermarks stored at the Destination, you will need to delete the items themselves, as the watermarks are embedded in the item headers. This is typically only done when choosing to restart your migration from scratch, a process known as "unmigrating". Deleting items at the Destination will only clear the Destination watermarks. Unless you reset watermarks on our end, items deleted from the Destination will not be remigrated.
You can learn more about resetting items by reviewing our Knowledge Base article about removing items and resetting statistics.
What else should I be aware of?
Because we use proprietary watermarks that are specific to our system, we will not be able to detect items migrated by other means. For example, items forwarded from the Source to the Destination -- and items migrated by other solutions -- will not contain our watermarks. Therefore, we have no knowledge of them existing at the Destination. As a result, we will migrate these items even if they are already at the Destination.
Since we store the endpoint type in the watermark, changing the Source or Destination endpoint type in between passes will effectively void the watermark, and all items will be migrated again. If this happens, we will generate a new watermark in each item, based on the new Source or Destination endpoint type.
If an item at the Source is moved in between passes, we will not be able to match the Source item with its Destination counterpart, so the item will be migrated a second time. It will then exist in each location, in its original location and also in its new location.