dSHIFT Migrator for SharePoint Online — Complete Migration Guide
What it is
dSHIFT Migrator for SharePoint Online is a migration tool designed to move content, metadata, and structure from on-premises SharePoint, file shares, or other sources into SharePoint Online and Microsoft 365 while preserving permissions, metadata, and versions.
Key capabilities
- Source support: On-premises SharePoint (various versions), network file shares, and other supported repositories.
- Target: SharePoint Online (Microsoft 365) — site collections, subsites, libraries, lists.
- Metadata & versions: Preserves item metadata and version history where possible.
- Permissions: Migrates users, groups, and permissions mappings; can remap accounts to Azure AD users.
- Scheduling & throttling: Supports scheduled migrations and configurable throttling to respect tenant/service limits.
- Delta/incremental syncs: Performs incremental passes to capture changes since the initial migration.
- Pre-migration analysis: Scans sources to report on content types, size, problematic items, and estimated timelines.
- Reporting & logging: Detailed logs and reports for auditing and troubleshooting.
- Transformations: Renaming, path flattening, metadata mapping, and content filtering during migration.
- Scalability: Designed for enterprise-scale migrations with parallel processing and multi-threading.
Typical migration workflow
- Assessment: Run pre-migration scans to inventory content, identify blocked file types, large items, and permission issues.
- Plan mapping: Define target structure, site/library mappings, metadata mappings, and permission remapping rules.
- Pilot: Migrate a small representative set to validate mappings, transformations, and performance.
- Full migration (initial pass): Migrate bulk content while monitoring performance and logs.
- Delta runs: Execute incremental passes to capture edits or new content since the initial pass.
- Cutover: Redirect users to the target environment and finalize permissions.
- Post-migration validation: Verify content, metadata, permissions, and search indexing; resolve exceptions.
- Decommission: Retire legacy systems once validated and archived.
Best practices
- Run thorough discovery to set realistic timelines and storage estimates.
- Use pilots with representative content (large files, complex metadata, heavily customized sites).
- Map permissions carefully and plan account remapping to avoid broken access.
- Throttle to tenant limits to avoid service throttling from Microsoft.
- Handle large files and long URLs proactively — apply path/filename normalization.
- Communicate with users about cutover windows and expected downtime.
- Keep logs and reports for auditing and rollback planning.
- Validate search and custom solutions (web parts, customizations) in the target tenant.
Common issues and fixes
- Throttling by Microsoft: Reduce concurrency, add retry/backoff, schedule during off-peak hours.
- Long path/filename errors: Apply renaming rules or path flattening.
- Unsupported customizations: Rebuild or replace server-side customizations with SharePoint Framework or Power Platform alternatives.
- Permissions mismatches: Use explicit mapping rules and verify Azure AD account mappings.
- Large lists or item count limits: Break lists into smaller lists or use indexed columns.
Reporting & validation checks
- Confirm item counts, sizes, and version counts match source vs target.
- Spot-check metadata values and permission inheritance.
- Verify search indexing and navigation links.
- Review migration exception reports and resolve outstanding errors.
When to use dSHIFT Migrator
- Large-scale migrations from on-premises SharePoint or file shares to SharePoint Online.
- Projects requiring preservation of metadata, versions, and permissions.
- Complex migrations needing transformation rules and robust reporting.
Alternatives (brief)
- SharePoint Migration Tool (Microsoft) — free, basic migrations.
- ShareGate — popular commercial tool with rich UI and reporting.
- AvePoint, Metalogix — enterprise migration suites.
Leave a Reply