Troubleshooting Guide

Common issues and solutions when using MigratorXpress.

Connection Issues

Error: “Cannot connect to source database”

Symptoms:

• Connection timeout errors
• Authentication failures
• Network unreachable messages

Solutions:

1. Verify credentials in your JSON file:

   {
     "db_id": {
        "ds_type": "mssql",
        "auth_mode": "classic",
        "info": {
          "username" : "valid_user",
          "password" : "valid_password",
          "server" : "correct_hostname",
          "port" :1521,  // Ensure port is correct
          "database" : "valid_database"
       }
     }
   }
   

Error: “Migration database not accessible”

Solution: The migration database must be SQL Server. Ensure:

• SQL Server instance is running
• Mixed mode authentication is enabled
• User has CREATE TABLE permissions