• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
  • Skip to footer
TSB Alfresco Cobrand White tagline

Technology Services Group

  • Home
  • Products
    • Alfresco Enterprise Viewer
    • OpenContent Search
    • OpenContent Case
    • OpenContent Forms
    • OpenMigrate
    • OpenContent Web Services
    • OpenCapture
    • OpenOverlay
  • Solutions
    • Alfresco Content Accelerator for Claims Management
      • Claims Demo Series
    • Alfresco Content Accelerator for Policy & Procedure Management
      • Compliance Demo Series
    • OpenContent Accounts Payable
    • OpenContent Contract Management
    • OpenContent Batch Records
    • OpenContent Government
    • OpenContent Corporate Forms
    • OpenContent Construction Management
    • OpenContent Digital Archive
    • OpenContent Human Resources
    • OpenContent Patient Records
  • Platforms
    • Alfresco Consulting
      • Alfresco Case Study – Canadian Museum of Human Rights
      • Alfresco Case Study – New York Philharmonic
      • Alfresco Case Study – New York Property Insurance Underwriting Association
      • Alfresco Case Study – American Society for Clinical Pathology
      • Alfresco Case Study – American Association of Insurance Services
      • Alfresco Case Study – United Cerebral Palsy
    • HBase
    • DynamoDB
    • OpenText & Documentum Consulting
      • Upgrades – A Well Documented Approach
      • Life Science Solutions
        • Life Sciences Project Sampling
    • Veeva Consulting
    • Ephesoft
    • Workshare
  • Case Studies
    • White Papers
    • 11 Billion Document Migration
    • Learning Zone
    • Digital Asset Collection – Canadian Museum of Human Rights
    • Digital Archive and Retrieval – ASCP
    • Digital Archives – New York Philharmonic
    • Insurance Claim Processing – New York Property Insurance
    • Policy Forms Management with Machine Learning – AAIS
    • Liferay and Alfresco Portal – United Cerebral Palsy of Greater Chicago
  • About
    • Contact Us
  • Blog

ECM Migrations – Top Ten Planning Tips For a Successful Migration

You are here: Home / ECM 101 / ECM Migrations – Top Ten Planning Tips For a Successful Migration

February 17, 2017

  1. Start planning early.

Clients often underestimate the amount of planning required for any type of migration. Migration often involves more than just moving content from one place to another. Many migrations also have to account for mapping metadata, folder structure, security, and other related objects from the source system to the target system. A typical migration timeline is depicted below. Note the duration of the planning phase.

migration-timeline

  1. Take inventory of all objects in the source system to be migrated.

It might seem obvious, but it’s important to take detailed inventory of the content to be migrated. In addition to just counting documents, consider other objects, such a versions, renditions, folders, permissions sets, annotations, users, and groups. For many clients, the inventory process frequently uncovers content that may have fallen through the cracks.

  1. Use migration as an opportunity to “clean house”.

Content migrations provide a great opportunity to clean up data to avoid migrating content that is no longer needed. Content cleanup can be a labor intensive task to perform in-place in an existing content management system. Migrations have provided many of our clients a chance to leave behind the clutter. Additionally, the less content that needs to be migrated, the shorter the duration of the migration.

  1. Use migration as an opportunity to “reorganize the house”.

Similar to cleaning house, as noted in tip #3, migration is also the optimal time to rework the content model, massage metadata, rearrange the folder structure, or simplify the security model. Since every content item is being touched as part of the migration, why not jump on the opportunity to make content architecture changes that are otherwise very difficult and time consuming to do in-place?

  1. Take the time to perform benchmark testing during the planning phase.

For large migrations, duration is an important factor to consider. Performing test migrations of sample batches of documents helps to provide more accurate estimates for how long the full migration will take. Migration throughput is largely dependent on factors such as network, storage, CPU, memory, and database speeds, making it nearly impossible to predict the overall migration duration without benchmarking.

  1. Identify and address migration performance bottlenecks.

After benchmark tests have been run, scrutinizing migration logs to identify throughput bottlenecks proves to be worth the extra effort. We often see clients significantly improve migration performance by making simple fixes to address bottlenecks, such as adding indexes to database tables, adding additional RAM to the source or target system, or running the migration process on a server with better network throughput.

  1. Break the migration down into manageable batches.

Staying organized and tracking counts of the content that needs to be migrated, is currently being migrated, and has been migrated is critical for large migrations. It can be unwieldly to try to migrate all documents as one big batch. Most clients find it easiest to batch content into smaller pieces based on metadata, such as document type, creation date, or folder path. Migration statistics can be gathered and analyzed upon the completion of each batch, making it easier to report status and estimate how long the migration will take to complete. Smaller batches also make it easier to restart a migration if a problem arises, such as a network outage or planned maintenance on the source system.

  1. Have a migration verification plan.

Migration tools, such as TSG’s OpenMigrate, have robust logging mechanisms for reporting counts of the amount of content that was successfully migrated or failed to migrate. Migration tools cannot always report that content is migrated exactly as expected. It’s critical to identify a sample set of content to verify after migration to ensure that content, metadata, folder structure, security, etc. are all mapped correctly in the target system. Verification can be tedious, but it’s important that all possible scenarios are verified. It can be very costly and time consuming to fix discrepancies if they’re caught too late.

  1. Allow enough time to handle migration anomalies and failures.

Rarely do large migrations run perfectly without any failures, especially when migrating from legacy systems that have exceeded their life expectancy. Even with detailed planning, there are almost always instances of corrupt files, bad/missing metadata, and other unexpected scenarios that occur during a migration. Even if the error rate is a very small number, reconciling and resolving errors can be a time consuming process, and should be planned for.

  1. Plan to perform delta migrations.

Delta migrations allow for the source repository to continue to be used while the bulk migration is being execute. With large migrations, it’s risky and sometimes impossible to execute a full migration during an outage window. Migration tools like TSG’s OpenMigrate allow for smaller delta migrations to be run after the bulk migration is complete to synchronize any content that was added or modified since the start of the bulk migration. A final delta migration can be scheduled during an outage window at the time that users are to switch from using the old system to the new system.

Filed Under: ECM 101, Migrations, OpenMigrate

Reader Interactions

Trackbacks

  1. Migrating FileNet with Daeja Annotations to AWS S3 says:
    August 8, 2018 at 12:35 pm

    […] Planning a Successful Migration: https://tsgrp.wpengine.com/2017/02/17/ecm-migrations-top-ten-planning-tips-for-a-successful-migration/ […]

    Reply
  2. Documentum Migration to Veeva Vault – Best Practices says:
    April 3, 2019 at 6:01 am

    […] clients, for over twenty years.  For additional background and best practices – see our ECM Migrations – Top Ten Planning Tips for a Successful Migration.  TSG has recently signed an initial partnering agreement with Veeva.  One of our first efforts […]

    Reply

Leave a Reply Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Primary Sidebar

Search

Related Posts

  • What makes migrating from a Legacy ECM systems so difficult?
  • Alfresco – Do More with OpenMigrate Services
  • AODocs Migration with OpenMigrate
  • FileNet Migration – Not as hard as you think?
  • FileNet Support – Migrating to mitigate the risk of an unsupportable product
  • FileNet Migrations – Best Practices for Large Migrations
  • Migrations – Why do they fail? (12 Worst Practices)
  • Reference Architecture for Content Management on Azure HDInsight with HBase
  • IBM Content Manager and Content Manager onDemand (CMOD) Migrations – How to Migrate Quickly
  • File Formats Lessons Learned – Legacy ECM Migrations

Recent Posts

  • Alfresco Content Accelerator and Alfresco Enterprise Viewer – Improving User Collaboration Efficiency
  • Alfresco Content Accelerator – Document Notification Distribution Lists
  • Alfresco Webinar – Productivity Anywhere: How modern claim and policy document processing can help the new work-from-home normal succeed
  • Alfresco – Viewing Annotations on Versions
  • Alfresco Content Accelerator – Collaboration Enhancements
stacks-of-paper

11 BILLION DOCUMENT
BENCHMARK
OVERVIEW

Learn how TSG was able to leverage DynamoDB, S3, ElasticSearch & AWS to successfully migrate 11 Billion documents.

Download White Paper

Footer

Search

Contact

22 West Washington St
5th Floor
Chicago, IL 60602

inquiry@tsgrp.com

312.372.7777

Copyright © 2023 · Technology Services Group, Inc. · Log in

This website uses cookies to improve your experience. Please accept this site's cookies, but you can opt-out if you wish. Privacy Policy ACCEPT | Cookie settings
Privacy & Cookies Policy

Privacy Overview

This website uses cookies to improve your experience while you navigate through the website. Out of these cookies, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This category only includes cookies that ensures basic functionalities and security features of the website. These cookies do not store any personal information.
Non-necessary
Any cookies that may not be particularly necessary for the website to function and is used specifically to collect user personal data via analytics, ads, other embedded contents are termed as non-necessary cookies. It is mandatory to procure user consent prior to running these cookies on your website.
SAVE & ACCEPT