GTR FAQ

01 Migration step by step

2 min read

This page describes the standard case: Firebird 2.5, the database and the GTR program are on one computer. If the database is on a server, see Remote databases.

The buttons and tabs of the tool are labeled in English.

  1. Run the GTR Firebird setup. Store the credentials from the last setup page in a safe place.

  2. Close ProfDia and all other GTR programs.

  3. Open the Start menu and click Manage Firebird Databases.

  4. On the Setup tab, check the line Firebird 5.x. It must be green. The line Firebird 2.5 can be green or gray. If the line Firebird 5.x is not green, click Auto-Detect Firebird.

  5. Go to the Operations tab and select Local Database.

  6. Select Migrate from Firebird 2.5 to 5.x.

  7. Next to Database file, click Browse… and select the database.

    If you do not know the path: go to the GTR DB Config tab and load the INI file as described in step 9. The column Database in the row marked active shows the path.

  8. Click Start Operation, check the database in the dialog and click Yes. Wait for the message that the operation has completed. The tool keeps the old database as <database>_orig.

  9. Go to the GTR DB Config tab. Click Browse…, open the ProfDia folder and select NCPro_db.ini.

  10. Under Database sections, the tool has already selected the row marked active. Keep this selection unless you know that another section is needed.

  11. Check the values under New values. DriverIdent shows firebird-5.0, Port shows 3055 and Database shows the path of the migrated database. For ProfDia, Driver shows x86 (32-bit program).

  12. Click Save and then Yes. The tool first saves a copy of the file as NCPro_db.ini.<date_time>.bak. If the message Cannot write appears, close the tool and start it as administrator. Then repeat steps 9 to 12.

  13. Click Test connection. The result must contain Connection: OK, Firebird 5.0.4.

  14. Start ProfDia and check that it opens the migrated database.

  15. Uninstall Firebird 2.5: open Settings > Apps > Installed apps, select the entry that starts with Firebird 2.5 and click Uninstall. Do not uninstall Firebird 5.0 Database Server. Removing Firebird 2.5 describes the remaining cleanup.

Run steps 9 to 14 with Nestcut_db.ini if NestCut is also installed on this computer.

If a step fails, do not uninstall Firebird 2.5. See Troubleshooting.

Graph View

Backlinks