Deploy distributed scalable server and datanode

This section describes how to deploy the Server and Datanode in a Abiquo distributed scalable environment.
At the end of this deployment, you should be able to log in to the UI and create a user

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 NFS repository folder for VM templates must be present and it must be able to be mounted and accessible on servers and hypervisors
The FQDN of the Abiquo API server must have DNS resolution

Install the API UI server

This section describes how to install the API UI server.

Download the server OVA file and launch it.
Enter the standard parameters, which are 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
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.110
3. Watchtower IP, e.g. 10.60.10.102

Datanode

We will deploy a single datanode server to form a cluster of one node. Later, you can easily deploy more nodes and add them to the cluster.

Download the datanode OVA file and launch it.
Enter the standard parameters for the datanode server. The description of the parameters is the same as above
1. Friendly hostname, e.g. datanode-ova, which must be a valid Linux hostname
2. Management interface IPv4 Address, e.g. 10.60.10.185, which should be a static network configuration
Enter the datanode server parameters
1. Services cluster IPs, e.g. 10.60.10.185, which is the IP of this server because the cluster will only have one node

Post install steps

Server

Log in to the API/UI server as an administrator
To use the separate database on the datanode server, edit the tomcat configuration at /opt/abiquo/tomcat/conf/Catalina/localhost/api.xml

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&amp;useUnicode=true&amp;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&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>

Change the user and password. If you need more information, please contact Abiquo Support
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:

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}

Datanode

Log in to the datanode server as an administrator
Configure the Galera cluster with the following command
```
galera_new_cluster
```
Edit the RabbitMQ environment configuration file at /etc/rabbitmq/rabbitmq-env.conf
Set the nodename that corresponds to the server, such as rabbit@services1
Restart the RabbitMQ service
```
service rabbitmq-server restart
```
Then run the following command
```
/usr/local/abiquo/setup build_cluster
```

Configure firewalls

Configure the firewalls as described here.

Server firewall requirements

From	To	Notes
Client	80/tcp	HTTP - It will be redirected to port 443 by default
Client	443/tcp	HTTPS - Proxy port for API/AM/UI services
Remote services appliance	8009/tcp
Remote services appliance	8010/tcp
V2V appliance	8009/tcp
V2V appliance	8010/tcp

Allow ICMP

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

Datanode Firewall requirements

From	To	Notes
Monitoring	3306/tcp	MySQL
Monitoring	5672/tcp	RabbitMQ
Server	2181/tcp	Zookeeper for API load balancing
	3306/tcp	MySQL
	5672/tcp	RabbitMQ
	6379/tcp	Redis
Remote services	5672/tcp	RabbitMQ
V2V	5672/tcp	RabbitMQ

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.

Validating the server and datanode install

Log in to Abiquo UI. See Starting Abiquo for the first time
Create a user. See Create a user

Next steps

Install Abiquo remote services. See Deploy distributed scalable remote services