The cbbackupmgr tool is a utility to help manage and store backup and recovery data on disk for your Couchbase Server. It backs up and restores bucket data, views creation scripts, index creation scripts, bucket configurations, and so on. Backups are stored in an Archive Repository that contains each backup.
Only Full Administrators can use the new enterprise-grade Backup and Restore tool to back up larger data sets with much higher performance.
- All bucket data is stored in a secondary smaller database (ForestDB).
- All bucket creation scripts and configuration files are stored on the file system as files.
The cbbackupmgr tool is installed with all other tools in the following locations on each platform:
|Operating system||Directory locations|
Assumes default installation location
|Mac OS X||/Applications/Couchbase Server.app/Contents/Resources/couchbase-core/bin/cbbackupmgr|
How the Backup and Restore Tool Works
By default, the cbbackupmgr tool performs incremental backups to back up only the new data. However, on a new cluster and for the first time, this tool generates a full backup. Each of the subsequent incremental backups take a fraction of the time taken by the full backup.
The backup archive is a directory that contains a set of backup repositories as well as logs for the backup client. The backup directory should be modified only by the backup client, and any modifications that are not done by that client might result in a corruption of backup data.
Only one backup client can access the backup archive at one time. If multiple instances of the backup client are running on the same archive at the same time, this might result in corruption. To prevent such corruption instances, you may be required to create multiple backup archives depending on your use case.