diff --git a/README.md b/README.md index a4782d9..d42146a 100644 --- a/README.md +++ b/README.md @@ -59,7 +59,9 @@ This kit: Export complete. ZIP created at: C:\ODBC_Migration\ODBC_Backup.zip ``` -6. Copy that `ODBC_Backup.zip` file to a USB drive or cloud folder. +6. Open `C:\ODBC_Migration` and verify that the file `ODBC_Backup.zip` exists and is larger than **1 MB**. + +7. Copy that `ODBC_Backup.zip` file to a USB drive or cloud folder. 🟢 **Tip:** Running the script this way keeps the PowerShell window open — @@ -98,8 +100,90 @@ so if anything goes wrong, you’ll see the exact error message. - List missing drivers (with download links) 🟢 **Tip:** +You can safely run the `restore-ODBC.ps1` script more than once — it won’t overwrite or damage anything. + Keep the PowerShell window open until the script finishes — -you’ll see messages like “Added DSN…” or “Missing ODBC Drivers Detected”. +you’ll see messages like “Added DSN…” or “Missing ODBC Drivers Detected.” + +--- + +## 📊 Step 3 — View the Migration Report + +After you finish restoring, a detailed report is automatically created: + +``` +C:\ODBC_Migration\restore\ODBC_Migration_Report.md +``` + +You can open this file in: + +- **Notepad** (Right-click → “Open with Notepad”) +- Or a **Markdown viewer** (like Typora, Obsidian, or Visual Studio Code) + +This report shows every driver that was backed up and whether it’s installed on your new PC. + +Example section from the report: + +| ODBC Driver | Platform | Version | Product | Publisher | Download Link | +| ----------------------------- | -------- | -------- | --------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------- | +| ODBC Driver 18 for SQL Server | 64-bit | 18.2.1.1 | Microsoft ODBC Driver 18 for SQL Server | Microsoft | [Download](https://learn.microsoft.com/sql/connect/odbc/download-odbc-driver-for-sql-server) | +| MySQL ODBC 8.0 Unicode Driver | 64-bit | 8.0.36 | Oracle | [Download](https://dev.mysql.com/downloads/connector/odbc/) | | + +--- + +## 💾 Step 4 — Install Missing Drivers on the New PC + +If the restore window or report says **“Missing ODBC Drivers Detected”**, do this: + +1. Open the `ODBC_Migration_Report.md` file +2. Look for any drivers with **“Download”** links +3. Click the link — it will open the **official vendor website** +4. Download and install the driver that matches your system (64-bit or 32-bit) + +🟢 **Common examples:** + +- SQL Server → “Microsoft ODBC Driver 18 for SQL Server” +- MySQL → “MySQL Connector/ODBC” +- PostgreSQL → “psqlODBC” +- SQLite → “SQLite ODBC Driver” +5. When installing drivers, **right-click the installer** and choose **“Run as Administrator.”** +6. Once installed, **run the `restore-ODBC.ps1` script again** + + ```powershell + .\restore-ODBC.ps1 + ``` + + This will recheck the system and add any DSNs that couldn’t be created earlier. + +--- + +## 🧪 Step 5 — Verify the Restored DSNs + +1. Press **Windows + R**, type: + + ``` + odbcad32.exe + ``` + +2. Open both: + + - **64-bit ODBC Administrator**: `C:\Windows\System32\odbcad32.exe` + - **32-bit ODBC Administrator**: `C:\Windows\SysWOW64\odbcad32.exe` + +3. Check that your DSNs appear under: + + - **User DSN** and/or **System DSN** + +✅ **If you see your DSNs listed under “System DSN,” you’re done!** + +--- + +## 🧹 Step 6 — Optional Cleanup + +Once everything is working: + +- Delete the folder `C:\ODBC_Migration_Scripts` +- Move `ODBC_Backup.zip` to a safe backup location (USB drive, NAS, or cloud storage) ---