Troubleshooting

Connection Issues

Bridge connector not found

  • Verify the himigration-bridge.php file is in the source store's root directory
  • Check that the file has proper read permissions
  • Ensure the source store URL includes the correct protocol (http/https)

Token mismatch

  • Re-generate the connector and re-upload the bridge file
  • Make sure you're using the token from the current session

SSL errors

  • Try disabling SSL verification in MigraPro settings
  • Ensure the source store's SSL certificate is valid

Migration Issues

Timeout during migration

  • Reduce the batch size in settings
  • Check your PHP max_execution_time setting
  • The module uses chunked processing, so batches should complete within limits

Missing images

  • Verify the bridge connector has read access to image directories
  • Check that curl is enabled on the target server
  • Images retry up to 3 times with backoff on failure

Duplicate entries

  • Use the Clear Data option to remove existing entities before re-importing
  • Check the Keep IDs setting — disabling it lets the target auto-generate new IDs

Memory issues

  • Reduce batch size to process fewer records per step
  • Increase PHP memory_limit on the target server

General Tips

  • Always create a database backup before migrating
  • Start with a small entity type (e.g., Manufacturers) to verify the connection works
  • Enable debug mode for verbose logs if troubleshooting complex issues
  • The migration can be paused and resumed at any time