Documentation

# Migration Fix utility

Utility application for diagnosing and repairing corrupted or incomplete document migrations.

DLL: Epona.Migrate.Fix.dll

# What it does

  • Corrupt file detection — identifies 0-byte and corrupted files in migration sources
  • File removal — removes corrupted files from source and target systems
  • Migration recovery — repairs incomplete or failed migration transfers
  • Data validation — verifies file integrity after migration

# Prerequisites

  • Access to migration source system (original Epona.Migrate connection)
  • Access to target SharePoint site collections
  • Administrative credentials for source and target systems
  • Knowledge of which migration jobs to fix

# Deployment

  1. Copy Epona.Migrate.Fix.dll to the Epona.Migrate application directory
  2. Run the Fix utility with appropriate parameters
  3. Verify repairs before proceeding with additional migrations

# Fix workflow

  1. Scan — enumerate documents in source and target
  2. Validate — check for 0-byte or corrupted files
  3. Report — list issues found
  4. Remove — delete corrupted files
  5. Verify — confirm integrity after removal

# Usage scenarios

# 0-byte file removal

When the source system contains 0-byte placeholder files:

  1. Run Fix utility against the migration source
  2. Identify 0-byte files
  3. Remove 0-byte files from source
  4. Restart migration to skip already-processed files

# Corrupt file recovery

When target SharePoint contains corrupted documents:

  1. Run Fix utility against target site collections
  2. Identify corrupted files
  3. Remove corrupted files from SharePoint
  4. Re-run migration for affected documents

# Troubleshooting

# Common issues

# Cannot access source

  • Cause: Permissions or connectivity
  • Resolution: Verify account credentials and network access to source system

# Cannot remove files

  • Cause: Locked or in-use files
  • Resolution: Ensure no other processes are accessing the migration data

# File corruption unresolved

  • Cause: Corruption in source system
  • Resolution: Consider re-extracting documents from source DMS before re-migration
Last Updated: 4/2/2026, 11:46:36 AM