At Dell, we have worked with hundreds of SharePoint migration projects of various size and scale where customers used our migration tools to migrate sites and content either to a new version of SharePoint hosted in an internal datacenter or Office 365. The recommendations you'll find in this post reflect this experience we gained helping Dell (and Quest) customers over time. Feel free to suggest your best practices in the comments.
SharePoint is a massively complex enterprise-grade application. If you are currently using it as an Out-of-the-Box system with no custom configuration your migration should be straight-forward; but if you took advantage of the many extended capabilities and added significant customizations, you may encounter problems when these capabilities and customizations are no longer supported on your target system.
Dell Migration Suite for SharePoint is a fully compliant SharePoint migration tool that leverages native SharePoint remote APIs (Web Services, Client Site Object Model) to perform migrations. This protects customers from making inadvertent modifications to their SharePoint installation that void Microsoft warranty (e.g. when using tools that write to the SharePoint content database). It also eliminates the risk of deploying server-side agents on production servers that can compromise security and stability.
However there are certain limitation when using remote APIs. For example, if you have significantly customized the look and feel of your source environment, you may need to repeat the effort in your target environment. If you have developed and deployed customized or 3rd party features, you may find that these are no longer compatible in the new environment. Some other notable limitaions that include Workflow Status and History and Check-Out Status.
A later serction discusses the benefits of performing adequeate testing prior to embarking on your migration project . This will go a long way to identify any limitations and establish an acceptance criteria. You can then communicatie these to your stakeholders and set reasonable expectations.
You need to have a complete understanding of what kind of content you have in your source SharePoint farm, how it is used and what you will be bringing over to the new SharePoint installation. No matter if the destination is an on-premises deployment or Office 365, you need to know:
There are native assessment tools, but third-party reporting tools such as Dell Site Administrator for SharePoint give you significantly more information in aggregated and easily consumable way on your current environment.
Another key piece of information you need to collect is the configuration of your current SharePoint farm in terms of services and features. You need to understand which ones are deployed and, more importantly, used by SharePoint site collections and sites.
Customizations typically present the biggest migration problem especially if you are moving to the cloud. You need to understand all of the custom site definitions (like Fab 40), solutions, web parts and other custom SharePoint extensions that your existing sites rely on. Native assessment tools (e.g. pre-upgrade checker) exist, but may not be available for your specific SharePoint version/patch level. Dell Migration Suite for SharePoint includes a pre-migration analysis report that can be used to compare any source site(s) against the intended target to see discrepancies in:
Incompatible templates can be re-mapped to out-of-the-box templates in the migration tool. List/library level migration to a pre-created standard site is another option.
Migration of the farm-level configuration, services and customizations identified in the assessment phase is beyond the scope of content migration tools, so these will need to be deployed prior to commencing content migration. Making configuration changes when content migration is in progress can lead to failed migration and rework. What needs to be deployed depends on whether the destination is a hosted SharePoint service or on-premises installation, but the following list includes the most typical items:
Migration Suite supports migration of entire site collections, but in some situations it will be advisable to use a more gradual approach to increase the success rate (longer migration jobs can be susceptible to environmental effects) and simplify troubleshooting and validation. E.g. you may choose to copy the root site first and then perform gradual migration of sub-sites either sequentially or in parallel.
Migration Suite provides a lot of migration options to control what and how is migrated for SharePoint sites, lists and libraries. Migration options differ significantly in terms of impact on the success rates and migration throughput. Use caution when enabling the following options:
It is recommended to use the default options whenever possible and only enable those that are mandatory to meet the requirements. Once you determine the most appropriate sets of options for your migration, create option presets (profiles) in Migration Suite to simplify migration job configuration and avoid errors.
The importance of adequate testing grows with the size of the project. Dell Migration Suite for SharePoint Make allows for non-destructive data migrations and you should use subsets of the live data for dry-run testing. Use test migrations to:
Optimize & automate