Page Comparison

...

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.

...

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, 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

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

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.

1. Download the datanode OVA file and launch it.

2. 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

3. 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

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:

   Code Block
   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:

   Code Block
   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

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

...

1. Log in to the datanode server as an administrator

2. Configure the Galera cluster with the following command

   Code Block
   galera_new_cluster

3. Edit the RabbitMQ environment configuration file at /etc/rabbitmq/rabbitmq-env.conf

4. Set the nodename that corresponds to the server, such as rabbit@services1

5. Restart the RabbitMQ service

   Code Block
   service rabbitmq-server restart

6. Then run the following command

   Code Block
   /usr/local/abiquo/setup build_cluster

...

Configure firewalls

Configure the firewalls as described here.

...

...

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 remote services