Misc. optional settings for configuration file

Below you can find some optional parameters that you can add to the config.ini file. Make sure you use each parameter strictly in the section it belongs to.

Home section Parameter Definition Supported values
[Backup] AttemptDelay The duration of intervals between retries (for backup sessions that are retried in case of an error). Relates to the AttemptNumber parameter. A number (in milliseconds). 1000 by default.
[Backup] AttemptNumber Prompts the Backup Manager to retry the backup in case of an error (for example, "Access denied"). The setting applies to VSS-based data sources: MS Exchange, MS SQL, MS SharePoint, System State. A number (3 by default)
[Backup] MaxCabinetSize

The maximum size a cabinet with backup data can reach.

How cabinets are created

A number from 2 to 64 (in megabytes). Set to 64 by default.
[General] AllowExchangeRestart Allows the Backup Manager to restart MS Exchange (namely the Microsoft Exchange Information Store service) in case the VSS Writer cannot create a snapshot.
  • 0 – disabled (default)
  • 1 – enabled
[General] BackupThreadsCount The number of simultaneous connections during backup (determines data transfer speed).

A whole number between 1 and 10. Set to 4 by default even when no parameters are set.

[General] IgnoreMissedScheduledBackup

Normally, missed backup sessions are run automatically as soon as the computer or virtual machine is started. You can cancel this through the IgnoreMissedScheduledBackup setting.

The setting applies only to those backup sessions that were not started because the computer was off.

  • 0 – disabled (default)
  • 1 – enabled
[General] LocalSpeedVaultUnavailabilityTimeoutInDays The number of days after which a failed LocalSpeedVault stops attempts to synchronize with the cloud. The feature has been available starting from version 18.4. Any whole number or 0 for immediate action. Set to 14 by default.
[General] PathToLocalStorage

Indicates where the local copy of the Backup RegisterA database of backup meta data that is formed and stored on a backup client device and regularly uploaded to the cloud. is stored.

A path. Default values:
  • Windows: C:\ProgramData\MXB\Backup Manager\storage\
  • Linux: /opt/MXB/var/storage/
  • macOS: /Library/Application Support/MXB/Backup Manager/storage/
[General] ReadOnlyMode Sets the Backup Manager to the restore-only mode and back to the full mode.
  • 1 (enables the restore-only mode)
  • 0 (disables the restore-only mode) - default
[General] RestoreDownloadThreadCount The number of simultaneous connections during recovery (determines data transfer speed). A whole number. Set to 10 by default.
[General] SynchronizationThreadCount The number of simultaneous connections during backup (determines data transfer speed). A whole number from 1 to 10 (set to 4 by default)
[General] TempDir The location of temporary files created by the Backup Manager (for example, database dumps or files created during backup data processing). A directory path (set to the system Temp folder by default)
[Logging] LoggingLevel

A parameter that activates debug logging.

Debug logs are logs with an extended logging level. They are activated in some specific troubleshooting cases when information in regular application logs is insufficient. The logs can take up a considerable amount of disk space so make sure you disable the feature after you get the necessary details.

Debug
[Logging] LogsLocation

This parameter allows you to change the location of the log files. Debug logs are normally stored in the following locations:

  • Windows: C:\ProgramData\MXB\Backup Manager\logs
  • GNU/Linux: /opt/MXB/var/logs
  • macOS: /Library/Logs/MXB/Backup Manager/logs
desired file path
[MsSql] UseCopyOnlySnapshot

A parameter that enables copy-only backups of MS SQL databases.

Unlike regular backups, copy-only backups do not make any changes to the database and do not interfere with the normal sequence of backups (visit MSDN Library to learn more). You can restore copy-only backups in the same way as regular backups.

  • 0 – disabled (default)
  • 1 – enabled
[Recovery] RecoveryMode

A parameter that prompts the Backup Manager to perform some Backup Register as well as consistency checks and repair procedures right after the start.

By default, the recovery mode is disabled as it is rather time-consuming.

  • 0 – disabled (default)
  • 1 – enabled
[VirtualDrive]
  • VirtualDriveRestoreCacheEnabled
  • VirtualDriveRestoreCacheType
  • VirtualDriveRestoreCacheLocaton
  • VirtualDriveRestoreCacheSizeLimitInMb

If the VirtualDrive is slow to react, apply these parameters with the given values then create the folder C:\VDCACHE\.

  • 1
  • FS
  • C:\VDCACHE
  • 102400