Backups are used for copying and archiving target data (target is either a disk or a smart server as a single whole of all disks used).

OnApp supports two backup types: normal and incremental: 

  • Normal backup - simple method of taking backups by making a full copy of target data and storing it in an archive. 

  • Incremental - advanced method of taking backups. During the incremental backup, only the changes made after the last backup are archived instead of backing up the whole target. You must have dedicated backup servers configured in your cloud to be able to utilize the incremental backups functionality. Incremental backups are enabled via Admin > Settings > Configuration > Backups/Templates menu. 

    It is not possible to take incremental backups if you are using location group functionality without a backup server added to the group - the following error message will appear:

    "Backup cannot be made at this time: This disk cannot be backed up, check Location Group settings."

    This issue will be fixed in next releases. As a workaround, add an empty backup server zone to your location group.

    If required, you can change the block size which is used during backup creation at Control Panel > Admin > Settings > Configuration by editing the Block Size (MB) parameter.

Each backup type can be taken in two ways:

  • Manually - the user logs into OnApp CP and clicks the Take backup button.

  • Automatically - the user enables automatic backup option (daily, weekly, monthly, yearly). To enable auto-backups for virtual servers that support incremental backups which used auto-backups option before the upgrade, re-enable automatic backups by switching them off and on again.

If you are using incremental backups option, you should either enable dedicated backup servers in your cloud or share the backups and templates folders (paths) between your compute resources. SSH file transfer option will be skipped for virtual servers using incremental backups. Existing full backups will be still accessible via Backups > Images menu.

How Do Incremental Backups Work?

For example, we have a disk with three files:

  • File1 - 4 Gb

  • File2 - 2 Gb

  • File3 - 3 Gb

The first incremental backup will be 9 GB (sum of all files). If you decide to take another incremental backup soon thereafter, the backup size will be equal to 0, as the files have not been changed since the first backup (if your backup has complicated directory structure, it could be more than 0, as file system could store some system data).

Then:

  • If the user decides to delete File2, the target size will now be 7 Gb. The subsequent incremental backup size will be 0, as new data has not been added. 

  • If the user adds File4 of 4 GB size, the subsequent incremental backup will equal 4 GB (the size of new data added). 

  • If the user increases File3 disk size to 6 GB, the subsequent incremental backup size will equal 6 GB, although the target increases by 3 GB. This happens because the incremental system takes the update of the existing file as the deletion of the existing file and adding the new file with the same name (the first version of File3 has been deleted and the new one with 6GB size has been added).

Backups can be saved either to a сompute resource or to a dedicated backup server. When saving a backup, the system calculates if a user has enough physical/bucket resources to save a backup in the selected destination.

When saving a backup to a сompute resource, the system does not check if сompute resource has enough disk space to save a backup and only checks if a user has enough bucket limits.

When saving a backup to a dedicated backup server, the system checks both disk space and bucket limits.

Free disk size on a target must be at least equal to the disk’s size for which the backup is taken (or to a size of all VS disks for incremental backup).
In some cases (for example, if a user has scheduled several disk backups simultaneously, but there are only free space/billing limits for the first one) the system may allow taking all the backups but will not be able to save them. This will result in a system error and over-billing.

Backup Support by VM / Virtualization / OS


Normal backup

Incremental backup

Convert to template

BaremetalServer

no

no

no

EdgeServer

no

no

no

StorageServer

yes

yes

no

LoadBalancer

no

no

no

SmartServer

yes

yes

yes

KVM

yes

yes

yes

VMware

snapshot

no

no

Windows

yes

no

yes

*nix

yes

yes

yes

CloudBoot / IS

yes

yes

yes

SolidFire

yes

no

yes

View Smart Server Backups

To view the list of smart server's backups:

  1. Go to your Control Panel > Cloud > Smart Servers menu.
  2. Click the label of the required smart server.
  3. Click the Backups tab, then select the appropriate backup type:
    • Images - full backups
    • Files - incremental backups
  4. On the screen that appears, you'll see a list of smart server backups sorted by category.
  5. Click the label of the required smart server backup to see the following tools - restore backup, delete backup, convert it to template and add note:


Take Smart Server Backup

To take an incremental backup:

  1. Go to your Control Panel > Cloud > Smart Servers menu.
  2. Click the label of the server you want to back up.
  3. Click the Backups tab, then select Files. You'll see a list of the disks allocated to that smart server.
  4. Click the Actions icon next to a disk you want to take a backup of, then click Backup. You'll see a list of all the backups taken and pending for that disk, along with the tools to restore backups, delete them, and convert them to templates.
  5. To take a backup, click the Take a Backup button at the end of the list.
Backups in the OnApp Control Panel are associated with a particular user instead of being associated with a smart server. To view the list of user backups, refer to the View User Backups sections.

Template extraction is performed during server provisioning  or taking a backup when using a particular template. To prevent template from being used in other transactions during extraction, template is locked during the extraction and unlocked on accomplishment. If other transaction tries to use the locked template, it will fail after 5 minutes of standby.

Transaction which locked template and failed, means that extracted template is broken.

Storing scheme:

  • template /onapp/templates/your_template.tgz
  • extracted template /onapp/backups/templates/your_template
  • locked template /onapp/backups/templates/your_template.lock

Take Smart Server Disk Backup

To back up a smart server:

  1. Go to your Control Panel > Cloud > Smart Servers menu.
  2. Click the label of the appliance you want to back up.
  3. Click the Storage tab > Disks. You'll see a list of the disks allocated to that smart server.
  4. Click the Actions icon next to a disk you want to take a backup of, then click Backup. You'll see a list of all the backups taken and pending for that disk, along with the tools to restore backups, delete them, and convert them to templates.
  5. To take a backup, click the Take a Backup button at the end of the list.
Backups in the OnApp Control Panel are associated with a particular user instead of being associated with a smart server. To view the list of user backups, refer to the View User Backups sections.

Convert Smart Server Backup to Template

To convert smart server backup to template:

  1. Go to your Control Panel > Cloud > Smart Servers menu.
  2. Click the label of the required smart server.
  3. Click the Backups tab, then select the appropriate backup type:
    • Images - full backups
    • Files - incremental backups
  4. On the screen that appears, click the Actions icon next to the backup and choose the Convert to Template.

Restore Smart Server Backup

To restore a backup:

  1. Go to your Control Panel > Cloud > Smart Servers menu.
  2. Click the label of the required smart server.
  3. Click the Backups tab, then select the appropriate backup type:
    • Images - full backups
    • Files - incremental backups

  4. On the screen that appears, click the Actions icon next to the backup you want to revert to and choose Restore.

    • If the file system on the disk is corrupted, it won't be possible to restore the files from incremental backup. In that case, you can force a backup restore and rebuild a file system on a disk. To do this, move the Force Restore slider to the right.

    • Note that Force Restore option is unavailable for incremental backups of FreeBSD virtual servers.
  5. Click the Restore Backup button.

Edit Smart Server Backup Note

To edit smart server backup's note:

  1. Go to your Control Panel > Cloud > Smart Servers menu.
  2. Click the label of the required smart server.
  3. Click the Backups tab, then select the appropriate backup type:
    • Images - full backups
    • Files - incremental backups
  4. On the screen that appears, click the Actions icon next to the required backup and choose Add Note. Make necessary changes and click Submit.

Delete Smart Server Backup

To delete a backup:

  1. Go to your Control Panel > Cloud > Smart Servers menu.
  2. Click the label of the required smart server.
  3. Click the Backups tab, then select the appropriate backup type:
    • Images - full backups
    • Files - incremental backups
  4. On the screen that appears, click the Actions icon next to the backup you want to remove and choose Delete.

See also:

Leave feedback