Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.

Abiquo 2.6

Skip to end of metadata
Go to start of metadata

What is an Instance?

An instance is a copy of a virtual machine system disk at a given time. It is stored in the Appliance Library with a copy of the template definition of the original virtual machine that you created the instance from. You can drag the instance into virtual appliance and deploy a virtual machine with the snapshot of the disk and the instance's template definition. Instances can be used for creating more complex virtual machine configurations and preparing a set of virtual machines to meet user needs. 

When you deploy a standard virtual machine, the Abiquo platform uses virtual machine templates from the Appliance Library for the enterprise and datacenter. The deploy process copies the template disk from the Appliance Library to the target hypervisor and configures the virtual machine based on the template definition and your configuration. This means that when you undeploy a virtual appliance, all changes that you made to the standard virtual machines will be lost because the next time you deploy, the template files will be copied again from the  Appliance Library  to the target hypervisor.

Creating an instance does not save the configuration of the virtual machine. When you create an instance, Abiquo will always copy the original virtual machine template definition to the instance template. A virtual machine created from this template will have the same base configuration as the original virtual machine template. You can edit an instance template and deploy a virtual machine with these changes. Any changes to an instance template will not affect the master template.   To save the virtual machine configuration, create Persistent Virtual Machines

See Saving Changes to Virtual Machines and See How VM instances work for more information.

Creating Virtual Machine Instances


You must deploy virtual machines before you can create instances. The machines must be deployed and stopped (powered off).

  • You cannot create instances of imported VMs on KVM or Xen hypervisors
  • Secondary hard disks created on a VMware hypervisor datastore are not included in instances

To create instances of virtual machines, open the virtual appliance where the virtual machines are located, then select each virtual machine and power it off.

Then click the  button.

A popup will appear with a list of all the virtual machines that can be selected to create an instance. 

On this popup, you can:

  1. Select "Mark all" to select all virtual machines of the current virtual appliance.
  2. Select individual virtual machines.

When you rename an instance, you should keep a note of the name of the original template that the virtual machine was deployed from. This will help you to find your instance in the future.

Click the pencil icon. Enter the new name, then click Accept.

When you have selected all the virtual machines you wish to instance, and renamed them as required, click Create Instance to start the instance process.

Deploy Virtual Machine Instances

When you add virtual machine templates to a virtual appliance, if the template to add has instances, the following pop-up is shown so you can select an instance and/or the master template. Remember that the virtual machine created from an instance will have the original virtual machine definition that is stored in the master template.

After you create an instance, the master template will be marked in the Appliance library with an "M" in the top right-hand corner. Click the master template to view its instances.

Locate Your Instance in the Apps Library

After you create an instance, it will be stored in the Apps library, with the original virtual machine template, which is a master template. A master template is marked with an "M" in the top right-hand corner. Click a master template to view its instances.

By default, an instance has the same name as your virtual machine. By default, your virtual machine has the same name as the virtual machine template it is created from. Abiquo recommends that if you rename the virtual machine or the instance, you should keep a record of your changes to assist you in locating the virtual machine instances in the Apps Library.

You can manage instance templates in the same way as other appliance library templates. Templates that are in use cannot be deleted. Click on a different template to close the instances view.

Edit Virtual Machine Instances

You can edit a virtual machine instance template in the same way as other appliance library templates. Changes to the instance template definition will not affect the master template.

Promote Virtual Machine Instances

If you have permission to modify virtual machine templates in the Apps Library, you can Promote an Instance to a Master Template. This creates a new master template that includes a copy of the instance disk image and a separate definition. You can modify the definition in order to change the base configuration when you deploy a virtual machine with the copy of the instance disk image. It also allows you to delete the original instance if there are no virtual machines deployed with it. In the following screenshot, the Core_v1 instance has been promoted to a master template.

  • No labels