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

Manage Racks and Machines

The PHYSICAL SERVERS list is on the left-hand side of the datacenter pane.

The buttons below the PHYSICAL SERVERS list are used to manage racks and machines.



Create a rack or add a machine. If there are no racks in your datacenter, click the add button to Create a Rack. If a standard rack is selected, click the add button to Create a Physical Machine on the selected rack.

Delete a rack or remove a machine.

Edit the selected rack or machine.

Refresh the resources used on the selected machine and synchronize the virtual infrastructure (Virtual machine in the UNKNOWN state)


Create Standard Racks

General Information Tab 

Complete the following fields to create a standard rack.

Network Parameters Tab 

Complete the following Network Parameters. 

Create Machines

To add a machine, first select a rack, then click the add button. If there are no racks in your datacenter, the add button will open a popup for Creating Racks. Abiquo uses the Discovery Manager remote service to automatically discover machines and retrieve their details with two options: basic or advanced discovery. 

Discover a Machine

In the drop-down menu of the Infrastructure Screen, select the 'Physical Machine' option.

Enter the Hypervisor type of the machine to add:

Enter the connection details for the hypervisor:

Using the connection details, the Discovery Manager will try to connect with the Hypervisor running on the machine.

Abiquo will automatically complete the default hypervisor user, password and port set in Configuration View (see Create New Infrastructure Defaults).

  • If the default user and password match those of the machine, the Discovery Manager will show the Create Physical Machine popup at the General Information Tab with the discovered values completed.
    • Otherwise Abiquo will give the 'Invalid Credentials' login exception error.

Then Abiquo will open:

  • The main Create Physical Machine popup with the hypervisor details; or
  • If the hypervisor is a master hypervisor, then the Multiple Hypervisor selection popup will open.

Create a Master Hypervisor

To add an Oracle VM master hypervisor, select the hypervisor type from the pulldown list.

Enter the Oracle VM connection data. If you do not enter the optional Manager Port, Abiquo will use the default port described in Ports and Communications

The Multiple Hypervisor selection popup will open with a list of the hypervisors managed by the master hypervisor.

By default, the Import existing virtual machines checkbox is ticked.

Select the hypervisors you wish to add.

You will need to complete the process to Create a Machine for each of these hypervisors. Click Edit beside a hypervisor to open the main Create Physical Machine popup for that hypervisor. After you complete the details in this popup, the Incomplete warning will be removed from beside the physical machine.

Mark the checkbox beside your hypervisors to add them to Abiquo.

Click Accept to complete the process.

Create a Machine

After Abiquo has automatically discovered the physical machine, complete the information on the tabs of the Create Physical Machine popup.

General Information Tab

This table describes each field in the form:




The name of the machine (usually set to its hostname).


The rack where the machine will be added.


An optional description of the machine.


The number of CPUs are retrieved from the machine and cannot be changed.


The RAM is retrieved from the machine and cannot be changed. Choose units for display of RAM (MB or GB)

Hypervisor Type

The type of virtualization technology.


The IP address of the machine in the management network.


The user for the hypervisor connection (for XenServer, Hyper-V and ESXi)


The password (for XenServer, Hyper-V and ESXi)

PortPort (ESXi, ????) or AIM port for the connection (KVM)


The state of the machine, see #Physical Machine States. Click 'Check' to update the state

Import existing virtual machinesTick this checkbox to import virtual machines already running on the hypervisor host


Network Interfaces Tab

On the Network Interfaces tab, you can tag the virtual switches or physical NICs to use for virtual machine network connections. The network service type is a tag that enables and identifies a network in Abiquo. After you tag the network interfaces, you can tag external, unmanaged and public VLANs to use these interfaces.

Before you can assign a network service type Manage Network Service types, create it on the Datacenter's Networks tab. See Manage Network Service Types on the Manage Network Configuration page.

Select a service type from the the drop-down list to assign it to the network interface. The default Network Service Type is called Service Network

Abiquo will list  ALL  the NICs and virtual switches on the machine, including those that are not suitable for use with virtual machine networks Abiquo.   Usually the default network interface for use with virtual machine networks will be as follows.

HypervisorDefault InterfaceExample
ethxeth0, eth1
vSwitchx or
vSwitch0 connected to VMNICx
Hyper-VAs named during installationSERVICE_NETWORK

Abiquo recommends that you check the network interfaces with your Network Administrator.

Detecting New Network Interfaces

New network interfaces will be detected when you:

  • check the state of the machine 
  • click the refresh button 
Changing a Network Service Type

You cannot change the network service type assigned to an interface if there are virtual machines deployed with virtual NICs using addresses in the network. To change a network service type, first remove it from the existing interface by setting this to "Not assigned". Then assign the network service type to a different interface.

Disabling a Network Interface

To disable the NIC so that it cannot be used in Abiquo, select "Not assigned".


Manage IPMI for Abiquo High Availability

On standard racks Abiquo uses IPMI in the high availability (HA) process to shut down a machine that is not responding. Click IPMI tab to edit the IPMI parameters. On managed racks, Abiquo HA uses the API of the managed rack to control the machine.

For further information about Abiquo high availability, see Configuring High Availability of Virtual Machines in the Administrator's Guide.

Manage Datastores

In Abiquo, datastores include the disks used by the hypervisors to store information related to the virtual machines and the NFS repositories. When you create a machine, you will see a list of all the datastores that are installed on that machine. For some hypervisors this list includes the NFS repository (usually /opt/vm_repository), which should not be used as a hypervisor datastore. New datastores will be detected when a machine check is performed.

To edit datastore details, select the datastore and click the Configuration button. To enable a datastore, select the datastore and mark the Enabled checkbox. The Abiquo datastore allocation process will deploy a VM on the enabled datastore with the most available space.

Add an Additional Datastore

If you require more disk capacity on a hypervisor, you can add a new datastore. First, configure the disk on the machine and in the hypervisor, then edit the physical machine in Abiquo. On the General Information tab, click "Check" to check the state of the machine. Go to the Datastores tab and you should see the new datastore, then click Enabled. The datastore allocation process will deploy VMs to the datastore with the most available space.

Datastore Best Practice - Do Not Enable the NFS Repository

Wherever possible, the datastores list does not include the NFS repository because it is an internal datastore that is used to share images between the NFS server and the hypervisor. If the NFS Repository is visible in the datastores list, you should not enable it as a hypervisor datastore because deployment over a network to the same NFS shared directory from which the virtual image templates are being copied will severely degrade performance.

Retrieve and Import VMs from Enabled Datastores Only

If you wish to retrieve and import VMs that are already running on your physical machine, you must enable all the hypervisor datastores that contain these VMs. Abiquo does not retrieve persistent VMs because their system disks are located on external volumes.

Available Space

Abiquo runs a periodic infrastructure check process to update infrastructure values in the Abiquo database, including the real disk space available on a datastore. However, at deployment time, Abiquo only checks the database values. The datastore allocation process will deploy using the hypervisor datastore with the most available space.

Datastores in High Availability

Abiquo High Availability of Virtual Machines requires all the hypervisor hosts involved to share the same datastore, which must be enabled for deployment of virtual machines. This will allow Abiquo to restart machines in other hypervisors from the shared datastore. High availability does not copy virtual machine system disks. Thus, if none of the other high availability hypervisors can see the datastore used by a hypervisor, the virtual machines using this datastore will not be restarted. Therefore, you should enable only shared datastores (and disable other datastores) on high availability hosts and ensure that the shared datastore is available to all other high availability hosts in the same group.

Create Multiple Machines

You can use this feature to enter a defined range of IPs and register multiple existing physical machines with these IPs into Abiquo. For each IP, the Discovery Manager will check if the physical machine has the requirements established in the Multiple Physical Machines screen. The main difference from adding a single Physical Machine is that you will not see the confirmation screen with the physical machine parameters.

In the drop down menu of the Infrastructure Screen

Select the 'Multiple Physical Machines' option to open the following screen and enter the details of the machines.


Edit Racks

API Documentation

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

To edit a rack, select it in the rack list and press the Configuration Button  in the lower right corner of the PHYSICAL SERVERS pane.

You can change the same rack values that are used when creating racks.


You cannot modify the network parameters of a rack to exclude a VLAN ID from the range or as a specific exclusion if there are any virtual machines deployed in a network using that VLAN tag ID.


Control Machines

A summary of the properties of a machine appears below the virtual machines pane when the user selects a physical machine on several tabs:

  • General
  • Description
  • State

In addition, the following buttons enable the user to control machines. These buttons are described in Compute Resources in Datacenters

Send email to owners
Retrieve virtual machines
Capture retrieved virtual machines
Delete retrieved virtual machines that were not imported
Power on / Power off
Disable machine OR Enable machine


Delete a Rack

To delete a rack, first check there are no virtual machines deployed on its machines. You cannot delete a rack with virtual machines deployed on its machines.

Select the rack in the rack list and press the Delete Button  in the lower left corner of the PHYSICAL SERVERS pane. The rack will be deleted.