Essential - database file

Eugene Kuchynski — Tue, 03 May 2022 11:11:29 GMT

Current Revision posted to Wiki by Eugene Kuchynski on 5/3/2022 11:11:29 AM

This article explains where all the data is stored in the Essential version, so you can safely copy/move/backup/restore your data without worrying to loose it.

Actually, there are only 2 files where your data and application configuration is stored:

tbmdb.sqlite (database file). Default location: InstallationFolder\resources\bin\database.
appsettings_global.json (config file). Default location: InstallationFolder\resources\bin\.

In the application settings, you could change default database file location. In this case, you can find the path in the appsettings_global.json, under ConnectionStringLocal key.

Resetting database and database version

Config file contains one important key: DatabaseVersion. Initially, database version is 0. With time, when application gets updated, database version is increased. When you launch application, the system checks DatabaseVersion value, and if it's lower than the latest version, application will attempt to update database to latest version.

Example. If you delete database file and launch TBM, the system, will create empty database file, then read DatabaseVersion value, and if that value equals to latest version, upgrade won't happen, and you'll get non-initialized database. This means, that to start from scratch, you should not only delete database file, but also change DatabaseVersion value in the config file to 0.

Manual backup

Just copy 2 mentioned files to safe location.

Manual backup restore

You can just copy backup file to the database location and change it's name to tbmdb.sqlite. Be careful - if such file already exists, maybe it will be necessary to backup it, to avoid accidental overwriting. Additionally, it is recommended to restore appsettings_global.json file as well, or change DatabaseVersion value manually, if backup was created earlier, and after that you have installed any updates.