...
Info |
---|
This section describes how to deploy the |
Introduction
The server
appliance contains the Abiquo UI, API, and Events servers.
The services 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.
For Ubuntu, deploy first the services datanode
and configure it, then you can deploy the api-ui
or server
.
...
Requirements
You will need the following virtual resources.
...
Note |
---|
|
...
This section describes how to install the API UI server.
Download the
server
OVA file and launch it. For details of the OVA deployment, see how to deploy an OVA in VMware, see OVA deployment for distributed scalableEnter the standard parameters for the API UI server, which are as follows:
Friendly hostname, e.g.
server-ova
, which must be a valid Linux hostnameManagement interface IPv4 Address, e.g.
10.60.10.100
, which should be a static network configurationManagement interface IPv4 Netmask, e.g.
255.255.255.0
Default Gateway, e.g.
10.60.10.1
Space separated DNS Server list, e.g.
10.60.10.1
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
Abiquo API server FQDN, e.g.
server-ovaserverova.lab.abiquo.com
This FQDN must be resolvable from customer premises for SSL and the Appliance manager to work properly
Remote Services IP, e.g.
10.60.10.110
Watchtower IP, e.g.
10.60.10.102
...
...
Services datanode
We will deploy a single services datanode
server to form a cluster of one node. Later, you can easily deploy more nodes and add them to the cluster.
Download the
services
datanode OVA file and launch it.Enter the standard parameters for the services datanode server. The description of the parameters is the same as above
Friendly hostname, e.g.
datanode-ova
, which must beservicesova
, enter a valid Linux hostnameManagement interface IPv4 Address, e.g.
10.60.10.185
, which should be a static network configuration
Enter the
services
datanode server parametersServices 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
Services datanode
Log in to the services datanode server as an administrator
Configure the Galera cluster with the following command
Code Block galera_new_cluster
Edit the RabbitMQ environment configuration file at
/etc/rabbitmq/rabbitmq-env.conf
Set the
nodename
that corresponds to the server, such asrabbit@services1
Restart the RabbitMQ service
Code Block systemctl restart rabbitmq-server.service
Then run the following command
Code Block /usr/local/abiquo/setup build_cluster
Note that this command will output the default user and password of the database, so for a test system behind a firewall, you can use that in the next step.
...
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 IP address of the services datanode server, where your Galera
database cluster is running .
Remove this line: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://{SERVICES_DATANODE_IP_ADDRESS}:3306/kinton?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8"/>
Change the
user
andpassword
. If you need more information, please contact Abiquo Support
To point to the datanode instead of the local host for RabbitMQ and Redis, edit Edit the
abiquo.properties
file at/opt/abiquo/config/abiquo.properties
:.Change
the IP address of the
services datanode
and add the port of the Redis instance, and the FQDN of the API. Also deactivate monitoring until you deploy the monitoring node.Code Block abiquo.rabbitmq.addresses = {SERVICES_DATANODE_IP_ADDRESS} abiquo.redis.host = {SERVICES_DATANODE_IP_ADDRESS}
Datanode
Log in to the datanode server as an administrator
Configure the Galera cluster with the following command
Code Block galera_new_cluster
Edit the RabbitMQ environment configuration file at
/etc/rabbitmq/rabbitmq-env.conf
Set the
nodename
that corresponds to the server, such asrabbit@services1
Restart the RabbitMQ service
Code Block service rabbitmq-server restart
Then run the following command
/usr/local/abiquo/setup build_clusterCode Block abiquo.redis.port = 6379 abiquo.monitoring.enabled=false abiquo.server.api.location = https://{API_FQDN}/api
Save the properties file and restart the
abiquo-tomcat
serverCode Block systemctl restart abiquo-tomcat.service
To check when the Abiquo server has started you can follow the end of the log with the following command until the API has started and connected to the services.
Code Block tail -f /opt/abiquo/tomcat/logs/catalina.out
...
Configure firewalls
Configure the firewalls for your servers as described here.
Server firewall requirements
...
Note |
---|
Allow ICMP You must ICMP between all components of the Abiquo platform, including hypervisors. |
...
Datanode Firewall Services datanode firewall requirements
From | To | Notes |
---|---|---|
Monitoring | 3306/tcp | MySQL |
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 |
...
Abiquo UI requires a screen resolution of at least 1024 x 768 for productive work.
It is based on HTML5 The UI uses 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 services datanode install
Log in to Abiquo UI
...
and update your user account details as described at:
Starting Abiquo for the first time
...
Optionally, create a new user. See Create a user
...
Next
...
step
Install Abiquo remote services. See Deploy distributed scalable remote services