Deploy distributed scalable monitoring server

Install monitoring appliance

The Monitoring appliance is optional and it contains the Abiquo Watchtower components for VM monitoring and metrics, along with its required services and databases. For a production environment, you can run the monitoring database on the datanode services server. In a distributed scalable environment, you will create a monitoring cluster with one node.

Installation requirements

2 CPUs
8 GB RAM
64 GB HD

Installation parameters

Parameter	Notes
Abiquo Server IP	This must be the same as the Abiquo Server appliance management IP address
Abiquo RabbitMQ server IP	Abiquo datanode appliance IP, or comma separated list of IPs for a cluster

Firewall requirements

From	To	Notes
Remote Services	36638/tcp	Watchtower
Datanode services	36638/tcp	Watchtower
Watchtower	7000/tcp	Emmett (One of the Abiquo monitoring services)
KairosDB	9042/tcp	Cassandra
KairosDB	9160/tcp	Cassandra
Watchtower	8080/tcp	Kairos DB
Watchtower	3306/tcp	Database

Post install steps

Do these steps on the monitoring node.

Log in to the monitoring server
Edit the Cassandra configuration file at:
```
/etc/cassandra/conf/cassandra.yaml
```
1. Remove the seeds value. In this example, remove x.x.x.x
```
seeds: x.x.x.x
```
2. Add the IP of the monitoring VM as the new seeds value.
```
seeds: <IP.of.Master.VM>
```
Edit the KairosDB properties file at:
```
/opt/kairosdb/conf/kairosdb.properties
```
Remove the this property
```
kairosdb.datastore.cassandra.host_list
```
Add this property and set the value as the IP address of the server, without the port. Note the cql_ in the name
```
kairosdb.datastore.cassandra.cql_host_list=10.60.10.102
```

Edit the watchtower properties files at:

/etc/abiquo/watchtower/delorean.conf 
/etc/abiquo/watchtower/emmett.conf

Set the URL of the mysql server connection (as on the API server) with the IP address of the watchtower server.
Set the database credentials.
Restart the server
1. Stop the following services:
  1. cassandra and check that it is really ded
  2. kairosdb
  3. abiquo-emmett
  4. abiquo-delorean
  5. firewalld (and allow connections as required)
2. Start cassandra and wait 5 minutes before continuing
3. Start kairosdb and wait 1 minute
4. Start abiquo-emmett and abiquo-delorean
5. Start firewalld

The cluster of one server should now be fully functioning.

Enable and validate monitoring

To enable monitoring:

On the Abiquo Server and the Abiquo Remote Services servers (but not the V2V server), edit the abiquo.properties file and check or set the following properties:
1. abiquo.monitoring.enabled = yes
2. abiquo.watchtower.host = {$MONITORING_IP_ADDRESS}
3. abiquo.watchtower.port = 36638
Restart your Abiquo Tomcat service.

To validate monitoring:

This step assumes you have followed the Abiquo quick tutorial to deploy a VM in Abiquo
Create a new VM and edit it
Go to Monitoring and select the Fetch metrics checkbox and the metrics to display
Save the VM
Have a cup of tea or coffee while you wait for the VM for Abiquo to obtain metrics (around 5 minutes)
On the VM icon, click the graph metrics button to display your VM metrics