Abiquo 2.6


Skip to end of metadata
Go to start of metadata

Add a Public Key for an Abiquo User Account

Access to a virtual machine in Amazon requires an RSA key pair. See http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html:

When you deploy a VM, Abiquo launches an instance and this must be done with a key pair. To connect to an instance, you will need the private key file that corresponds to the key pair that was selected when the instance was launched

You can generate your own key pair or get Amazon to generate one for you. See  http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/generating-a-keypair.html

You can create an RSA key in Linux using

ssh-keygen -t rsa
ssh-add id_rsa

By default the keys will be saved in a folder such as ~/.ssh and the public key in a file such as ~/.ssh/id_rsa.pub.

Abiquo stores a public key for a user and automatically adds them to Amazon virtual machines at deploy time.

To save a public key in Abiquo

Edit an Abiquo user who will use the public datacenter. You can do this in two ways:

    1. in Users view, by selecting the enterprise name, then the user name and clicking the edit button OR
    2. if allowed in your installation, cloud users can edit their user details by clicking on the user name in the top right-hand corner of the screen

Enter the RSA public key for the user.

Keep the private key in a safe place and supply to access your virtual machine on Amazon.

Create a Virtual Datacenter to Use Amazon Resources

Go to Virtual Datacenters view. Click on the + button at the bottom of the Virtual Datacenters list to add a new virtual datacenter.

Select the public datacenter from the pull-down list and select Amazon as the hypervisor. 

Select the Network as either Default or a Custom Private network.

The network created in an Amazon VDC can only be a private network. So the default network for the Enterprise will be ignored if it is an external, unmanaged or public VLAN. However, Amazon Elastic IPs are public IP addresses that are attached to an Abiquo unmanaged network

Click the Allocation Limits tab to restrict resource usage in the virtual datacenter

Click Save

You cannot move vApps between Amazon VDCs

Create a Virtual Appliance in a Public Datacenter

  • Layers are not available in Amazon virtual appliances
  • Amazon template details are not stored in Abiquo until you save a virtual appliance containing the template

To create a virtual appliance in Amazon:

Click the  button at the bottom of the Virtual Appliance page of the Virtual Datacenters view.

Enter a name for the virtual appliance.

Select your Amazon virtual datacenter. Click Accept

Filter Amazon Templates

Abiquo provides many different filters for Amazon templates and they are set by default because Amazon contains approximately 19,000 virtual machine templates. 

The Abiquo Flex client can retrieve up to a maximum of 100 templates with a single query.

FilterTypeComments
PrivateCheckbox 
PublicCheckboxTicked by default
32 bitsCheckbox 
64 bitsCheckboxTicked by default
OSSelector

Windows or Other. The default vallue is Other

IDFree text 
NameFree text

E.g. ami-0354b96a

DescriptionFree textThe default value is Ubuntu
Max. ResultsSelectorThe Abiquo flex client is limited to 100 results.
The default value is 10

Enter filter values and click Search.

The templates selected by the Search will be displayed in the left-hand Template Library pane.

Create a Virtual Machine in Amazon

Drag and drop an Amazon template into your virtual appliance.

 

Select an Amazon hardware profile.

Select a hardware profile to suit your Amazon template. Abiquo cannot detect how many resources a template requires, so it will allow you to create a virtual machine that cannot be deployed. If a deploy fails because of lack of resources, Abiquo will create an event.

Click Save to store the hardware profile.

Save the virtual appliance by clicking on the floppy disk icon in the top right-hand corner of the Virtual Machines pane, which is marked in red in the following screenshot.

When you deploy, Abiquo will create an Amazon instance.

Do Not Rename Amazon Instance in Amazon

Do not change the name of the Amazon instance in Amazon because this will break the link to Abiquo. This means that Abiquo will not be able to manage the instance any more.

Configure a Virtual Machine in Amazon

To configure an Amazon virtual machine, the virtual machine must be powered off or not deployed.

Move the mouse over the virtual machine icon and click the edit button that appears. The edit button is marked in red in the following screenshot.

The virtual machine configuration popup will open at the General Information tab.

Change the Hardware Profile

If the virtual machine is not deployed, you can change the hardware profile. If the virtual machine is deployed, you cannot change anything on this tab.

 

Change the Network Configuration

You can modify the network configuration of an Amazon virtual machine if it is:

  • Saved but not deployed
  • Deployed and powered off

Click on the Network tab to edit the network configuration. You cannot change the default network IP or add more NICs on the default network.

Do Not Add or Modify Elastic IPs in Amazon

Do not change the virtual machine's Elastic IP configuration in Amazon because this may cause problems in Abiquo

Add an Elastic IP

Click the  add button to add an Elastic IP. You can only add one Elastic IP to a virtual machine. 

 

  • Amazon charges for Elastic IPs that are allocated but NOT USED by running virtual machines. Therefore you should deploy your machine as soon as possible after adding an Elastic IP. 
  • Undeploying the virtual machine will not automatically remove an Elastic IP; you must remove the IP in Abiquo or delete the virtual machine or virtual appliance to remove the Elastic IP.
  • Elastic IPs are counted in your Abiquo Public IP allocation limits
  • You can only add one Elastic IP per virtual machine
  • You cannot move an Elastic IP from one virtual machine to another.
  • Do NOT modify the Elastic IP configuration directly in Amazon

Select Elastic IPs on the left, then click Accept .

When you first assign an Elastic IP, the IP address and MAC address will be "-". This is because the IP address and MAC are not assigned until the virtual machine is saved and reconfigured. Click Save to continue.

The Elastic IP address should be displayed as shown in the following screenshot. 

The Elastic IP will remain assigned to your virtual machine, even if you undeploy the virtual machine. When you redeploy the virtual machine, it will receive the same Elastic IP.

  • Remember that you will be charged for Elastic IPs that are assigned to machines but not in use
    • Remove Elastic IPs from deployed machines
  • The Elastic IP will be assigned to your virtual machine until you remove it
  • If you undeploy a virtual machine, the Elastic IP will still be assigned to it. 
    • You will be charged by Amazon until you redeploy the machine or remove the Elastic IP.

Remove an Elastic IP

An Elastic IP is removed when you:

    • remove the Elastic IP from the VM
    • delete the virtual machine
    • delete the virtual appliance

An Elastic IP is assigned to one virtual machine only. When you remove an Elastic IP from your virtual machine and then assign another Elastic IP, there is no guarantee that you will be assigned the same Elastic IP again. You cannot move an Elastic IP from one machine to another.

To remove an Elastic IP from a VM:

Shut down or undeploy the virtual machine. Edit the VM and open the Network tab

Click the Elastic IP, then click the  delete button

Click Save to process the change

Deploy an Amazon Virtual Appliance

To deploy a virtual appliance in Amazon, click the Deploy button. 

For example, inside your Virtual Appliance in Virtual Datacenters view, the deploy button is in the top-right corner of the Virtual Machines panel. The deploy button is marked in red in the following screenshot. 

Do Not Rename Amazon Instance in Amazon

Do not change the name of the Amazon instance in Amazon because this will break the link to Abiquo. This means that Abiquo will not be able to manage the instance any more.

Connect to a Deployed Virtual Machine

Access to a virtual machine in Amazon requires an RSA key pair. From http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html:

To connect to an instance, you will need a running instance and the private key file that corresponds to the key pair that was selected when the instance was launched

Click the eye button to open the Connection Information popup.

This will display information for connecting to your virtual machine.

VM User Names in Amazon

The username will depend on the AMI type. For example, for Amazon Linux templates it will be ec2-user. For Ubuntu templates it will be ubuntu. However, there are many commercial templates in Amazon that have different credentials. The template vendor will provide the login details.

VM Login Security in Amazon

To access a virtual machine, Amazon requires you to use the key pair that was added to the instance when it was created. This should be the key pair stored in your Abiquo user account.

See Amazon documentation on connecting to Amazon EC2 instances 

See also Amazon documentation with quick tips for Windows users

VM Host Name in Amazon

For example, to connect using ssh to access the Hostname: ec2-54-229-87-203.eu-west-1.compute.amazonaws.com

For example, to connect from another virtual machine in the Amazon virtual datacenter, we would use the private hostname: ip-192-168-0-6.eu-west-1.compute.internal

View Abiquo-Amazon Virtual Resources

In Virtual Datacenters view, click on an Amazon virtual datacenter to open it.

In Abiquo 2.6, Amazon virtual datacenters only have the Virtual Appliance and Network tabs activated.

Abiquo Amazon Networks

Abiquo creates a default network for an Amazon virtual datacenter. This default network is an Amazon VPC subnet, which is called a Private Connect network.

Each Amazon VM is automatically assigned an IP on this subnet.

You can assign Elastic IPs to your Amazon virtual machines. Abiquo will add these IPs to an unmanaged network.

Virtual Private Cloud Subnet

To view the Amazon VPC subnet, go to Virtual Datacenters view and click on the Network tab, and the Private networks page. 

Amazon reserves the first 5 IP addresses and the last IP address of the VPC private connect network. These IP addresses are not displayed or used by Abiquo.

The first virtual machine in the Amazon virtual datacenter was assigned IP address 192.168.0.6 on the private connect network.

Elastic IPs

To view Amazon Elastic IPs, go to Virtual Datacenters view and click on the Network tab and the External networks page. The Elastic IPs are part of an Abiquo unmanaged network.  

  • Amazon charges for Elastic IPs while they are not in use (i.e. when the virtual machine with the Elastic IP attached is undeployed), so release these IPs from virtual machines when they are undeployed
  • You can only add one Elastic IP for each virtual machine
  • You cannot move Elastic IPs from one virtual machine to another

Undeploy an Amazon Virtual Appliance

When you undeploy a virtual machine in a public datacenter, Abiquo will destroy the instance. However, the virtual machine configuration, including any Elastic IP will be maintained. If you deploy the virtual machine again, Abiquo will launch a new instance with the same template and configuration. Remember that you will be charged for an Elastic IP that is attached to an undeployed virtual machine.