Abiquo 5.2

Skip to end of metadata
Go to start of metadata

Introduction

This document describes how to install a basic Abiquo environment using the Abiquo OVAs. This environment is called a Monolithic install of the Abiquo multi-cloud platform.

Required skills

Some essential system administration skills required for managing the cloud platform are as follows:

  • CentOS/RedHat Linux expertise for maintaining the Abiquo servers, which are Linux servers
  • Computer and network security expertise is required to configure and maintain the cloud platform
  • Advanced hypervisor knowledge including VM templates
  • Networking including design, switch configuration, VLAN and DHCP and/or SDN configuration
  • Storage including hypervisor datastores, NFS/CIFS and optional iSCSI storage

If you are testing Abiquo, you may not need all of these skills right away, but they are required to run a production environment.

Server components

Abiquo has the following key server components:

  1. Abiquo Server (Cloud orchestrator, API, UI)
  2. Remote Services (That do the work of managing the cloud, with one set per Abiquo DC)
  3. Optional monitoring Server (Manage VM and platform metrics data)

These components can be installed in different installation profiles.

Installation profiles

There are three main ways to install Abiquo:

  1. Monolithic server (small environment, also for labs and testing)
  2. Distributed environment (larger environment, better for production)
  3. HA environment (large, high performance environments)

This document describes how to install a Monolithic environment

A monolithic environment means that you have a single server with the Abiquo Server and Remote Services. And an optional Monitoring server.

If you want to test with large templates and you want better performance, then you may wish to install the remote service that manages template conversions on a separate server.

Before you install, prepare an NFS folder and your networks. Then install the Monolithic Server and the Monitoring Server from the OVA files.

(To get an idea of how all of this will look when you're done, see the diagram of the Monolithic environment below.)

For more details, see Abiquo Components

NFS folder

The platform will store the catalog of VM templates in an NFS folder. So make sure to prepare a folder with enough space to hold all your templates and a fast network connection. The platform will automatically mount the NFS folder on remote services and hypervisors.

When you deploy a VM, the platform copies the template from the NFS to the hypervisor datastore. The platform can also convert templates from one format to another (V2V), so if you are working with large templates and multiple formats, you may wish to install the remote service that manages this on a separate server.

Note the network address and folder name to enter during the Abiquo install process.

For more details, see VM repository folder

Networks

You will need to put the Abiquo Monolithic Servers and components on the same network, which we call the Management network.

The VM networks are a group, which we call the Service network. For these networks you will need the following:

  1. A range of VLAN tags for your VMs to use in private networks. Configure this in your network infrastructure and then enter the tags for each group of hypervisors when you configure your Abiquo Racks. Abiquo will assign a tag from the pool when it deploys the first VM in a private network.
  2. VLAN tags of other networks in your infrastructure that users can work with:

    1. Public networks (shared by all enterprises, users can purchase IPs)

    2. External networks (any kind of IP address, one tenant only).

Don’t forget to connect your hypervisors to the Service network… :-)

To assign IP addresses to VMs, Abiquo has a default DHCP configuration, which you can use in an isolated test environment. Abiquo also offers dnsmasq. 

For more details, see:

Appliance requirements

The Abiquo OVAs require at least the following virtualized hardware for your test environment:

  • 2 CPUs
  • 8 GB RAM
  • 64 GB HD

Monolithic Server install parameters

Before you begin the install, make sure you know the values of the following parameters that you will need to enter during the install process. 

Parameter

Description

Friendly hostname

The name the appliance will use internally. It is the entire FQDN the UI will have.

Management IP address

IP of the server’s NIC on the Management Network

Management IP netmask

Netmask of the Management network

Default gateway

Default gateway of the NIC on the Management network

DNS server list

IPs of DNS servers in a list, separate by spaces

NTP server list

Your servers will use these NTP servers to keep their clocks synchronized

Appliance public FQDN

Your users must be able to resolve this fully qualified domain name. It should be the same as the "Friendly hostname".

Abiquo Datacenter ID

This is an internal value that Abiquo uses to identify each private cloud datacenter, so it just needs to be unique for each private cloud datacenter

NFS template repository

Host details and folder name of NFS folder for storing the VM template catalog 

Abiquo Monitoring IPThis is the IP that the monitoring server will have.

Tip: you can note these values on a copy of the Monolithic environment worksheet. For examples, see Monolithic environment worksheet sample.

Install a Monolithic Server from the OVA

Follow the steps at OVA deployment.

Monitoring Server install from the OVA

The Abiquo monitoring appliance is optional. To deploy the Monitoring appliance, you will need to enter the following parameter.

Parameter

Description

Friendly hostname

The name the appliance will use internally. It is the entire FQDN the UI will have.

Management IP address

IP of the server’s NIC on the Management Network

Management IP netmask

Netmask of the Management network

Default gateway

Default gateway of the NIC on the Management network

DNS server list

IPs of DNS servers in a list, separate by spaces

NTP server list

Your servers will use these NTP servers to keep their clocks synchronized

RabbitMQ IP

The IP address where the rabbitmq runs. In monolithic environment it will be the ip address of monolithic server.

In distributed environment it will be the ip address of abiquo server.

Follow the steps at OVA deployment

Prepare your hypervisors

Abiquo supports VMware vCenter with access at the host or cluster level. 
Abiquo supports any kind of datastore that your hypervisor supports.
Your hypervisors will need to mount the NFS folder.
VM remote access is via WebMKS.

To work with vCenter clusters, see 

For general configuration, see VMware

Monolithic environment diagram

When you've completed the install, your environment should be like the one shown here.

For the connections to add to your firewalls, you will also find a table in the next section.

Monolithic environment firewalls

This section lists the ports you will need to open on each server in your test environment.

Abiquo Monolithic Server

Source

Destination

Input Port

Description

Client

Abiquo Monolithic Server

TCP 80

HTTP

ClientAbiquo Monolithic ServerTCP 443HTTPS

 To allow users to upload and download VM templates, you can allow an optional connection from users to this server (specifically the Appliance Manager Remote Service that handles this functionality).   

Abiquo Monitoring Server

SourceDestinationInput PortDescription
Monolithic ServerMonitoring ServerTCP 36638Watchtower

NFS Server

Source

Destination

Input Port

Description

Monolithic Server, Hypervisor

NFS

TCP/UDP 2049

NFS

Monolithic Server, Hypervisor

NFS

TCP/UDP 111

RPC

Hypervisors

SourceDestinationInput PortDescription
Monolithic ServervCenter or ESXi

TCP 443 

 
Monolithic ServerHyper-VTCP 135 
Monolithic ServerKVMTCP 8889 
Monolithic ServerPublic cloudTCP 443 

Allow ICMP

ICMP must be allowed between all components of the Abiquo platform, including hypervisors.


Browser requirements

Abiquo UI requires a screen resolution of at least 1024 x 768 for productive work. It is based on HTML5 so browsers must support these HTML5 features: Forms block, Drag and drop.

The Abiquo UI is optimized for use with Firefox and Chrome.

The cool infrastructure map uses Google Maps and the Google Maps Javascript v3 API. See How to Obtain and Install a Google Maps API Key

Next steps