Abiquo 2.6

Skip to end of metadata
Go to start of metadata

Prepare to Configure a Virtual Machine

After you configure your virtual appliance and add virtual machines, you can configure virtual machines before deployment or reconfigure after deployment. When configuring before deployment, first save the virtual appliance. When reconfiguring after deployment, power off the virtual machine.

Edit Network with Power Off

You only need to power off (not undeploy) a virtual machine to edit the network configuration. However, Abiquo recommends that you configure the network before deployment.

Imported Virtual Machines

In Abiquo 2.6, you can configure imported virtual machines in the same way as virtual machines created in Abiquo

1.a. If the virtual appliance is not deployed, click the floppy disk icon to save the virtual appliance.

1.b. If the virtual appliance is deployed, power off the virtual machine by clicking the Power button on the right. The indicator on the left should turn red.


2. Click the configuration button  to edit the virtual machine configuration.

Configure Virtual Machine General Information

Click the configuration button to edit the virtual machine and you will see the General Information tab. Note that some of the other virtual machine configuration tabs may not be visible, depending on your datacenter configuration and privileges.

After you make your changes click Save. If the virtual appliance is deployed, click "Update Running Appliance".

Virtual Machine Names and Power On Order

Virtual machines will be powered on in ascending alphanumerical order. Thus it may be helpful to number your virtual machines in front of the their names. As an example, 1_WebServer will power on before 2_Database. You should remember that although the virtual machines will be powered on in this order, there is no guarantee that the machines will finish powering on in the same order.

Hard Disk

This Hard Disk field cannot be modified in the Abiquo GUI. It is the amount of space allocated to the system disk of the virtual machine. From Abiquo 2.2 thin provisioning has been enabled in ESX/ESXi. Virtual machine system disks attached to SCSI controllers can be resized using external tools, for example, vCenter. The periodic Abiquo infrastructure check will detect changes to the allocated size and these changes will be reflected in platform statistics and accounting, as well as the VM general configuration page.

Enable Remote Access

 On hypervisors that do not support remote access, the eye icon may provide details about how to connect to your virtual machine.

If remote access to virtual machines is enabled for your datacenter in Configuration View and compatible with your hypervisor in Abiquo, you can enable or disable remote access on your virtual machine. Remote access details are only available for deployed virtual machines if you have the View datacenter details privilege.

Configure a Remote Access Password

If remote access is enabled, you should set a remote access password for the virtual machine.

By default Abiquo will generate a random password for your virtual machine.  Tick the checkbox to show the password.  You can change the password but it must be:

  • a maximum of 8 characters
  • alphanumeric characters only, i.e.  [a..z][A..Z][0..9]. 

This password will be required to enter the shell window through the  eye icon on the left of the virtual machine control panel. 

If you delete the password, the screen requesting the password will not appear.

if you have the administrator privilege to View datacenter details, you will see the IP address and Port for Remote Access as shown in the above screenshot. Without this privilege they will not be displayed for your virtual machine.

Deleting the remote access password in ESX hypervisors

In ESX hypervisors, if you set a password and later delete it, the password will be blank, not null. The screen requesting the password will always appear, even if the password is blank, and you should press <Enter> to continue.

If the virtual machine is deployed when you change the password, the change will be applied when you save the virtual appliance by clicking the floppy disk save icon.

Manage VM Network Interfaces

Power Off to Edit Network

If the virtual appliance is not deployed, save the virtual appliance. If the virtual machine is deployed, power off the virtual machine to edit the network.

Abiquo offers the following types of networks for virtual machines:

  • private networks with private IP addresses that only allow your virtual machines to communicate with others inside the same virtual datacenter.
  • public networks with Internet addressable public IP addresses.
  • external networks that belong to an enterprise and allow virtual machines to communicate with machines outside their virtual datacenter.
  • unmanaged networks are external networks with IP addresses allocated outside of Abiquo, so you cannot configure them inside of Abiquo.

You can add your virtual machines to the networks that have been configured for your datacenter and virtual datacenter. For each virtual machine, your administrator may limit:

  • the number of network interfaces 
  • the number of network interfaces on the same VLAN 

Click the configuration button to edit the virtual machine network configuration.

Default Network Configuration

Each virtual datacenter has a default network. The default network may be of any network type, as configured by your administrator. If you do not configure a network interface for your virtual machine, when you deploy the machine, the platform will automatically assign an address in the default network.

In the Virtual Machine Configuration popup, the Network tab lists all the network interfaces (NICs) that will be attached to the virtual machine. The NICs are shown in attachment order. You can drag and drop to change this order.

To manage the network interfaces attached to a virtual machine, you can:



Create a new NIC for the virtual machine

Remove a NIC from the virtual machine. You cannot remove a NIC if it has the default gateway address

Drag and Drop

Reorder network interfaces

In the Default gateway box, select an address to be the default gateway of the virtual machine. Change the gateway by selecting a new one from the list. You can click the red delete button  to remove the default gateway.

Create a New Network Interface

To add a new network interface to the virtual machine, click the  button. Select the network type of the new IP address: Private, External or Public, then click on the corresponding tab. Then select the VLAN from the left panel of your chosen network tab, and then select the IP address. Click Accept. Then back on the Network tab, click Save to confirm your changes.

Public IP Addresses Purchased

In the Public tab, you will only see the public IP addresses that have been configured in Infrastructure View and reserved for the Virtual datacenter as explained in Network Management.

When you add a public IP to the virtual machine, the IP's VLAN gateway is automatically made the default gateway of the virtual machine. Click Save to confirm this change. You will see the following info message:

Click the floppy disk icon to save the virtual appliance.
If the virtual appliance is deployed, click Update Running Appliance.

Reordering Network Interfaces

You can drag and drop network interfaces to change their order. Click Save to confirm your changes.

Configure Storage

Power Off to Configure Storage

Power off the virtual machine to configure storage.

The Storage tab of the virtual machine configuration popup contains a list of a the storage elements attached to the virtual machine in attachment order.

There are two types of storage:

  • volumes of managed storage 
  • hard disks on the hypervisor datastore.

Use the add and delete buttons to attach and detach storage. After you click the add button, you will see a popup with the tabs you have access to: Volumes and/or Hard Disk.

Attach Volumes of Managed Storage

Click on the Volumes tab to add a volume of managed storage to provide persistent storage in external storage devices. This tab lists the volumes that were created in the virtual datacenter as explained in  Manage Virtual Storage and  Manage External Storage . Also, you must have the  Assign volumes to virtual machines privilege in order to configure virtual storage.

Select the volume or volumes you require and click Accept to continue.

After editing the virtual machine, click the floppy disk icon to save the virtual appliance. If the virtual appliance is deployed, click "Update Running Appliance".

If a volume does not attach properly but you do not see an error message, a problem may have occurred in the storage device outside of Abiquo. Contact your Administrator to resolve this problem.

Create Hard Disks on Hypervisor Datastores

This functionality is supported on:

  • ESXi
  • Oracle VM
  • Hyper-V 

The display of the Hard Disk Tab is controlled in Configuration View#General Tab and with the Manage virtual machine hard disks privilege.

You can create secondary hard disks on the hypervisor datastore on VMware hypervisors. These hard disks will always be attached to a SCSI controller on the virtual machine. These secondary hard disks are not persistent: they will be deleted from the hypervisor when you undeploy the virtual machine. They are not included when you create an instance or a persistent virtual machine.

Undeploy Deletes Hard Disks

The hard disks you create on this tab and all data on them will be deleted from the hypervisor when the virtual machine is undeployed. To maintain data after you undeploy, use persistent virtual storage volumes as described in #Configure Persistent Volumes.

To add a hard disk, click the add button, then the Hard Disk tab. Enter the size of the hard disk. Then click Accept to create the hard disk. The hard disk will be shown in the attachment order on the Storage tab.

After you have finished making changes to the virtual machine, click Save to reconfigure the virtual machine with the extra hard disk.

Detach Volumes and Delete Hard Disks

Click the delete button to delete a hard disk or detach a volume of virtual storage. Click Yes to confirm the delete or detach operation.

Reorder Storage Elements

To change the attachment order of storage elements on a virtual machine, move the mouse over the storage element. Click the pencil icon that appears.

Enter the new attachment order number in the box and click OK. Edit other disks as required. Ensure that each disk has a unique attachment order.

When you have finished making changes, click Save. The elements will be reordered in the virtual machine configuration.

Click Close to reconfigure the virtual machine with the new configuration.

Resize Disks


You can expand a virtual machine primary system disk or secondary hard disk at deploy time or in an existing deployed VM on demand.

You may need additional space on a hard disk, for example, to add service packs/hotfixes, logs, increased swap disk space or temporary system disk space, or for growing installed applications.  

The following table describes Abiquo disk resize capabilities on different hypervisors. A green checkmark (tick)   means maximum compatibility with disk types, controllers, etc.



Primary /system

Secondary/ datastore hard disks

Volumes of
External storage







iSCSI disks on SCSI only.
See, for example,
VMware knowledge base article

thin provisioning required

Oracle VM


















Using Expanded Disks

Expanding a disk can damage the data or operating system installed on the disk. You may need to apply additional operating system tools or processes before you can use an expanded disk.

Resize a Hard Disk

If you have the  “Manage virtual machine hard disks” privilege, t o resize a hard disk, first edit the virtual machine and go to the Storage tab.

Select the hard disk from the list and  click the edit button at the bottom of the tab.

Enter the new size, which must be larger than the current size.

Using Expanded Disks

Expanding a disk can damage the data or operating system installed on the disk. You may need to apply additional operating system tools or processes before you can use an expanded disk.

Configure Virtual Machine Backups

If backups are configured in your datacenter, when you configure your virtual machine, you will see the Backup Configuration tab.

Configure Backup Type

If you have the privilege to Manage virtual machine backup configuration, you can set the basic backup configuration for your virtual machines. This means you can choose the basic backup type and the disk.

Click on the Backup Configuration tab, then click on the Backups page.

  • Click the checkbox to enable backup

  • Select backup options from those available in your datacenter

Select Disks for Snapshot or Complete Backup 
  • Click Select Disks
  • Select the disks for backup 
    • The disks are shown in sequence order
    • The system disk is the first disk in the list
  • Click OK to confirm

Enter a Path for Filesystem Backup

For a filesystem backup, enter the folder or directory path to back up. Click Add to add the path to the list.

To remove a path, click the x beside it in the Path list.

Click Close to continue

Configure Backup Schedule

If you have the additional privilege to Manage virtual machine backup schedule you can further configure your virtual machine backups. This means you can configure the exact date and time of a backup.

Be careful when configuring the backup time.

Backup Times

Abiquo uses ISO 8601 and users should be informed of the time standard used in the datacenter

Time zones in ISO 8601 are represented as local time (with the location unspecified), as UTC, or as an offset from UTC


View the Results of Latest Backups

Click on the Latest Backups page to view the results of your latest backups. The results shown may vary depending on your datacenter's backup system.


User Backup Events

When you change the virtual machine's backup configuration, the backup feature will produce the events described in the following table.


Event Identifier

Event Description


Backup Configuration for virtual machine 'entity.name' has been modified.

Configure Chef Recipes and Roles

The Chef tab is enabled if the enterprise is Chef-enabled and the virtual machine template is Chef-enabled.

Opscode Chef is an infrastructure automation product that uses configuration recipes. You can use Abiquo Chef Integration to deploy a virtual machine that will then configure itself using Chef recipes and roles. Chef-enabled virtual machines are marked with the Chef logo .

Before the virtual machine is deployed, you can select from the available roles and recipes. These will be added to the machine's runlist. When the machine is deployed it will download the roles and recipes, and run them in order. Click the Chef tab. By default on this tab you can select roles. Mark the "Select individual components" checkbox to select individual recipes too. The selected recipes will be added to the Virtual Appliance's runlist in order of selection.

Drag and drop the roles and recipes to change the order in which they will be run.

Change the Order of Roles and Recipes After Deployment

After deployment you can change the runlist order with drag and drop. The Abiquo Chef Agent will connect to the Chef Server and update the runlist.

See also Configuring and Using Abiquo Chef Integration in the Abiquo HOWTOs and Troubleshooting Abiquo Chef Integration in the Administrator's Guide.