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

Deploying and Undeploying Virtual Appliances

API Documentation

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

If you have the privilege to deploy and undeploy virtual appliances, you can do this from the Virtual Appliance Configuration Screen using the  deploy button. If you deploy from this screen, a deploy progress popup will display, as shown below. When the virtual appliance is successfully deployed, the  deploy button changes to a green color. Virtual appliances can also be deployed or undeployed from the Virtual Datacenters View as explained in Basic Operations.

The Force refresh button will update the status of the virtual appliance during deployment.


What Happens When I Click Deploy

A simplified description of the deploy process is shown in the following diagram.

Abiquo Workflow Feature

The Abiquo workflow feature enables you to control deploy, undeploy and reconfigure tasks for virtual machines and virtual appliances through integration with a remote workflow tool. Abiquo will send a task request to the URL workflow endpoint configured in the Abiquo platform. The workflow tool can then continue or cancel the Abiquo task by responding to this request. Abiquo will wait for the response from the workflow tool.

See Abiquo Workflow Integration and Manage Workflow Tasks

Virtual Appliance Notifications

When an error occurs during virtual appliance deployment, the user and cloud administrator are notified and the error appears in the notification area:

Click the notifications link to read pending notifications. Notifications can also be viewed in the virtual appliance details in the Virtual Appliances tab in Virtual Datacenters View.

Modifying a Running Virtual Appliance

When a running virtual appliance is modified (by adding or removing virtual machines), new virtual machines are marked with a plus icon and the Update Running Appliance  button appears near the deploy/undeploy  button.

To apply the changes in the virtual appliance to the hypervisor, click the Update Running Appliance button. For example, to deploy new virtual machines in a virtual appliance that already has some virtual machines deployed. Until you click the Update Running Appliance button, the virtual appliance will not be synchronized with the target hypervisor.

Updating a Running Appliance

We strongly recommend you keep all virtual appliances updated and synchronized in the hypervisor to avoid errors.

A running virtual appliance with a new virtual machine added and saved is shown in the image below. In this case, you would click Update Running Appliance to update the virtual appliance in the hypervisor.

Control Virtual Machines

After you deploy a virtual appliance in Abiquo, control its virtual machines with the virtual machine control panel buttons. Open the virtual machine control panel from:

  • Virtual Datacenters view - open the virtual appliance and click the virtual machine
  • Infrastructure view- click the virtual machine in the list of virtual machines on the physical machine
    • Remember that full functionality is only available for virtual machines deployed in Abiquo, not imported virtual machines





Power on or off the virtual machine. Green when the machine is powered on


Suspend or restart the virtual machine. Orange when the machine is paused. Not available on Xen hypervisors


Reboot the virtual machine. Grayed out when not available. Not available on KVM and Xen hypervisors

Remote Access

Open a remote access window on the virtual machine. See Configuring Remote Access to Virtual Machines

Send Email

Send a mail to the owner of the virtual machine. Must be configured in the Server/API Properties of Abiquo Configuration Properties

Capture VM

Capture this remote VM. See How to capture a remote virtual machine