Introduction

The server appliance contains the Abiquo UI, API, and Events servers.

The datanode appliance contains the database cluster and the Abiquo services. Abiquo uses the services, such as RabbitMQ and Redis, in communication between the API server and other platform components.

Requirements

You will need the following virtual resources.

Server

• 2 CPUs

• 8 GB RAM

• 64 GB HD

Datanode

• 2 CPUs

• 8 GB RAM

• 20 GB HD

The template repository folder must be present and fulfill the requirements as stated on the Installation page

Install the API UI server

This section describes how to install the API UI server.

1. Download the server OVA file and launch it.

2. Enter the standard parameters as follows:

   1. Friendly hostname, e.g. server-ova, which must be a valid Linux hostname

   2. Management interface IPv4 Address, e.g. 10.60.10.100, which should be a static network configuration

   3. Management interface IPv4 Netmask, e.g. 255.255.255.0

   4. Default Gateway, e.g. 10.60.10.1

   5. Space separated DNS Server list, e.g. 10.60.10.1

   6. Space separated NTP Server list, e.g. 10.60.10.1, which is required for features that depend on clock synchronization

3. Enter the API/UI Server parameters

   1. Abiquo API server FQDN, e.g. server-ova.abiquo.com

      1. This FQDN must be resolvable from customer premises for SSL and the Appliance manager to work properly

   2. Remote Services IP, e.g. 10.60.10.100

   3. Watchtower IP, e.g. 10.60.10.102

Datanode

Installation parameters

1. Log in to the API/UI server as an administrator

2. To use the separate database on the datanode server, edit the tomcat configuration at /opt/abiquo/tomcat/conf/Catalina/localhost/api.xml

3. Change the DB endpoint from localhost to the Galera cluster (datanode server)
   Remove:

   driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/kinton?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8"/>

   Add this line and replace {DATANODE_IP_ADDRESS} with the IP address of your datanode server:

   driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://{DATANODE_IP_ADDRESS}:3306/kinton?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8"/>

4. Change the user and password. If you need more information, please contact Abiquo Support

5. To point to the datanode instead of the local host for RabbitMQ and Redis, edit the abiquo.properties file at /opt/abiquo/config/abiquo.properties:

6. Change the values of the following properties to be the IP address of the datanode

   abiquo.rabbitmq.addresses={DATANODE_IP_ADDRESS}
   abiquo.redis.host={DATANODE_IP_ADDRESS}

Firewalls

Server firewall requirements

Datanode Firewall requirements

Post-OVA install steps

After you install the OVAs, do the configuration described on this page:

Post-OVA configuration for Distributed scalable

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.

Next steps

• For a quick introduction to the platform, do the Abiquo quick tutorial

• After that, to present the platform to others, try the Abiquo quick walkthrough of private cloud

• To read more details about the platform, see Get started

• For more complete user manuals, see Abiquo cloud guides

• To get started with the Abiquo API, see The Abiquo API and, in particular, Get started with the Abiquo API