The setup of the temporary directory is often overlooked and customers typically tend to use the default setting which is fine for simple file or cloud file backup sets. However, for non-file backup sets like databases or virtual machines this is a very important backup set setting. The location of the temporary directory and or the free space allocated to the temporary directory can make or break a successful backup (and restore) and affect the overall performance.
CloudBacko Pro / Lite / Home makes use of the temporary directory for both backup and restore jobs.
For a backup job, it is used to temporarily store the:
For a restore job, it is used to temporarily store the:
The following factors need to be taken into account when determining the free space required for the temporary directory drive or partition:
For database backup sets; MS SQL Server in ODBC mode or Lotus Domino/Oracle/MySQL/MariaDB on Linux platform, CloudBacko Pro needs to makes a copy of the entire database in the temporary directory. The free space required on temporary directory must be at least equal to the size of the database you have selected for backup. For example, if you intend to make a backup of a 1TB MS SQL Server database in ODBC mode, the location where you define temporary directory must have at least 1TB of free disk space to accommodate the database file(s).
The default “Delta ratio” setting is 50% for all backup set types, which means that CloudBacko Pro / Lite / Home can generate an incremental or differential delta of up to 50% of the full file size. If you are backing a very large files or databases, for example a backup of a 1TB database then you will need to reserve up to 500GB of free space in drive where your temporary directory is located in order to accommodate the delta file.
When generating incremental or differential delta files, each individual backup destination will require its own individual delta file. Therefore, the disk space required for the drive where your temporary directory is located will increase with each additional backup destination.
Database backup sets which use the spooling method requires additional free disk space than backup sets which utilize Microsoft Volume Shadow Copy Service (VSS) to obtain a consistent snapshot.
You can use the following formula to calculate the free space required for the temporary directory depending on the backup set type.
|Backup Set Type||Operating System|
|MySQL Database Server||Windows / Linux / FreeBSD / macOS|
|MariaDB Database||Windows / Linux / FreeBSD|
|Oracle Database||Windows / Linux|
|MS SQL Server ODBC mode||Windows|
|MS Windows System Backup*||Windows|
|MS Windows System State*||Windows|
* Both MS Windows System Backup and MS Windows System State the image can be spooled to a separate partition to the CloudBacko temporary directory.
Total File Size Spooled + [(Total File Size * Delta Ratio) * number of backup destinations] = Maximum Free Space Required
Backup of 1TB MS SQL Server using ODBC mode with default delta ratio setting of 50% will require up to 1.5TB of free space on the temporary directory location.
|Database Size||Delta Ratio 50%||Backup Destinations||Free Space Required|
|Backup Set Type||Operating System|
|File||Windows / Linux / FreeBSD / macOS|
|MS SQL Server VSS mode||Windows|
|MS Exchange Database||Windows|
|Microsoft Office 365||Windows / macOS|
|Cloud File||Windows / macOS|
*A VMware ESXi/vCenter backup using VDDK mode, the incremental/differential delta files are directly generated by VMware host itself and therefore the temporary directory is not used for this purpose.
Backup of 1TB Hyper-V guest with default delta ratio setting of 50% will require up to 500GB of free space on the temporary directory location.
|VM Size||Delta Ratio 50%||Backup Destinations||Free Space Required|
(Total File Size * Delta Ratio) * number of backup destinations = Maximum Free Space Required
The calculations are based on the current database size, they do not take into account database growth over time. It is recommended for fast growing databases that the maximum free space required should be reviewed on a regular basis to avoid potential backup problems.
The default location is dependent on the O/S platform of the machine where CloudBacko is installed.
|Operating System||Temporary folder default location|
|Linux / FreeBSD||/root/temp|
As large files are copied or saved to the temporary directory as part of a database backup or restore job, to ensure optimal backup and restore performance the location of the temporary directory should be on a local drive rather than a network drive.
It is not recommended to set the temporary directory on:
On the CloudBacko Pro / Lite / Home backup client GUI the temporary directory settings can be found in [Backup Set] > [%BackupSet_Name%] > [Others].
CloudBacko Pro / Lite / Home will automatically remove any temporary files when a backup job has completed by default*. This feature can be configured by selecting the “Remove temporary files after backup” option on the backup set.
*This setting is not available for ShadowProtect Backup Sets
In some cases where CloudBacko is unexpectedly terminated, e.g. the process is killed in Windows Task Manager or CloudBacko crashes during a backup job, before it had an opportunity to delete the temporary files then it is recommended to manually delete the files in the temporary folder.
If the machine has anti-virus software installed please make sure the temporary directory is excluded. As some anti-virus software may lock or quarantine files created by CloudBacko Pro / Lite / Home for example incremental /differential delta files and most importantly the backup set index files causing backup or restore errors.
CloudBacko Pro / Lite / Home may lock its own index files as part of the backup job if these files are included in the backup source. So make sure the temporary folder is excluded from the backup source.