...

The Abiquo API can be balanced amongst several servers to spread load and increase service capacity. As you know, Abiquo provides an HTML5 client application that runs on your browser that interacts with the API to operate the cloud.

So, as As the UI is a regular HTML app, there may be several options to balance both the UI and the API.

...

API plus UI cluster

In this setup, we are spreading the load amongst a cluster of nodes running both API and UI. Please note that any API clustered setup REQUIRES using zookeeper to workZookeeper.
For the sake of simplicity, we are using a two node setup, but this is easily scalable to several nodes and using Apache web server as a load balancer.

Image RemovedImage Added CHANGE THIS

Assume the following IP addressing for our cluster nodes.

...

Start by installing backend severs using the Server profile of the Abiquo ISO installer. This profile will install API and UI webapps, as well as the zookeeper Zookeeper daemon needed for API to work in a clustered configuration.

...

Once you have both servers with the Server profile installed, keep in mind that you need to keep the abiquo.properties file synchronized on every node in the API cluster.

...

First, for the API to function as a clustered API, you need to setup Zookeeper. You may want to can run Zookeeper in on the LoadBalancer node or in on a separate box, depending in your needs and/or preferencesas preferred.
Zookeeper requires JVM to run, ensure that JVM (Oracle or OpenJDK) is installed.

...

The zookeeper package is installed using the "Server" profile of the Abiquo installer ISO. If it is not installed, you can do so typingBut if you need to install it manually, use:

# yum -y install zookeeper

Then , you need to add the following line in the [server] section of the abiquo.properties file in on all Abiquo API server nodes:

...

Replace <zookeeper_ip> to match your environment. Also , add or modify the abiquo.server.api.location property to match the load balancer URL for the API service (shown below):

abiquo.server.api.location = https://abiquo.example.com/api

You will need to edit file Edit the files /opt/abiquo/tomcat/conf/Catalina/localhost/api.xml and /opt/abiquo/tomcat/conf/Catalina/localhost/m.xml and set the values for the MySQL kinton database connection:. Change the url, username and password attributes to match your environment.

<Resource name="jdbc/abiquoDB" auth="Container" type="javax.sql.DataSource" initialSize="10" suspectTimeout="60" timeBetweenEvictionRunsMillis="30000" minEvictableIdleTimeMillis="60000" maxActive="100" minIdle="10" maxIdle="50" maxWait="10000" removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true" username="mysql_user" password="user_password" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://mysql.example.com:3306/kinton?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>

...

UI configuration

In a clustered UI setup, you will need to configure the LB as the API endpoint for each UI node. Edit /var/www/html/ui/config/client-config.json file and set the same config.endpoint property for each UI node. For example:

...

LoadBalancer Apache node configuration

You need to make sure To ensure that Apache's required modules are loaded. Be sure to include , add the following lines in to your Apache config file:

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so

In On the LoadBalancer node running Apache, create a new config file in /etc/httpd/conf.d/api-balancer.conf with the following contents:

...

Restart or reload your Apache server to apply the new configuration.

...

Abiquo API Tomcat configuration

<Engine name="Catalina" defaultHost="localhost" jvmRoute="node1">

# echo -n | openssl s_client -connect abiquo.example.com:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > abiquo.example.com.cert
# /usr/java/default/bin/keytool -import -file abiquo.example.com.cert -keystore /path/to/cacerts
# /usr/java/default/bin/keytool -import -trustcacerts -file /path/to/ca/ca.pem -alias CA_ALIAS -keystore /path/to/cacerts

Restart tomcat after the change to apply the new configuration.

Now, access your balancer at https://abiquo.example.com/ui/ or https://abiquo.example.com/api/ . Requests between the two backend nodes will be adequately balanced.

# curl -k -u admin:xabiquo --silent -X GET https://abiquo.example.com/api/login

{"links":[{"title":"Abiquo","rel":"enterprise","type":"application/vnd.abiquo.enterprise+json","href":"https://abiquo.example.com:443/api/admin/enterprises/1"},
{"title":"CLOUD_ADMIN","rel":"role","type":"application/vnd.abiquo.role+json","href":"https://abiquo.example.com:443/api/admin/roles/1"},
{"title":"CLOUD_ADMIN","rel":"edit","type":"application/vnd.abiquo.user+json","href":"https://abiquo.example.com:443/api/admin/enterprises/1/users/1"},
{"title":"virtualmachines","rel":"virtualmachines","type":"application/vnd.abiquo.virtualmachines+json","href":"https://abiquo.example.com:443/api/admin/enterprises/1/users/1/action/virtualmachines"},
{"title":"pending tasks","rel":"pendingtasks","type":"application/vnd.abiquo.tasks+json","href":"https://abiquo.example.com:443/api/admin/enterprises/1/users/1/action/pendingtasks"},{"title":"applications","rel":"applications","type":"application/vnd.abiquo.applications+json","href":"https://abiquo.example.com:443/api/admin/enterprises/1/users/1/applications"}],
"id":1,"name":"Cloud","nick":"admin","locale":"en_US","surname":"Administrator","active":true,"email":"","description":"Main administrator","authType":"ABIQUO"}

Other setups