install.rst

Ganeti installation tutorial

Documents Ganeti version |version|

Contents

• Introduction
• Installing the base system and base components
  • Hardware requirements
  • Installing the base system
    • Hostname issues
  • Installing The Hypervisor
    • Xen settings
    • Selecting the instance kernel
  • Installing DRBD
  • Installing RBD
    • RADOS Cluster
    • Kernel Modules
    • Userspace Utils
    • Configuration file
  • Other required software
• Setting up the environment for Ganeti
  • Configuring the network
  • Configuring LVM
  • Installing Ganeti
    • What gets installed
  • Installing the Operating System support packages
  • Initializing the cluster
    • Hypervisor/Network/Cluster parameters
  • Joining the nodes to the cluster
  • Separate replication network
  • Testing the setup
    • Cluster burnin
• Further steps

Introduction

Ganeti is a cluster virtualization management system based on Xen or KVM. This document explains how to bootstrap a Ganeti node (Xen dom0, the host Linux system for KVM), create a running cluster and install virtual instances (Xen domUs, KVM guests). You need to repeat most of the steps in this document for every node you want to install, but of course we recommend creating some semi-automatic procedure if you plan to deploy Ganeti on a medium/large scale.

A basic Ganeti terminology glossary is provided in the introductory section of the :doc:`admin`. Please refer to that document if you are uncertain about the terms we are using.

Ganeti has been developed for Linux and should be distribution-agnostic. This documentation will use Debian Squeeze as an example system but the examples can be translated to any other distribution. You are expected to be familiar with your distribution, its package management system, and Xen or KVM before trying to use Ganeti.

This document is divided into two main sections:

• Installation of the base system and base components
• Configuration of the environment for Ganeti