Abiquo Cookbook

This cookbook provides several recipes to install an upgrade an Abiquo platform.
It allows to provision an Abiquo Monolithic, the Remote Services and a KVM hypervisor
from scratch, as long as upgrading an existing Abiquo installation using the latest
nightly builds.

Requirements

• CentOS >= 6.5

This cookbook depends on the following cookbooks:

• apache2
• ark
• iptables
• java-management
• selfsigned_certificate
• selinux
• yum

Recipes

Generic recipes to be used to deploy an Abiquo platform from scratch:

• recipe[abiquo] - Installs an Abiquo Platform
• recipe[abiquo::repository] - Configures the Abiquo yum repositories
• recipe[abiquo::install_monolithic] - Installs an Abiquo Monolithic
• recipe[abiquo::install_remoteservices] - Installs the Abiquo Remote Services
• recipe[abiquo::install_kvm] - Installs the KVM hypervisor
• recipe[abiquo::setup_monolithic] - Configures the Abiquo Server
• recipe[abiquo::setup_remoteservices] - Configures the Abiquo Remote Services
• recipe[abiquo::setup_kvm] - Configures the KVM hypervisor
• recipe[abiquo::upgrade] - Upgrades an Abiquo Platform
• recipe[abiquo::install_database] - Installs the Abiquo database
• recipe[abiquo::install_jce] - Installs the JCE unlimited strength jurisdiction policy files

Specific recipes to upgrade existing Abiquo installations:

• recipe[abiquo::certificate] - Configures the SSL certificates

Attributes

The following attributes are under the node['abiquo'] namespace.

Resources and providers

The Abiquo cookbook provides the following LWRPs:

abiquo_wait_for_webapp

This LWRP will make the Chef run wait until the configured webapp is started.

Parameters

• host - The address where the webapp is running
• port - The port where the webapp is listening
• webapp - The name of the webapp
• open_timeout - The timeout to open a connection to the webapp
• read_timeout - The timeout to read from a connection to the webapp

Example

abiquo_wait_for_webapp "api" do
    host "localhost"
    port 8009
    retries 3   # Retry if Tomcat is still not started
    retry_delay 5
    action :wait
end

Usage

The cookbook is pretty straightforwatd to use. Just set the node['abiquo']['profile'] attribute
according to the profile you want to install or upgrade and and include one of the following recipes
in the run list:

• recipe[abiquo] - To perform an installation from scratch
• recipe[abiquo::upgrade] - To upgrade an existing installation

When installing the Abiquo Monolithic profile, you may also want to set the node['selfsigned_certificate']['cn']
attribute to match the hostname of the node. You can also use it together with the hostname cookbook to make sure the node will have it properly configured.

Testing

In order to test the cookbook you will need to install Vagrant and VirtualBox. Once installed you can run the unit and integration tests as follows:

bundle install
bundle exec rake          # Run the unit and style tests
bundle exec rake kitchen  # Run the integration tests

License and Authors

• Author:: Ignasi Barrera (ignasi.barrera@abiquo.com)

Copyright:: 2014, Abiquo

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.