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

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Div
classtocc
Table of Contents
Excerpt
Div
classprivileg
Privilege2
Edit virtual appliance
Edit virtual appliance
1details

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.

Info
titleEdit 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.

Note
titleImported 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.

Note
titleDeleting 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

Info
titlePower 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.
Div
classprivileg
Privilege2
Edit virtual appliance
Edit virtual appliance
1details

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.

Pagesbreak

Info
titleDefault 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:

Button/Action

Action

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.

Pagesbreak

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.

Info
titlePublic 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

Info
titlePower 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.

Div
classprivileg
Privilege2
Edit virtual appliance
Edit virtual appliance
1details

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
Div
classprivileg
Privilege2
Edit virtual appliance
Edit virtual appliance
1details

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".

Note
Problem Adding Volumes to Virtual Machines on VMware Hypervisors
Problem Adding Volumes to Virtual Machines on VMware Hypervisors

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
Info

This functionality is supported on:

  • ESXi
  • Oracle VM
  • Hyper-V 
Div
classprivileg
Privilege2
Manage virtual machine
Manage virtual machine
1hard disks

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.

Note
titleUndeploy 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.

Pagesbreak

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.

 

Hypervisor/
Capability

Primary /system
disk

Secondary/ datastore hard disks

Volumes of
External storage

Controllers

Comments

ESXi

(tick)

(tick)   

(tick)

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

thin provisioning required

Oracle VM

(tick)   

(tick)   

(tick)   

(tick)  


 

Hyper-V

(tick)   

  N/A

(tick)    

(tick)   


 

KVM

(tick)   

  N/A

(tick)   

(tick)   


 
Warning
titleUsing 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
Div
classprivileg

Privilege2
0Manage virtual machine
1hard disks

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.

Warning
titleUsing 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

Excerpt Include
Abiquo Backup Front-end
Abiquo Backup Front-end
nopaneltrue

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.