INSTALL

Documentation
=============

Please note that a more detailed installation procedure is described in the
doc/install.html file. A glossary of terms can be found in the doc/admin.html
file.


Software Requirements
=====================

Before installing, please verify that you have the following programs:
  - Xen virtualization (version 3.0.x or 3.1)
    http://xen.xensource.com/
  - DRBD (kernel module and userspace utils)
    http://www.drbd.org/
  - LVM2
    http://sourceware.org/lvm2/
  - OpenSSL
    http://www.openssl.org/
  - OpenSSH
    http://www.openssh.com/portable.html
  - bridge utilities
    http://bridge.sourceforge.net/
  - fping
    http://fping.sourceforge.net/
  - iproute2
    http://developer.osdl.org/dev/iproute2
  - arping (part of iputils package)
    ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz
  - mdadm (Linux Software Raid tools)
    http://www.kernel.org/pub/linux/utils/raid/mdadm/
  - Python 2.4
    http://www.python.org
  - Python Twisted library (the core is enough)
    http://twistedmatrix.com/
  - Python OpenSSL bindings
    http://pyopenssl.sourceforge.net/
  - simplejson Python module
    http://www.undefined.org/python/#simplejson

For testing, you also need the YAML module for Python (http://pyyaml.org/).

For building from source, you also need tar, gzip or bzip2 and make.


Installation of the software
============================

To install, simply do ``./configure --localstatedir=/var --sysconfdir=/etc && \
make && make install``

This will install the software under /usr/local. You then need to copy
ganeti.init to /etc/init.d/ganeti and integrate it into your boot sequence
(``chkconfig``, ``update-rc.d``, etc.).


Cluster initialisation
======================

Before initialising the cluster, on each node you need to create the following
directories:

  - /etc/ganeti
  - /srv/ganeti, /srv/ganeti/os, /srv/ganeti/export

After this, use ``gnt-cluster init``.