Install a test environment

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, 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).
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. A
biquo 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

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 IP

This 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

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 the Monolithic server.

In distributed environment it will be the IP address of the 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 Add VMware vCenter clusters as servers.

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 ports and communications

 

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

Source

Destination

Input port

Description

Client

Abiquo monolithic server

TCP 80

HTTP

Client

Abiquo monolithic server

TCP 443

HTTPS

 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

Source

Destination

Input port

Description

Source

Destination

Input port

Description

Monolithic server

Monitoring server

TCP 36638

Watchtower

NFS server

Source

Destination

Input port

Description

Source

Destination

Input port

Description

Monolithic server, hypervisor

NFS

TCP/UDP 2049

NFS

Monolithic server, hypervisor

NFS

TCP/UDP 111

RPC

Hypervisors

Source

Destination

Input port

Description

Source

Destination

Input port

Description

Monolithic server

vCenter or ESXi

TCP 443 



Monolithic server

Hyper-V

TCP 135



Monolithic server

KVM

TCP 8889



Monolithic server

Public cloud

TCP 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

Copyright © 2006-2024, Abiquo Holdings SL. All rights reserved