# Introduction
This repository documents the installation of an openstack cluster for the institute of information resource management.
The software used is _Ubuntu 12.04.4 LTS_ with _Openstack Havana_. The official documentation can be found here:
http://docs.openstack.org/havana/install-guide/install/apt/content/

## Cluster setup
The openstack cluster currently consists of one controller node, one network node and multiple compute nodes. 

The __controller node__ contains the following services:
* __MySQL__ stores information about openstack services
* __Apache__ offers access to mysql by phpmyadmin and to the openstack cluster by horizon
* __Rabbitmq__ message queue server used by openstack
* __MongoDB__ stores usage data from telemetry service ceilometer
* __Openstack Keystone__ identity management for users, groups and services defined in openstack
* __Openstack Glance__ image manager for os images new vms can boot from
* __Openstack Nova__ computation controller for running vms
* __Openstack Neutron Server__ connector between networking and computing services
* __Openstack Horizon__ openstack dashboard, accessed by apache
* __Openstack Cinder__ block storage manager for volumes
further tasks (not installed yet):
* __Openstack Swift__ object storage manager
* __Openstack Heat__ orchestration of instances and networks

The __network node__ contains the following services:
* __Openstack Neutron__ network manager controller

The __compute node__ contains the following services:
* __Openstack Nova__ computation execution
* __Openstack Cinder__ block storage persistence
* __Openstack Neutron Agent__ agent for network manager
further tasks (not installed yet):
* __Openstack Swift__ object storage persistence

The setup of nodes and networks is shown in the following figure. The controller node is named clusterlab-ctrl01, 
the network node is named clusterlab-ctrl02. Compute nodes are named clusterlab01 to clusterlabNN. Four networks are used, 
of which three are private and one public. The control and data nets in 10.8.0.0/16 have internet access for
outgoing connections but are not reachable from outside. The public net 134.60.30.0/24 is accessible directly from
the internet. Therefore this physically existent net is used by the private virtual net 10.10.0.0/16. This virtual net is only
accessible from the physical omi network and can not access the internet for outgoing connections. 

![Node and network setup](../../raw/master/documentation/images/OpenStack-Networking-2.png)


# Repo structure
The subdirectory [config](../../tree/master/config) contains the manually modified configuration files separated by the node type. 
For easier installation, the subdirectory [installation](../../tree/master/installation) contains scripts, that install, modify and
place configuration files on the new node. [documentation](../../tree/master/documentation) contains additional documentation
material like graphics and presentations.