Versions Compared

Old Version 8

changes.mady.by.user Unknown User (abhisar)

Saved on

compared with

New Version Current

changes.mady.by.user Unknown User (abhisar)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

This feature adds the ability to create a new instance from a VM backup for dummy, NAS and Veeam backup providers. It works even if the original instance used to create the backup was expunged or unmanaged. There are two parts to this functionality:

...

  1. A user selects a backup and clicks the "Create Instance from Backup" button.
  2. The user can choose to create the instance straightaway (all configuration details are fetched from the backup metadata) or they can choose to configure some details details themselves with some restrictions.
  3. A new instance is created with the intended configurations.
  4. The instance is started to allocate volumes, then stopped for restore.
  5. For NAS provider, backed-up data is copied to the new instance's volumes using existing restore functionality.
  6. For Veeam, a command is sent to the Veeam server to restore the backup to the new instance location.
  7. After restore, the instance is started and ready for use.

...

Part 1 : Creating Instance from Backup

Saving Instance Details / Properties

The following details are needed for creating the new Instance:

...

The rest of the Instance properties are not stored and retrieved from backup. Users have to set them explicitly if needed.

Applying Configuration Details

  • The UI form is pre-populated with backup metadata.

  • Users may override configurations.

  • Restrictions:

    • Number of data volumes must remain the same.
    • Data volume sizes must be >= backed-up sizes.

    These are already enforced in the UI, and will return an error if called directly from API.

  • The option to reuse original IP and MAC is available only if the original VM is expunged and the addresses are still available in the network.

...

  • ISO : ISO is attached  while creating the instance and detached  before restore, so that the new instance doesn't boot with ISO, but still has the metadata that it was created using that ISO.
  • SSHKeys : SSH key if given by the user is set after restore so that it doesn't get overwritten during restore.
  • User data : User data is not re-applied when restoring from a backup.  Backups are expected to capture the full VM state after user data (cloud-init) has been applied. Therefore, user data is considered already baked into the disk image.

New API

A new api createVmFromBackup is added.

...

ParameterTypeRequiredDescription
backupidUUIDYesBackup ID to restore from
preserveipBooleanNoUse original IP/MAC. Applicable only if the original Instance is expunged
zoneidUUIDYesZone to deploy the instance
datadiskdetailsListYesDisk details for data volumes (Disk offering, size, minIops, maxIops)
serviceofferingidUUIDNoOptional override
templateidUUIDNoOptional override
Other parameters are similar
to deployVmCmd 		---

Multiple Data Volume Support

The existing DeployVmCmd only supports creating a single data volume during instance deployment. However, backups can contain multiple data volumes, and to restore such backups, the CreateVmFromBackup API needs to support the creation of multiple data volumes.

...

Although this functionality is technically available in DeployVmCmd, it has not been integrated into the UI.

UI Changes

  • New button: "Create Instance from Backup" in backups list view.
  • User can choose to directly create the VM or configure VM parameters before creating it.

...

Part 2 : Support for Expunging Instances that has Backups

Currently, backup offering can not be removed from an Instance which has backups. This has been changed so that backup offering can be removed and the VM can be expunged even with backups

  • This is supported for Dummy, NAS and Veeam providers.
  • VM can be reassigned a different backup offering.
  • Operations supported on retained backups:
    • Create Instance from Backup
    • Restore Volume from Backup and Attach to VM
    • Delete backup

Framework Level Changes

  • Volumes related information is retrieved from backup.backed_volumes instead of vm_instance.backup_volumes as vm_instance.backup_volumes is cleared when the backup offering is removed.
  • Backup offering and provider are derived from the backup table, not from the vm_instance table.

Backup Usage Tracking

Backup usage tracking has undergone major changes to support the new flexibility around backup offerings.

...

Usage is also tracked for backups of Expunged Instances. Pre-requisite for this is that the Database entry for the expunged VM is present. It is made sure that the db entry for expunged Instances with Backups are not auto-purged by the system itself. Users should make sure not to manually purge DB entries for such VMs.

Usage Tracking Lifecycle Changes

  • Previously, removing a backup offering from a VM would also remove its the usage record associated with that offering.
  • With this change, usage records are preserved even after a backup offering is removed, as long as any backups exist.
  • Usage record for such offering is now removed only after the last backup associated with that offering is removed.

NAS Plugin Changes

  • No structural changes needed.
  • Retrieve information from backup instead of the VM.
  • Metrics are now returned per (VM, BackupOffering) rather than per VM.

Veeam Plugin Changes

  • Removing backup offering deletes the Veeam job but it does not delete any backups.
  • Backups can be deleted separately from CloudStack.
  • The backups remain in orphaned state in Veeam but usable.
  • Old job’s backup schedules are also deleted on removing the offering, just the backups remain.
  • New job is created if VM is assigned a new offering. Not affecting old backups.
  • Veeam Provider and Client updated to return metrics per (VM, BackupOffering).

Screenshots

...


...