INSTALL 1.85 KB
Newer Older
1 2 3 4
Documentation
=============

Please note that a more detailed installation procedure is described in the
Michael Hanselmann's avatar
Michael Hanselmann committed
5 6
doc/install.html file. A glossary of terms can be found in the doc/admin.html
file.
7 8


9 10
Software Requirements
=====================
Iustin Pop's avatar
Iustin Pop committed
11 12

Before installing, please verify that you have the following programs:
Iustin Pop's avatar
Iustin Pop committed
13 14 15 16
  - Xen virtualization (version 3.0.x or 3.1)
    http://xen.xensource.com/
  - DRBD (kernel module and userspace utils)
    http://www.drbd.org/
17 18
  - LVM2
    http://sourceware.org/lvm2/
Iustin Pop's avatar
Iustin Pop committed
19 20
  - OpenSSL
    http://www.openssl.org/
21 22
  - OpenSSH
    http://www.openssh.com/portable.html
Iustin Pop's avatar
Iustin Pop committed
23 24 25 26 27 28 29 30 31 32
  - bridge utilities
    http://bridge.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
33 34 35 36
  - Python Twisted library (the core is enough)
    http://twistedmatrix.com/
  - Python OpenSSL bindings
    http://pyopenssl.sourceforge.net/
37 38
  - simplejson Python module
    http://www.undefined.org/python/#simplejson
39

Iustin Pop's avatar
Iustin Pop committed
40
For testing, you also need the YAML module for Python (http://pyyaml.org/).
41

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

44 45 46

Installation of the software
============================
Iustin Pop's avatar
Iustin Pop committed
47

48 49
To install, simply do ``./configure --localstatedir=/var --sysconfdir=/etc && \
make && make install``
Iustin Pop's avatar
Iustin Pop committed
50 51

This will install the software under /usr/local. You then need to copy
Iustin Pop's avatar
Iustin Pop committed
52
ganeti.init to /etc/init.d/ganeti and integrate it into your boot sequence
Iustin Pop's avatar
Iustin Pop committed
53 54
(``chkconfig``, ``update-rc.d``, etc.).

55

Iustin Pop's avatar
Iustin Pop committed
56 57 58 59 60 61 62
Cluster initialisation
======================

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

  - /etc/ganeti
Iustin Pop's avatar
Iustin Pop committed
63
  - /srv/ganeti, /srv/ganeti/os, /srv/ganeti/export
Iustin Pop's avatar
Iustin Pop committed
64 65

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