The support forum

Bvckup 2 configuration files

Nov 06, 2014

Bvckup 2 configuration directory


The app keeps all of its configuration and state data on a disk in a single configuration directory. Default location of Bvckup 2 config directory is

      %LocalAppData%\Bvckup2

If you are still on Windows XP, it's

      %UserProfile%\Local Settings\Application Data\Bvckup2

In the service mode, the app runs as two separate processes - the service with the backup engine and a desktop app with just the user interface - and they each use their own directory. The UI uses app's standard config directory. The service uses

      %ProgramData%\Bvckup2

Nov 06, 2014

Using custom configuration directory


The app can be told to use arbitrary configuration directory of your choice. There are two ways to do this.

1.  You can pass this directory to the app with -c command line option:

      bvckup2.exe -c x:\path\to\the\config\directory

2.  You can create a file called redirect.ini in default config directory and then just put your configuration location as the first line of this file. If there are any environment variables in the location string, the app will expand them.

Additionally, the *service* configuration directory can be overridden by setting the REG_SZ registry value called ServiceConfigPath under HKLM\Software\Bvckup2 key.

Nov 06, 2014

Configuration directory structure


The directory is organized as follows:

    \engine    - a folder with the engine data (see below)
    \ui             - a folder with the UI configuration
    \updates  - a folder with all previously downloaded app's updates

    \bvckup2.ini   -  settings shared between the engine and the UI
    \bvckup2.log  -  app's primary log file
    
There will likely be an assortment of other log files, e.g. bvckup2-fsi.log and bvckup2-vss.log. These capture the context of certain operations in the app and they are primarily needed for troubleshooting issues with tech support.

The "engine" sub-directory


The engine folder contains settings and the state data of all configured backups, each in its own sub-folder, starting with backup-0001:

      \engine\bvckup-0001
            delta\               -  sub-folder with checksum files from delta copier
            backup.log      -  plain text file with the log of the backup job
            backup.tdb     -   binary index file of the above, used internally
            settings.ini      -   the backup configuration, all of it
            snapshot.dat  -   binary file with the snapshot of the destination

The "delta" sub-folder contains binary files with per-block checksums for all files in the backup that were copied with the delta copier. This will be the largest part of each backup's configuration, potentially with a lot of files, taking up non-trivial amount of disk space. This folder can be deleted if needed, just keep in mind that doing so will cause the app to re-copy files in full once they are modified at source.

Now, climbing back up to \engine level, there are several files of note -

      \engine\bvckup2.lic                -  a text file with your license
      \engine\bvckup2-email.txt    -  a text file with the email alert template
      \engine\bvckup2-engine.ini  -  the engine configuration

The "ui" sub-directory


This folder host the UI configuration (window state, position, update check status, etc.) in a file called -

      \ui\bvckup2-ui.ini

The "updates" sub-directory


Whenever you tell the app to download and install the update (in response to the "New version available" prompt), the update is downloaded and stored in this directory.

Nov 06, 2014

The .ini files


The app stores all its configuration settings in INI files. These include bvckup2.ini, bvckup2-engine.ini, bvckup2-ui.ini and a setting.ini for each configured backup job.

The format of .ini files is very simple - one setting per line, starting with the setting name, followed by spaces/tabs, followed by the setting value that spans until the end of the line. Lines starting with # and blank lines are ignored.

For exact details see https://bvckup2.com/support/forum/topic/800.

## VERY IMPORTANT ##


All .ini files are read and loaded only when the app starts up. Most of them are updated when the app exits and many are updated when the app is running.

KEEP IN MIND that all .ini files are re-created from scratch when they are updated. You should NOT be modifying .ini files while the app is running or your changes will be overwritten and lost.

Overriding engine/UI settings


In addition to directly editing bvckup2-engine.ini and bvckup2-ui.ini, you can also modify settings in these files by creating a so-called "override" ini file and placing your changes there -

      \engine\bvckup2-engine-override.ini
      \ui\bvckup2-ui.ini

"Override" files are loaded by the app after it loads respective primary .ini and they are never modified by the app.

Overriding defaults of a new backup job


It is possible to use similar override mechanism to alter default backup configuration as used by the UI when creating a new backup job. For this add the setting you'd like to change to the following file -

      \ui\backup-override.ini

If you also want to clear all inclusion/exclusion filters and the root exclusion list, use the following file instead -

      \ui\backup-template.ini
Topic is locked.

New topic

Create
Made by Pipemetrics in Switzerland
Support


Follow
Twitter
Dev blog
Miscellanea Press resources
Testimonials
On robocopy
Company
Imprint

Legal Terms
Privacy