1. Home
  2. Docs
  3. ClusterControl
  4. User Guide (GUI v2)
  5. Backups

Backups

Provides information and management options for all backups and schedules for all clusters managed by ClusterControl. Clicking on the Backups word (sidebar menu) will list out all backups on the main panel, each of the entries has a summary with a dropdown management menu (see Backup Actions).

To create an on-demand backup, or create a new backup schedule, click on Create backup. See Create Backup.

Each backup entry will have the following details:

  • ID: The backup ID. Every attempted backup will be assigned a backup ID, regardless of the backup status (completed, failed, defined, etc).
  • Info: Roll over the info icon to see the cluster information and status.
  • Cluster: The cluster name.
  • Method: The backup method used to create the backup.
  • Status: The backup job status.
  • Created: The backup creation time since this page is refreshed.
  • Size: The backup size, if the backup is successfully created.
  • Backup Host: The host where ClusterControl performs the backup.
  • Storage: The backup storage location. Rollover on the server’s icon will reveal the local storage path, while the cloud’s icon will reveal the cloud storage provider and its path (if any).
  • Actions: Backup management functions. See Backup Actions.

Clicking on the Backup Schedules tab will list all backup schedules. Each entry will have the following details:

  • Name: Backup schedule’s name.
  • Cluster: The cluster name.
  • Method: The selected backup method for this backup schedule.
  • Status: The backup schedule status, either Active or Paused.
  • Schedule: The time schedule to run the backup job.
  • Backup Host: The host where ClusterControl will perform the backup.
  • Storage Host: The host where ClusterControl will store the created backup.
  • Storage Location: The location to store the created backup.
  • Last Execution: The last time ClusterControl performed the backup job for this backup schedule.
  • Actions: Backup schedule management features. See Backup Schedule Actions.

Clicking on the Elastic Repositories tab will list all Elasticsearch snapshot repositories for the chosen cluster in the dropdown. A repository is a mandatory configuration when deploying a new Elasticsearch cluster using ClusterControl. See Elasticsearch.

Create Backup

Creates a new backup instantly or configures a new backup schedule, to be run at a specific time or interval. ClusterControl provides multiple ways to configure your database backup depending on the database cluster type. By clicking on the Create backup button, you will be presented with the following 3 options:

  • Backup on demand – Create a full backup instantly. You can choose to store the backup on-premises (locally on the ClusterControl server or the database node itself), or you can store it in the supported cloud storage like AWS S3, Google Cloud Storage, Azure Blob Storage, or any S3-compatible object storage provider. The backup can be a compressed and encrypted backup.
  • Schedule a backup – Define a schedule to periodically create backups. You can choose to store the backup on-premises (locally on the ClusterControl server or the database node itself), or you can store it in the supported cloud storage like AWS S3, Google Cloud Storage, Azure Blob Storage, or any S3-compatible object storage provider. The backup can be a compressed and encrypted backup. For a scheduled backup, you can also perform backup verification and automatic backup host failover.
  • Elastic snapshot repository – Creates Elasticsearch snapshot backup which can be stored locally or on AWS S3.

Backup on Demand

This feature allows users to create a new database backup instantly. Only full and differential backup methods are available. If one wants to create an incremental backup, use Schedule a Backup feature instead.

The backup options are depending on the cluster type:

 

MySQL/MariaDB

MySQLPercona  ServerPercona XtraDB ClusterMariaDB (Server and Galera Cluster)

To create an instant backup, you have the option to create a full backup using mysqldump, Percona Xtrabackup, or MariaDB Backup. Incremental backup using Percona Xtrabackup or MariaDB Backup (MariaDB only) is only available under Schedule a Backup. The successful backups can be stored on the database host that performs the backup, or the files can be streamed over to the ClusterControl host for centralized storage.

Field Description
Configuration
Backup method
  • mysqldump – Separated compressed schema and data dump. See mysqldump.
  • xtrabackup (full) – A full compressed backup. See Percona Xtrabackup.
  • mariabackup (full) – A full compressed backup. See MariaDB Backup.
Dump type
  • Exclusive for mysqldump only. Choose between:
    • Schema only – Similar to taking backup with --no-data
    • MySQL database only
    • Data only – Similar to taking backup with  --no-create-info
    • Schema and data – Standard full backup
    • Complete PITR-compatible – Full backup with a single dump file together with the binary log file name and position (--master-data)
Backup host
  • The target database node to take backup.
  • For Auto Select, ClusterControl will choose the next available node, and the replica node has a higher priority over the primary node.
Upload backup to cloud
  • On – Uploads the backup to the cloud storage. The upload process happens right after the backup is successfully created. This feature requires you to set up the cloud credentials first. See Cloud Providers. This action will add an additional step to the create backup wizard called Cloud storage.
  • Off – Stores the backup locally.
Advanced Settings
Compression
  • On – Compresses all backup data.
  • Off – Skips compression
Compression level
  • Specify the compression level for the backup. 1 is the fastest compression (least compression) and 9 indicates the slowest compression (best compression). The system default is 6.
Enable encryption
  • On – Encrypts the generated backup. Backup is encrypted at rest using the AES-256 CBC algorithm, where the encryption key will be created automatically and stored inside the CMON configuration file for this cluster. See Backup Encryption and Decryption.
  • Off – Skips encryption.
Use QPress compression
  • Exclusive for xtrabackup/mariabackup.
  • On – Uses qpress for compression. Multi-threaded and faster, but resource intensive.
  • Off – Uses gzip for compression. Single-threaded with fair resource usage.
Use extended insert
  • Exclusive for mysqldump.
  • On – Executes the mysqldump command with --extended-insert flag. This results in a smaller dump file and speeds up inserts when the file is reloaded.
  • Off – Executes the mysqldump command with --skip-extended-insert and --set-gtid-purged=OFF flags in the mysqldump command.
Retention
  • How long ClusterControl should keep this backup once successfully created. You can set a custom period in days or keep it forever. Otherwise, ClusterControl will use the default retention period. Take note that modifying the retention period on the existing schedule has no effect on the already created backup.
Desync node during backup
  • Exclusive for Galera Cluster and xtrabackup/mariabackup.
  • On – De-syncing a node before performing a backup, which disables Flow Control for the node. The node continues to receive write-sets and fall further behind the cluster. The cluster does not wait for desynced nodes to catch up, even if it reaches the fc_limit value.
  • Off – Performs the backup without desyncing the target node.
Backup locks
  • Exclusive for xtrabackup/mariabackup.
  • On – Uses LOCK TABLES FOR BACKUP where it is supported when making a backup.
  • Off – Sets --no-backup-locks that use FLUSH NO_WRITE_TO_BINLOG TABLES and FLUSH TABLES WITH READ LOCK when making a backup.
Lock DDL per table
  • On – Sets --lock-ddl-per-table (<8.0) or --lock-ddl (>8.0) . This only applies to Percona Xtrabackup v2.4.8 and later versions. Setting this flag may cause blocked updates to tables for highly loaded servers under some circumstances.
  • Off – Skips this parameter when taking a backup. If DDL events have occurred while the backup process is ongoing, there is a risk of backup corruption during the prepare stage.
Xtrabackup parallel copy threads
  • Exclusive for xtrabackup/mariabackup. This option specifies the number of threads to use to copy multiple data files concurrently when creating a backup. The default value is 1 (i.e., no concurrent transfer).
Network streaming throttle rate (MB/s)
  • Exclusive for xtrabackup/mariabackup and only if the storage location is the controller. Throttle the backup streaming process using a tool called pv. 0 means disabled.
Use PIGZ for parallel gzip
  • Exclusive for xtrabackup/mariabackup.
  • On – Use PIGZ for parallel gzip. This is helpful if you want to back up a very large data set with multiple CPU cores.
  • Off – Use the standard gzip.
Enable partial backup
  • On – Choose the databases that you want to backup.
  • Off – Perfoms a full backup.
Databases
  • Only available if Enable partial backup is On. Pick the databases retrieved from the monitored MySQL servers. Default is “All Databases”. Otherwise, specify the databases that you would like to back up for this set.
One dump file per DB
  • Exclusive for mysqldump.
  • On – Every chosen database will have its own dump file.
  • Off – Create one single dump file for the chosen databases.
Local Storage
Storage location
  • Store on Node – Stores the backup inside the corresponding database node.
  • Store on Controller – Stores the backup inside the ClusterControl node. This requires socat or netcat on the source and destination host for backup streaming. The default is “9999,9990-9998”, which means port 9999 will be preferred if available, otherwise, ClusterControl will use the next available port from the range.
Storage directory
  • The backup directory on the Storage location.
Backup subdirectory
  • Set the name of the backup subdirectory. The full backup path will be Storage directory/Backup subdirectory. Default value isBACKUP-%I. See Backup Subdirectory.
Cloud Storage
Credentials
  • Choose the cloud account from the dropdown list. See Cloud Providers.
Bucket
  • Choose a bucket from the dropdown, where the dropdown list is pulled dynamically after the Credentials has been selected.
Retention period
  • On – ClusterControl will delete the backup in the cloud after exceeding the specified retention period.
  • Off – The backup will be kept forever in the cloud.
Delete after upload
  • On – Deletes the backup in the local storage after it is successfully uploaded into the cloud. Note that enabling this option can cause problems with incremental backups chaining since the previous backup metadata will be no longer in the server. A workaround for this is to set this option to Off and then configure a low retention period to at least the next scheduled incremental backup can see the last incremental backup on the local storage.
  • Off – Keeps the backup in the local storage after it is successfully uploaded into the cloud.

 

MongoDB

Percona Backup for MongoDB is available for both Replica Set and Sharded Cluster. For mongodump, the option is only available for Replica Set. Note that Percona Backup for MongoDB requires a remote file server mounted to a local directory, e.g, NFS.

Field Description
Configuration
Backup method
Upload backup to cloud
  • On – Uploads the backup to the cloud storage. The upload process happens right after the backup is successfully created. This feature requires you to set up the cloud credentials first. See Cloud Providers. This action will add an additional step to the create backup wizard called Cloud storage.
  • Off – Stores the backup locally.
Advanced Settings
Enable encryption
  • On – Encrypts the generated backup. Backup is encrypted at rest using the AES-256 CBC algorithm, where the encryption key will be created automatically and stored inside the CMON configuration file for this cluster. See Backup Encryption and Decryption.
  • Off – Skips encryption.
Retention
  • How long ClusterControl should keep this backup once successfully created. You can set a custom period in days or keep it forever. Otherwise, ClusterControl will use the default retention period.
  • Note that modifying the retention period on the existing schedule has no effect on the already created backup.
Local Storage
Storage location
  • Store on Node – Stores the backup inside the corresponding database node.
  • Store on Controller – Stores the backup inside the ClusterControl node. This requires socat or netcat on the source and destination host for backup streaming. The default is “9999,9990-9998”, which means port 9999 will be preferred if available, otherwise, ClusterControl will use the next available port from the range.
Storage directory
  • The backup directory on the Storage location.
Backup subdirectory
  • Set the name of the backup subdirectory. The full backup path will be Storage Directory/Backup Subdirectory. Default value isBACKUP-%I. See Backup Subdirectory.
Cloud Storage
Credentials
  • Choose the cloud account from the dropdown list. See Cloud Providers.
Bucket
  • Choose a bucket from the dropdown, where the dropdown list is pulled dynamically after the Credentials has been selected.
Retention period
  • On – ClusterControl will delete the backup in the cloud after exceeding the specified retention period.
  • Off – The backup will be kept forever in the cloud.
Delete after upload
  • On – Deletes the backup in the local storage after it is successfully uploaded into the cloud.
  • Off – Keeps the backup in the local storage after it is successfully uploaded into the cloud.

 

PostgreSQL/TimescaleDB

To create an instant backup, you have the option to create a full backup using pg_dumpall, pg_basebackup and pgbackrestfull. Incremental backups using pgbackrestincr or pgbackrestdiff are only available under Schedule a Backup. The successful backups can be stored on the database host that performs the backup, or the files can be streamed over to the ClusterControl host for centralized storage.

Field  Description
Configuration
Backup method
  • pgdumpall – Full logical backup using pg_dumpall. See pg_dumpall section.
  • pg_basebackup – Full physical backup using pg_basebackup. See pg_basebackup section.
  • pgbackrestfull – Full physical backup using pgBackRest. See pgBackRest section.
  • pgbackrestdiff – Differential physical backup using pgBackRest. See pgBackRest section.
  • pgbackrestincr – Incremental physical backup using pgBackRest. See pgBackRest section.
Backup host
  • The target database host.
Upload backup to cloud
  • On – Uploads the backup to the cloud storage. The upload process happens right after the backup is successfully created. This feature requires you to set up the cloud credentials first. See Cloud Providers. This action will add an additional step to the create backup wizard called Cloud storage.
  • Off – Stores the backup locally.
PITR enabled
  • Exclusive for pg_basebackup.
  • On – Creates a backup that can be used for point-in-time recovery. This setting is only available if you have enabled continuous WAL archiving. See Backup Settings.
  • Off – Creates a standard backup.
Advanced settings
Use compression
  • On – Compresses all backup data.
  • Off – Skips compression
Compression level
  • Specify the compression level for the backup. This is according to the gzip compression level. 1 is the fastest compression (least compression) and 9 indicates the slowest compression (best compression).
Enable encryption
  • On – Encrypts the generated backup. Backup is encrypted at rest using the AES-256 CBC algorithm, where the encryption key will be created automatically and stored inside the CMON configuration file for this cluster. See Backup Encryption and Decryption.
  • Off – Skips encryption.
Retention
  • How long ClusterControl should keep this backup once successfully created. You can set a custom period in days or keep it forever. Otherwise, ClusterControl will use the default retention period.
  • Note that modifying the retention period on the existing schedule has no effect on the already created backup.
Enable partial backup
  • Exclusive for pgdumpall. Creates a partial backup for database.
Local storage
Storage location
  • Store on Node – Stores the backup inside the corresponding database node.
  • Store on Controller – Stores the backup inside the ClusterControl node. This requires socat or netcat on the source and destination host for backup streaming. The default is “9999,9990-9998”, which means port 9999 will be preferred if available, otherwise, ClusterControl will use the next available port from the range.
Storage directory
  • The backup directory on the Storage location.
Backup subdirectory
  • Set the name of the backup subdirectory. The full backup path will be Storage Directory/Backup Subdirectory. Default value isBACKUP-%I. See Backup Subdirectory.
Cloud Storage
Credentials
  • Choose the cloud account from the dropdown list. See Cloud Providers.
Bucket
  • Choose a bucket from the dropdown, where the dropdown list is pulled dynamically after the Credentials has been selected.
Retention period
  • On – ClusterControl will delete the backup in the cloud after exceeding the specified retention period.
  • Off – The backup will be kept forever in the cloud.
Delete after upload
  • On – Deletes the backup in the local storage after it is successfully uploaded into the cloud. Note that enabling this option can cause problems with incremental backups chaining since the previous backup metadata will be no longer in the server. A workaround for this is to set this option to Off and then configure a low retention period to at least the next scheduled incremental backup can see the last incremental backup on the local storage.
  • Off – Keeps the backup in the local storage after it is successfully uploaded into the cloud.

 

Redis

Field Description
Configuration
Backup host
  • The target database node to take backup.
  • For Auto Select, ClusterControl will choose the next available node, and the replica node has a higher backup priority over the primary node.
Backup method
Upload backup to cloud
  • On – Uploads the backup to the cloud storage. The upload process happens right after the backup is successfully created. This feature requires you to set up the cloud credentials first. See Cloud Providers. This action will add an additional step to the create backup wizard called Cloud storage.
  • Off – Stores the backup locally.
Advanced Settings
Compression
  • On – Compresses all backup data.
  • Off – Skips compression.
Compression level
  • Choose the compression level for the backup. 1 is the fastest compression (least compression) and 9 indicates the slowest compression (best compression). The system default is 6.
Enable encryption
  • On – Encrypts the generated backup. Backup is encrypted at rest using the AES-256 CBC algorithm, where the encryption key will be created automatically and stored inside the CMON configuration file for this cluster. See Backup Encryption and Decryption.
  • Off – Skips backup encryption.
Retention
  • How long ClusterControl should keep this backup once successfully created. You can set a custom period in days or keep it forever. Otherwise, ClusterControl will use the default retention period.
  • Take note that modifying the retention period on the existing schedule has no effect on the already created backup.
Local Storage
Storage location
  • Store on Node – Stores the backup inside the corresponding database node.
  • Store on Controller – Stores the backup inside the ClusterControl node. This requires socat or netcat on the source and destination host for backup streaming. The default is “9999,9990-9998”, which means port 9999 will be preferred if available, otherwise, ClusterControl will use the next available port from the range.
Storage directory
  • The backup directory on the Storage location.
Backup subdirectory
  • Set the name of the backup subdirectory. The full backup path will be Storage directory/Backup subdirectory. Default value isBACKUP-%I. See Backup Subdirectory.
Cloud Storage
Credentials
  • Choose the cloud account from the dropdown list. See Cloud Providers.
Bucket
  • Choose a bucket from the dropdown, where the dropdown list is pulled dynamically after the Credentials has been selected.
Retention period
  • On – ClusterControl will delete the backup in the cloud after exceeding the specified retention period.
  • Off – The backup will be kept forever in the cloud.
Delete after upload
  • On – Deletes the backup in the local storage after it is successfully uploaded into the cloud.
  • Off – Keeps the backup in the local storage after it is successfully uploaded into the cloud.

 

Microsoft SQL Server

Field Description
Configuration
Backup host
  • The target database node to take backup.
  • For Auto Select, ClusterControl will choose the next available node, and the replica node has a higher backup priority over the primary node.
Backup method
Upload backup to cloud
  • On – Uploads the backup to the cloud storage. The upload process happens right after the backup is successfully created. This feature requires you to set up the cloud credentials first. See Cloud Providers. This action will add an additional step to the create backup wizard called Cloud storage.
  • Off – Stores the backup locally.
Advanced Settings
Compression
  • On – Compresses all output data, including the transaction log file and metadata files.
  • Off – Skips compression.
Include system databases
  • On – Backup will include all system databases.
  • Off – Skips system databases – Master, Resource, TempDB, Model, MSDB, Distribution, ReportServer, ReportServerTempDB
Retention
  • How long ClusterControl should keep this backup once successfully created. You can set a custom period in days or keep it forever. Otherwise, ClusterControl will use the default retention period.
  • Take note that modifying the retention period on the existing schedule has no effect on the already created backup.
Local Storage
Storage location
  • Store on Node – Stores the backup inside the corresponding database node.
Storage directory
  • The backup directory on the Storage location.
Backup subdirectory
  • Set the name of the backup subdirectory. The full backup path will be Storage directory/Backup subdirectory. Default value isBACKUP-%I. See Backup Subdirectory.
Cloud Storage
Credentials
  • Choose the cloud account from the dropdown list. See Cloud Providers.
Bucket
  • Choose a bucket from the dropdown, where the dropdown list is pulled dynamically after the Credentials have been selected.
Retention period
  • On – ClusterControl will delete the backup in the cloud after exceeding the specified retention period.
  • Off – The backup will be kept forever in the cloud.
Delete after upload
  • On – Deletes the backup in the local storage after it is successfully uploaded into the cloud.
  • Off – Keeps the backup in the local storage after it is successfully uploaded into the cloud.

 

Elasticsearch

Field Description
Configuration
Repository
  • Elasticsearch repository. This could be the local repository (local file system) or cloud repository (S3-compatible cloud storage). You may create the repository under Create BackupElastic Snapshot Repository.
Backup method
Advanced Settings
Retention
  • How long ClusterControl should keep this backup once successfully created. You can set a custom period in days or keep it forever. Otherwise, ClusterControl will use the default retention period.
  • Take note that modifying the retention period on the existing schedule has no effect on the already created backup.

 

Valkey

Field Description
Configuration
Backup host
  • The target database node to take backup.
  • For Auto Select, ClusterControl will choose the next available node, and the replica node has a higher backup priority over the primary node.
Backup method
Upload backup to cloud
  • On – Uploads the backup to the cloud storage. The upload process happens right after the backup is successfully created. This feature requires you to set up the cloud credentials first. See Cloud Providers. This action will add an additional step to the create backup wizard called Cloud storage.
  • Off – Stores the backup locally.
Advanced Settings
Compression
  • On – Compresses all backup data.
  • Off – Skips compression.
Compression level
  • Choose the compression level for the backup. 1 is the fastest compression (least compression) and 9 indicates the slowest compression (best compression). The system default is 6.
Enable encryption
  • On – Encrypts the generated backup. Backup is encrypted at rest using the AES-256 CBC algorithm, where the encryption key will be created automatically and stored inside the CMON configuration file for this cluster. See Backup Encryption and Decryption.
  • Off – Skips backup encryption.
Retention
  • How long ClusterControl should keep this backup once successfully created. You can set a custom period in days or keep it forever. Otherwise, ClusterControl will use the default retention period.
  • Take note that modifying the retention period on the existing schedule has no effect on the already created backup.
Local Storage
Storage location
  • Store on Node – Stores the backup inside the corresponding database node.
  • Store on Controller – Stores the backup inside the ClusterControl node. This requires socat or netcat on the source and destination host for backup streaming. The default is “9999,9990-9998”, which means port 9999 will be preferred if available, otherwise, ClusterControl will use the next available port from the range.
Storage directory
  • The backup directory on the Storage location.
Backup subdirectory
  • Set the name of the backup subdirectory. The full backup path will be Storage directory/Backup subdirectory. Default value isBACKUP-%I. See Backup Subdirectory.
Cloud Storage
Credentials
  • Choose the cloud account from the dropdown list. See Cloud Providers.
Bucket
  • Choose a bucket from the dropdown, where the dropdown list is pulled dynamically after the Credentials has been selected.
Retention period
  • On – ClusterControl will delete the backup in the cloud after exceeding the specified retention period.
  • Off – The backup will be kept forever in the cloud.
Delete after upload
  • On – Deletes the backup in the local storage after it is successfully uploaded into the cloud.
  • Off – Keeps the backup in the local storage after it is successfully uploaded into the cloud.

 

Backup Subdirectory

Variable Description
B The date and time when the backup creation was beginning.
H The name of the backup host, the host that created the backup.
i The numerical ID of the cluster.
I The numerical ID of the backup.
J The numerical ID of the job that created the backup.
M The backup method (e.g. “mysqldump”).
O The name of the user who initiated the backup job.
S The name of the storage host, the host that stores the backup files.
% The percent sign itself. Use two percent signs, %% the same way the standard printf() function interprets it as a one percent sign.

Schedule a Backup

The functionalities of backup scheduling are almost identical to Create a Backup, however, there are some additional functionalities as shown below:

Field  Description
Configuration
Schedule name
  • Specify a name for this backup schedule.
Schedule
  • Simple – Default scheduling option. This translates to the same output as the Advanced editor.
  • Advanced – Opens a cron-like editor. Formatting is similar to the standard cron.
Advanced settings
Failover backup
  • On – Backup will be run on any available node (or selected node based on the Failover host) if the target database node is down. If the failover is enabled and the selected node is not online, the backup job elects an online node to create the backup.
  • This ensures that a backup will be created even if the selected node is not available. If the scheduled backup is an incremental backup and a full backup does not exist on the newly selected node, then a full backup will be created.
  • Off – Backup will not run if the target database node is down.
Failover host
  • List of database hosts to failover in case the target node is down during the scheduled backup.
Verify backup
Restore backup on
  • Specify the FQDN, hostname, or IP address of the standalone host. The host must not be part of the cluster.
  • Press Enter to add the node, where ClusterControl will perform a pre-deployment check to verify if the node is reachable via passwordless SSH.
Install database software
  • On – Installs database server packages. The packages will be based on the latest available version of the primary node’s repository and vendor.
  • Off – ClusterControl will not touch the existing installation and the existing database server (must be running) on the target host will be used.
Disable firewall
  • On – Disables firewall (recommended).
  • Off – This configuration task will be skipped. If the firewall is enabled, make sure you have configured the necessary ports.
Disable SELinux/AppArmor
  • On – Disables SELinux or AppArmor (recommended).
  • Off – This configuration task will be skipped. If enabled, make sure you have set a proper policy for the database-related processes and all of their dependencies.
Shut down the server after backup restored
  • On – ClusterControl will perform a system shutdown after the restoration completes. This is particularly useful to minimize the cost of running cloud instances.
  • Off – Let the node run after the restoration completes and the node will be listed under the Nodes page. You are then responsible for removing the backup verification server.
Start backup verification (after completion)
  • Performs the backup verification after the specified hours once the backup is completed.

Elastic Snapshot repository

This feature allows users to register an off-cluster storage location called a snapshot repository to a cluster. ClusterControl currently supports S3-compatible snapshot storage (requires a proper pre-configured cloud credential, see Cloud credential login).

One has to specify the repository name, storage location, cloud storage credentials, and an already created bucket:

 

 

Backup Actions

Provides shortcuts to the backup’s functionality.

Feature Description
Restore
Logs
  • Opens the backup’s job log messages.
Upload
  • Uploads the successfully created backup to the cloud. Specify the cloud credentials from the Credentials dropdown, which will then load the configuration for the bucket and storage path.
  • You may customize the retention period in days by toggling the Retention period. The default value is 180.
Download
  • Exclusive if cloud storage is configured. Downloads the backup from the cloud into the local storage.
Delete
  • Deletes the corresponding backup.

Backup Schedule Actions

This section explains the backup schedule functionalities for existing backup schedules. If you want to create a new backup schedule, see Schedule a Backup.

Feature Description
Pause
  • Pause the backup job from running at the next scheduled time.
Edit
  • Edit the backup schedule. This action will open the backup schedule modification wizard similar to creating a backup schedule wizard. See Schedule a Backup.
Delete
  • Deletes the corresponding backup schedule. Deleting the schedule will not delete all backups that have been created by this schedule.

Backup Methods

This section explains the backup method used by ClusterControl.

Note

The backup process performed by ClusterControl is running as a background thread (RUNNING3) which doesn’t block any other non-backup jobs in the queue. If the backup job takes hours to complete, other non-backup jobs can still run simultaneously via the main thread (RUNNING). You can see the job progress at ClusterControl → Logs → Jobs.

mysqldump

MySQLPercona  ServerPercona XtraDB ClusterMariaDB (Server and Galera Cluster)

ClusterControl performs mysqldump against all or selected databases by using the --single-transaction option. It automatically performs mysqldump with --master-data=2 if it detects binary logging is enabled on the particular node to generate a binary log file and position statement in the dump file. ClusterControl generates a set of 4 mysqldump files with the following suffixes:

  • _data.sql.gz – Schemas’ data.
  • _schema.sql.gz – Schemas’ structure.
  • _mysqldb.sql.gz – MySQL system database.
  • _triggerseventroutines.sql.gz – MySQL triggers, events, and routines.

Percona Xtrabackup

MySQLPercona  ServerPercona XtraDB Cluster

Percona Xtrabackup is an open-source MySQL hot backup utility from Percona. It is a combination of xtrabackup (built in C) and innobackupex (built on Perl) and can back up data from InnoDB, XtraDB, and MyISAM tables. Xtrabackup does not lock your database during the backup process. For large databases (100+ GB), it provides a much better restoration time as compared to mysqldump. The restoration process involves preparing MySQL data from the backup files before replacing or switching it with the current data directory on the target node.

Since its ability to create full and incremental MySQL backups, ClusterControl manages incremental backups, and groups the combination of full and incremental backups in a backup set. A backup set has an ID based on the latest full backup ID. All incremental backups after a full backup will be part of the same backup set. The backup set can then be restored as one single unit using the Restore Backup feature.

Attention

Without a full backup to start from, incremental backups are useless.

MariaDB Backup

MariaDB (Server and Galera Cluster)

MariaDB Backup is a fork of Percona XtraBackup with added support for compression and data-at-rest encryption available in MariaDB, included in MariaDB 10.1.23 and later. It is an open-source tool provided by MariaDB for performing physical online backups of InnoDB, Aria, and MyISAM tables. MariaDB Backup is available on Linux and Windows.

On all supported versions of MariaDB 10.1 and 10.2, ClusterControl will default to MariaDB Backup as the preferred backup method and SST method.

pg_dumpall

PostgreSQL TimescaleDB

ClusterControl performs pg_dumpall against all databases (or pg_dump for individual databases) with the --clean option, which includes SQL commands to clean (drop) databases before recreating them. DROP commands for roles and tablespaces are added as well. The output will be .sql.gz extension and the file name contains the timestamp of the backup.

It is possible to take a backup for an individual database by choosing pg_dumpall as the backup method, and then toggle “Enable partial backup”. Specify the database that you want to back up and ClusterControl will perform the backup operation using pg_dump command line instead.

pg_basebackup

PostgreSQL TimescaleDB

pg_basebackup is used to take base backups of a running PostgreSQL database cluster. These are taken without affecting other clients to the database and can be used both for point-in-time recovery and as the starting point for a log shipping or streaming replication standby server. It makes a binary copy of the database cluster files while making sure the system is put in and out of backup mode automatically. Backups are always taken of the entire database cluster; it is not possible to back up individual databases or database objects.

ClusterControl connects to the replication stream using the replication user (default is cmon_replication) with --wal-method=fetch option when creating the backup. The output will be base.tar.gz inside the backup directory.

pgBackRest

PostgreSQL TimescaleDB

pgBackRest is an open-source software developed to perform efficient backup on PostgreSQL databases that measure in tens of terabytes and greater. It supports per-file checksums, compression, partial/failed backup resume, high-performance parallel transfer, asynchronous archiving, tablespaces, expiration, full/differential/incremental, local/remote operation via SSH, hard-linking, restore, and more. The tool is written in Perl and does not depend on rsync or tar but instead performs its own deltas which gives it maximum flexibility.

Starting from ClusterControl 1.9.0, pgBackRest can be configured as follows:

  1. Primary: Install on the current primary but not on replicas. The backup repository (host to store the backup data) will be configured to be on the primary node. There will be no SSH configuration for pgBackRest.
  2. All database nodes: Install on all database nodes. The backup repository will be created on the current primary node. The backup will be made by using a standby node. PgBackRest will use SSH for communication between hosts.
  3. All database nodes and a dedicated repository host: Install on all PostgreSQL database nodes. The backup repository will be made on a specified host. The backup will be made by using a standby node. PgBackRest will use SSH for communication between hosts.
Note

The pgbackrest backup directory cannot be reused for other backup methods.

During the first attempt of making pgBackRest backup, ClusterControl will re-configure the node to install and configure pgBackRest. Take note that this operation requires a database restart and might introduce downtime to your database. A configuration file will be created at /etc/pgbackrest.conf and will be configured according to the version used and the location of the PostgreSQL data. The pgBackRest default repository path is located at /var/lib/pgbackrest. Additionally, ClusterControl will configure the following lines inside postgresql.conf (which explains why it requires restart during the first run):

archive_mode = on   # enables archiving; off, on, or always # (change requires restart)
archive_command = 'pgbackrest --stanza=clustercontrol-stanza archive-push %p'   # command to use to archive a logfile segment
Attention

In the ClusterControl GUI, pgBackRest nodes are listed with a fake port number (200000 + cluster ID), due to the internal CmonHost object requirement for a host:port combination. As a matter of fact, the pgBackRest process is not daemonized, nor need a port number.

Full Backup

Full backup of pgBackRest copies the entire contents of the database cluster to the backup. The first backup of the database cluster is always a Full Backup. pgBackRest is always able to restore a full backup directly. The full backup does not depend on any files outside of the full backup for consistency.

Differential Backup

For differential backup, pgBackRest copies only those database cluster files that have changed since the last full backup. pgBackRest restores a differential backup by copying all of the files in the chosen differential backup and the appropriate unchanged files from the previous full backup. The advantage of a differential backup is that it requires less disk space than a full backup, however, the differential backup and the full backup must both be valid to restore the differential backup.

For example, if a full backup is taken on Sunday and the following daily differential backups are scheduled, the data that is backed up will be:

  • Monday – data from Sunday to Monday
  • Tuesday – data from Sunday to Tuesday
  • Wednesday – data from Sunday to Wednesday
  • Thursday – data from Sunday to Thursday

Incremental Backup

For incremental backup, pgBackRest copies only those database cluster files that have changed since the last backup (which can be another incremental backup, a differential backup, or a full backup). As an incremental backup only includes those files changed since the prior backup, they are generally much smaller than full or differential backups. As with the differential backup, the incremental backup depends on other backups to be valid to restore the incremental backup. Since the incremental backup includes only those files since the last backup, all prior incremental backups back to the prior differential, the prior differential backup, and the prior full backup must all be valid to perform a restore of the incremental backup. If no differential backup exists then all prior incremental backups back to the prior full backup, which must exist, and the full backup itself must be valid to restore the incremental backup.

For example, if a full backup is taken on Sunday and the following daily incremental backups are scheduled, the data that is backed up will be:

  • Monday – data from Sunday to Monday
  • Tuesday – data from Monday to Tuesday
  • Wednesday – data from Tuesday to Wednesday
  • Thursday – data from Wednesday to Thursday

mongodump

MongoDB Replica Set

ClusterControl uses the standard command to perform mongodump with --journal, which allows mongodump operations to use the durability journal to ensure that the export is in a consistent state against shards. This backup method is only available for MongoDB Replica Set.

Attention

mongodump (and mongorestore) is not available for MongoDB Sharded Cluster 4.2 and later that have sharded transactions in progress, as backups created with mongodump do not maintain the atomicity guarantees of transactions across shards.

Percona Backup for MongoDB

MongoDB Replica Set MongoDB Sharded Cluster

Percona Backup for MongoDB is a distributed, low-impact solution for achieving consistent backups of MongoDB sharded clusters and replica sets. Percona Backup for MongoDB supports Percona Server for MongoDB and MongoDB Community v3.6 or higher with MongoDB Replication enabled (standalone is not supported due to the dependency on MongoDB’s oplog). The Percona Backup for MongoDB project inherited from and replaces mongodb-consistent-backup, which is no longer actively developed or supported.

Percona Backup for MongoDB requires an extra step for installation and configuration, and it is not enabled by default. You can use ClusterControl to install this tool by going to Clusters choose the MongoDB clusterCluster Action → Install Percona Backup, or simply choose the backup method percona-backup-mongodb from the dropdown list when configuring a backup method for a backup. If the tool is not installed, ClusterControl will advise on installing the backup tool first before moving forward to the next step.

If you have older versions of MongoDB i.e. < 3.6 versions, the only method to take a backup is mongodump.

Attention

Percona Backup for MongoDB requires a shared file system on a remote file server mounted to a local directory, e.g, NFS. It is the responsibility of the server administrators to guarantee that the same remote directory is mounted at exactly the same local path on all servers in the MongoDB cluster or non-sharded replica set. If the path is accidentally a normal local directory, errors will eventually occur, most likely during a restore attempt.

Redis Database Backup

Redis Redis Sentinel

RDB is Redis Database Backup file. It is a dump of all user data stored in an internal, compressed serialization format at a particular timestamp which is used for point-in-time recovery (recovery from a timestamp). AOF stands for Append Only File, which is actually a persistence technique in which an RDB file is generated once and all the data is appended to it as it comes.

When backing up Redis, ClusterControl backs up both RDB and AOF (if enabled) files on the selected database node.

MSSQL Backup

Microsoft SQL Server 2019

ClusterControl performs a backup routine on a Microsoft SQL Server by using the sqlcmd client to connect to the SQL Server and take backups. For a full backup, ClusterControl will iterate against all databases and create a standard full backup. Full database backups represent the database at the time the backup is finished.

For differential backup, it only backs up the data that has changed since the last full backup. This type of backup requires you to work with fewer data than a full database backup, while also shortening the time required to complete a backup. All the differential backups will be grouped under the last full backup on the Backup page.

Minimally, one must have created at least one full backup before one can create any log backups. After that, the transaction log can be backed up at any time unless the log is already being backed up. It is recommended to take log backups frequently, both to minimize work loss exposure and to truncate the transaction log.

A database administrator typically creates a full database backup occasionally, such as weekly, and, optionally, creates a series of differential database backups at shorter intervals, such as daily. Independent of the database backups, the database administrator backs up the transaction log at frequent intervals.

One of the limitations of using MSSQL Backup is backups created by a more recent version of SQL Server cannot be restored in earlier versions of SQL Server.

Elasticsearch Snapshot

An Elasticsearch snapshot is a way to back up your Elasticsearch indices and data. The process involves creating a snapshot of one or more indices and storing it in a designated repository. This snapshot can then be used to restore the indices to their previous state in case of data loss or other issues. The snapshot process is incremental, meaning that only changes made since the last snapshot are stored. Snapshots can be taken manually or automatically on a schedule, and can also be used to migrate data between clusters or to create new indices.

ClusterControl configures the Elasticsearch snapshot storage at the deployment phase. At this stage, one has to specify the repository name, storage location, and file system path:

 

Valkey Database Backup

Valkey standalone Valkey Cluster

RDB is Valkey Database Backup file. It is a dump of all user data stored in an internal, compressed serialization format at a particular timestamp which is used for point-in-time recovery (recovery from a timestamp). AOF stands for Append Only File, which is actually a persistence technique in which an RDB file is generated once and all the data is appended to it as it comes.

When backing up Valkey, ClusterControl backs up both RDB and AOF (if enabled) files on the selected database node.

Backup Encryption and Decryption

If the encryption option is enabled for a particular backup, ClusterControl will use OpenSSL to encrypt the backup using the AES-256 CBC algorithm. Encryption happens on the backup node. If you choose to store the backup on the controller node, the backup files are streamed over in encrypted format through socat or netcat.

If compression is enabled, the backup is first compressed and then encrypted resulting in smaller backup sizes. The encryption key will be generated automatically (if not exists) and stored inside the CMON configuration for the particular cluster under backup_encryption_key the option. This key is stored with base64 encoded and should be decoded first before using it as an argument to pass when decrypting the backup. The following command shows how to decode the key:

$ cat /etc/cmon.d/cmon_X.cnf | grep ^backup_encryption_key | cut -d"'" -f2 | base64 -d > keyfile.key

Where X is the cluster-ID. The above command will read the backup_encryption_key value and decode the value to a binary output. Thus, it is important to redirect the output to a file, as in the example, we redirected the output to keyfile.key. The key file that stores the actual encryption key can be used in the OpenSSL command to decrypt the backup, for example:

$ cat {BACKUPFILE}.aes256 | openssl enc -d -aes-256-cbc -pass file:/path/to/keyfile.key > backup_file.sql.gz

Or, you can pass the stdin to the respective restore command chain, for example:

$ cat {BACKUPFILE}.aes256 | openssl enc -d -aes-256-cbc -pass file:/path/to/keyfile.key | gunzip | psql -p5432 -f-

Backup Settings

Manages the backup default settings for the corresponding cluster.

Feature Description
Default backup directory
  • The default path for the backup directory. ClusterControl will create the backup directory on the destination host if doesn’t exist.
Default subdirectory
  • Set the name of the backup subdirectory. The full backup path will be Storage Directory/Backup Subdirectory/.  Default value: BACKUP-%I. See Backup Subdirectory.
Netcat port
  • Specify the port number or port number range that will be used by ClusterControl to stream backup created on the database node. This port must be opened on both source and destination hosts. Only available if you choose Store on Controller under Storage Location when configuring a backup.
  • The default is “9999,9990-9998”, which means port 9999 will be preferred if available. If not available, it will start from any available port from the defined range. This setting is critical if you have many overlapped backup jobs for multiple nodes or clusters.
Enable hash check on created backup files
  • If toggled, ClusterControl will calculate a checksum after a backup is successfully created. Depending on the backup size, this can be a very CPU-intensive process. Checksums are used to ensure the integrity of a file after it has been transmitted from one device to another.
  • When disabling the hash check (checksumming), there is no way to verify the integrity of the backup files when streamed over the network.
Default backup retention period
  • The number of days ClusterControl keeps the existing backups. Backups older than the value defined here will be deleted. You can also customize the retention period per backup (default, custom or keep forever) under Backup Retention when creating or scheduling the backup.
  • The purging is based on the following conditions:
    • When a new backup is successfully created, and if no verified backup is requested, the older backups will be checked and removed.
    • When the verified backup is successfully created, the older backups will be checked and removed.
    • The backup housekeeping job remains executed every 24 hours. Thus, if no backups are created and no backups are verified, the backup retention still will be done every 24 hours.
Default cloud backup retention period
  • The number of days ClusterControl keeps the uploaded backups in the cloud. Backups older than the value defined here will be deleted.
  • 0 means no retention and the backup will be kept forever.

Backup Subdirectory

Variable Description
B The date and time when the backup creation was beginning.
H The name of the backup host, the host that created the backup.
i The numerical ID of the cluster.
I The numerical ID of the backup.
J The numerical ID of the job that created the backup.
M The backup method (e.g. “mysqldump”, “pg_basebackup”, “mongodump”).
O The name of the user who initiated the backup job.
S The name of the storage host, the host that stores the backup files.
% The percent sign itself. Use two percent signs, %% the same way the standard printf() function interprets it as one percent sign.
Was this article helpful to you? Yes No