Installation
Requirements
This page describes the Abiquo requirements to install the Abiquo appliances. Before you do this, verify the infrastructure requirements:
The requirements are as follows:
- Datacenters require a unique datacenter ID shared by appliances inside the same datacenter
- The appliances should be able to reach NTP servers to keep their clocks synchronized
- The Server and Monolithic appliances require DNS resolution for SSL to work out of the box
- Appliances require static network configuration.
- The appliances should have internet access with correct configuration at boot time, in order to download JCE libraries. If not, you must manually download and install the libraries. See Invalid secret key requires JCE encryption libraries
Clock synchronization
Platform clocks must be synchronized for time dependent features to work. This includes including HVs, HVs management solutions, backup systems and some SDN integrations.
Abiquo will use NTP to keep platform clocks synchronized. Check your vendor documentation for other components.
VM repository folder
Private cloud requires a VM repository folder in each Abiquo DC, which holds the VM templates for all enterprises in that DC.
It must exists in each DC before deployment, and Monolithic, Remote services and V2V appliances must be able to mount and manage it.
This VM repository folder will be automatically configured during Abiquo bootstrap process.
Check VM repository folder for further details.
Platform Networks
The Abiquo appliances must be able to reach each other and the infrastructure components. See Configuring Platform Networks for Abiquo.
Service Network
Depending on the cloud network management solution, you will need to configure the DC network accordingly. See Configuring the Service Network for Cloud Tenant Network
Environment
Once your infrastructure fulfills the requirements, choose whether you will deploy a Monolithic Environment or a Distributed Environment.
You will need to install the Abiquo appliances corresponding to the environment, and optionally, the monitoring appliance.
These appliances require some configuration parameters before deployment. Some of them are common, while others are specific to the appliance functions inside the platform.
Parameter | Notes |
---|---|
Hostname | This is the name the appliance will use internally. Abiquo does not use this for anything and it can be freely chosen. |
Management IP address | IP of the management NIC |
Management IP netmask | Netmask of the management NIC |
Default gateway | Default gateway in the management network |
DNS server list | IPs of DNS servers in a space separated list |
NTP server list | Abiquo appliances use NTP to fulfill the platform clock synchronization requirements |
These details are required during the bootstrap process, and you must have them in place before the deployment:
It is a good idea to document the required information for each component in the corresponding worksheet in the links below. We provide an empty worksheet and an example for you to document all the Abiquo platform relevant configuration details:
- Monolithic environments install all the Abiquo components inside the same appliance, and they are good for probe of concept and testing purposes
Monolithic environments only require a monolithic appliance, and optionally, a monitoring appliance.
Monolithic Environment - Distributed environments separate Abiquo components depending on they characteristics for improved performance and reliability, and they are good for production environments
Distributed environments require at least one Server, one Remote Services and one V2V appliance.
Distributed environment
The Abiquo monitoring appliance is completely optional. To deploy the Monitoring appliance, you need the following requirements:
Parameter | Notes |
---|---|
Abiquo Server IP | Abiquo Server appliance management IP address |
The remote services appliance must be reachable from the monitoring appliance at the ports below:
Source | Destination port | Notes |
---|---|---|
Server Remote Services | TCP/36638 (HTTP) | Monitoring services |
Deployment
Check the links below accordingly to the environment where the Abiquo appliances will be deployed:
Post-installation steps
- Change the Abiquo default passwords as soon as possible (Base OS and UI passwords)
- Extend the appropriate filesystems accordingly to the VM templates sizes that the environment will manage
- Review the appliances /opt/abiquo/config/abiquo.properties file. You may need to tune it depending on your environment configuration.
- If the Server appliance is not connected to the internet, configure the UI accordingly.
- Monitor the appliance to prevent outages: See Monitor platform servers
- Work through the section on Configuration
Further steps
Now open your web browser and type in the site address for the Abiquo server:
https://FQDN
The default cloud administrator login username and password are admin and xabiquo, respectively. Remember to change these credentials as soon as you log in for the first time.
The link below describes how to get an Abiquo license and add it to the platform: Configure a platform license
For an overview of the Abiquo platform work through the tutorials built in to the product or try the Abiquo Quick Tutorial.
The following components are optional and you do not need them in a trial environment. Check the related links for further details on each component:
Component | Notes |
---|---|
UI configuration | See Configure Abiquo UI |
UI branding | Check Abiquo Branding Guide |
Abiquo platform configuration | Change the platform settings accordingly to your needs: Configuration |
Public Cloud providers | Configure AWS, Azure ARM, or other supported cloud providers: Public cloud providers |
Collectd | Use Abiquo collectd plugin integration for customized metrics: Use collectd plugin for custom metrics |
Persistent Storage | Configure NFS storage as vFiler on NetApp or Nexenta: Storage servers |
Jaspersoft Reports | For Abiquo reports. Check Install Abiquo Reports |
Chef Server integration | Check Abiquo Chef Integration Guide |
Copyright © 2006-2022, Abiquo Holdings SL. All rights reserved