Abiquo 5.3

Skip to end of metadata
Go to start of metadata

Introduction to Virtual Appliances

virtual appliance is like a folder that contains a group of one or more virtual machines (VMs). These VMs may be related and you can use them together to provide a service. You can manage each VM separately or deploy all the VMs in the virtual appliance together.  You must create VMs within virtual appliances. The Virtual appliances tab has a cards view and a list view.

Privilege: Manage virtual appliances

Create a Virtual Appliance

To create a new virtual appliance to hold a group of VMs do these steps:
  1. Go to Virtual datacenters
  2. Select a virtual datacenter
  3. Click Create virtual appliance 
  4. If a menu displays, select "Create virtual appliance" and complete the form as described here
  5. Click Save  




The name of the virtual appliance

Virtual Datacenter

The virtual datacenter where the virtual appliance will be deployed

DescriptionA description of the virtual appliance
IconOptional - URI of an icon to represent the virtual appliance

To open the virtual appliance after creation, select the checkbox

Now you can add VMs to the virtual appliance and deploy it.

For more details, see Manage Virtual Machines

Create a virtual appliance based on a spec

To create a virtual appliance based on a blueprint of a saved configuration:
  1. Go to Virtual datacenters → Virtual appliances
  2. Click Create a virtual appliance and select Create virtual appliance based on spec
  3. Click on a spec icon. Change the Name to make it unique in your environment. Then click select

     Click here to show/hide the screenshot

  4. The virtual appliance spec validation dialog will open. Move through the tabs and check or edit information as required
    • General information
    • Private networks: Create new networks or select existing ones
    • External networks: In vCloud, specs have basic support for external networks. The validation process will list the network, and you can select it and then continue with the process. The platform will create the VApp correctly. Remember to ensure that there are enough external IP addresses available for the new virtual appliance
    • Load balancers: Select a new algorithm and public or private addresses that are compatible with your provider
    • Templates: Select new templates to replace ones that are not available in your environment
    • VMs: Select and view, and if necessary, edit the VM configuration
    • Errors: The Errors tab only displays when there are errors that cannot be fixed within the spec. For example, you may be able to replace a template with another one of the same name, but if there is no similar template, Abiquo will not create a virtual appliance. In this case, Abiquo displays the Errors tab.
  5. After you have finished editing the virtual appliance, click Save
 Click here to show or hide the screenshots

Example screenshots:





VM variables

VM Chef runlist

VM Chef attributes


Deploy a Virtual Appliance

To launch your VMs, click Deploy virtual appliance above the Virtual machines pane on the right-hand side of the screen.

The platform will launch the VMs and power them on. The status bar below each VM icon will be coloured green. And the Deploy virtual appliance button changes to become the Undeploy virtual appliance button, which you can click to destroy the VMs.

Display VM workflow tasks

When workflow is enabled, the user's requests to deploy, reconfigure and undeploy VMs will be held with the status waiting to be reviewed. 

This can include actions on scaling groups, unless the administrator selects the option to disable workflow in the scaling group. 

To view the list of workflow tasks

  1. Go to Virtual datacenters → Workflow tasks.

To filter workflow tasks, enter text in the filter box at the top of the tasks list.

Display virtual appliances

To display virtual appliances
  1. Go to Virtual datacenters → Virtual appliances
  2. Change between Cards view and List view, using the selection symbols in the top right-hand corner of the screen

To filter virtual appliances, enter search text in the Search box

Card view

List view

Display metrics for a virtual appliance

Abiquo can display custom metrics for your virtual appliance and metrics for the group of VMs in the virtual appliance.

To display custom metrics for the virtual appliance:

  • On a Virtual appliance card, click the Monitoring button OR
  • Open a Virtual appliance and go to Monitoring tab Virtual appliance metrics page.

To display the metrics of the VMs in the virtual appliance, select the Virtual machine metrics page

To configure the display of metrics:

  • For the refresh interval, select the Refresh data every checkbox and enter a number of minutes. 
  • To filter metric statistics, click on the Filter button and select the granularity, statistic, time frame, and dimension, as required.

 Click here to show/hide the screenshots

Screenshot: Virtual appliance cards with Monitoring button

Screenshot: Virtual appliance metrics popup

Screenshot: Monitoring page for virtual appliance metrics

Screenshot: Monitoring page for virtual machines in a virtual appliance

Manage virtual appliances using the API

API Documentation

For the Abiquo API documentation of this feature, see Abiquo API Resources and the page for this resource VirtualApplianceResource.

Add tags to a virtual appliance

To manage tags for a virtual appliance: 
  1. Go to Virtual appliances → Edit a virtual appliance→ Tags
  2. Add tags as described below

To add a tag, enter the Key and Value, then click Add

To edit a tag field, click the pencil edit button 

To delete a tag, select the tag, then click the trash bin delete button.

To save your changes, click Save.

Save virtual appliance configuration as a spec

To create a virtual appliance spec to save a configuration:

Privileges: Manage virtual appliance specs

  1. Go to Virtual datacenters Open the virtual appliance
  2. Go to the virtual appliance options menu → select Create new spec
  3. Enter spec details
  4. Click Accept

The platform will create the new spec for your tenant. This spec will be the default, but an administrator can change or remove the default.




The name of the virtual appliance spec


Describe this spec and this version of the spec to distinguish it from other versions

IconEnter the URL of an icon that will identify the spec for users. Click Validate to check the icon will display correctly - a preview should display below the Icon field

When designing a virtual appliance for use in more than one location, please consider the following differences between private and public cloud:

  • Private cloud datacenters allow multiple disk templates and additional disks. In public cloud, the platform may support only a single disk or use all disks
  • Public networks in private cloud will be translated to floating IPs in public cloud and vice versa
  • A range of IP addresses may be reserved by an SDN system or the cloud provider
  • The number of NICs allowed or required per VM may vary
  • Firewall and load balancer configurations may differ

To save VM disks as templates, see Create instances to save VM disks to templates.

Copy or Move a Virtual Appliance in a datacenter

Abiquo is a hypervisor-independent cloud platform because its V2V conversion process allows users to move or copy any undeployed virtual appliance between virtual datacenters in the same physical datacenter, regardless of whether they use the same or different hypervisors. The platform copies the template disks of the virtual appliance but not the network configuration. So you will need to recreate the network configuration after move or copy operations. You cannot copy virtual appliances with persistent disks.

Privilege: Manage virtual appliances

To copy or move a virtual appliance in a datacenter:

  1. Go to Virtual datacentersVirtual appliances 
  2. Select a virtual appliance that is not deployed.
  • To Move, click on the crossed arrows move button of the virtual appliance icon, or the Name (in list mode), and drag it into the new virtual datacenter
  • To Copy, hold down the SHIFT key, then click on the move button or the Name of the virtual appliance and drag it into the new virtual datacenter

Screenshot: Move a virtual appliance to another VDC in the same private cloud datacenter


Prerequisites for Move and Copy Operations

Before the copy or move process can be started, the platform evaluates each VM in the virtual appliance for its template type and the availability of conversions.

 Click here to show/hide VApp Evaluation diagram

Undeploy a Virtual Appliance

Before you begin:
  1. If the virtual appliance is not synchronized with the hypervisor or cloud provider, first:
    • remove the undeployed VMs OR 
    • individually undeploy the deployed VMs OR
    • deploy all VMs

To undeploy a virtual appliance, which will destroy all VMs and hard disks on the hypervisor datastore:

  1. Go to Virtual datacenters → select Virtual appliance
  2. Click the Undeploy button on the right-hand side of the screen. 

If you redeploy the virtual appliance, the platform will make a fresh copy of the template disks.


Delete a Virtual Appliance

Before you begin:
  1. Undeploy the virtual appliance, which will destroy the VMs

To delete a virtual appliance:

  1. Go to Virtual datacenters → select virtual appliance
  2. Click the  delete button

The platform will delete the virtual appliance and all the VMs

Create VMs with high availability

Introduction to VM high availability with layers

In private cloud, to create VMs that will always deploy on separate hypervisor hosts, use anti-affinity layers. Each VM in a layer will deploy on a different hypervisor host. 

Privilege: Manage virtual appliances, Manage layers

Abiquo does not support layers that intersect with other layers. For example, this means that if you have two layers, a VM in the second layer may deploy on the same physical machine as a VM in the first layer.

Ideally you should design and implement your layers before you deploy your VMs.

This feature is not available in public cloud regions. Instead you should use the high availability solution offered by the public cloud, for example, Amazon Availability Zones, which can be accessed by deploying with NICs attached to subnets created in different zones, or Azure Availability Sets.

Create VMs in antiaffinity layers for high availability 

Before you begin: 
  • Design your layers:
    • You cannot rename a layer when there are deployed VMs in the layer
    • You cannot move a deployed machine into a layer with a VM deployed on the same hypervisor

To create a layer:

  1. Click the Add a layer button 
  2. Enter the layer name.
  3. Add VMs to the layer 

 Click here to show/hide the screenshots

Layers ensure that VMs deploy on separate hypervisors, so the following rules apply:

Layer TypeRules
New layer
  • You can add any VM to a new layer
Layer with deployed VMs
  • You can add a VM that is not deployed
  • You can add a powered-off VM if it deployed on a different hypervisor from the other VMs in the layer
Different layer
  • You cannot move a deployed VM directly to a different layer. First, power off the machine and remove the machine from the old layer, then delete the old layer. Now you will be able to add the machine to a different layer.
 Click here to expand...

Web stack use case for layers

The following diagram shows a possible anti-affinity layers use case of a simple web stack.

In Abiquo, you could deploy this configuration as follows:

  • ApplicationServers layer: Tomcat1, Tomcat2
  • DatabaseServers layer: Database1, Database2

VMs not in layers: Apache server(s), firewall, load balancer

If the deploy of a virtual appliances with layers fails, it may be because there are not enough physical machines available in your virtual datacenter. Or some physical machines may be reserved for specific enterprises, for example. Check with your system administrator.

Modify a virtual appliance with antiaffinity layers

You can only make changes to layers that will not compromise anti-affinity while your VMs are deployed or running.

To change the name of a layer:

  1. Check that all the VMs in the layer are not deployed, which means they are in the NOT_ALLOCATED state. For example, they are new in a virtual appliance that is deployed or they are in a virtual appliance that has been undeployed.
  2. Next to the layer name, click the pencil Edit button. 
  3. Enter the new layer name

To remove a VM that is not deployed from an anti-affinity layer, drag the machine outside the layer and into the general VM area

To remove one or more deployed VMs from a layer:

  1. Shut down the VMs 
    • You do not have to wait for each one to finish shutting down before moving to the next one
  2. One by one, drag each VM out of the layer into the general VM area

To delete a layer:

  1. Power off all the VMs
  2. Remove all the VMs except one from the layer
  3. Delete the layer

The layer will be deleted and the VM will be moved to the general VM area. 

Delete a Layer Before it is Empty

You can delete a layer if only one VM remains, even if the VM is deployed and powered on. The VM will remain powered on and it will be moved to the general VM area.

To move deployed VMs between layers, you must move the VM out of one layer before you move it into another.  You cannot move a deployed VM directly from one layer to another.

To move a deployed VM to a different layer:

  1. Power off the VM
  2. Move the VM to the general VM area
  3. If the new layer does not already exist, create the new layer
  4. Add the VM to the new layer


Pages related to virtual appliances

  • No labels