Rename installing.sgml to install.sgml
[ganeti-local] / INSTALL
1 Software Requirements
2 =====================
3
4 Before installing, please verify that you have the following programs:
5   - Xen virtualization (version 3.0.x or 3.1)
6     http://xen.xensource.com/
7   - DRBD (kernel module and userspace utils)
8     http://www.drbd.org/
9   - LVM2
10     http://sourceware.org/lvm2/
11   - OpenSSL
12     http://www.openssl.org/
13   - OpenSSH
14     http://www.openssh.com/portable.html
15   - bridge utilities
16     http://bridge.sourceforge.net/
17   - fping
18     http://fping.sourceforge.net/
19   - iproute2
20     http://developer.osdl.org/dev/iproute2
21   - arping (part of iputils package)
22     ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz
23   - mdadm (Linux Software Raid tools)
24     http://www.kernel.org/pub/linux/utils/raid/mdadm/
25   - Python 2.4
26     http://www.python.org
27   - Python Twisted library (the core is enough)
28     http://twistedmatrix.com/
29   - Python OpenSSL bindings
30     http://pyopenssl.sourceforge.net/
31
32 For testing, you also need the YAML module for Python (http://pyyaml.org/).
33
34 For building from source, you also need tar, gzip or bzip2 and make.
35
36
37 Installation of the software
38 ============================
39
40 To install, simply do ``./configure --localstatedir=/var && make && make install``
41
42 This will install the software under /usr/local. You then need to copy
43 ganeti.init to /etc/init.d/ganeti and integrate it into your boot sequence
44 (``chkconfig``, ``update-rc.d``, etc.).
45
46 More details about the installation process are in the docs/install.pdf file.
47
48
49 Cluster initialisation
50 ======================
51
52 Before initialising the cluster, on each node you need to create the following
53 directories:
54
55   - /etc/ganeti
56   - /srv/ganeti, /srv/ganeti/os, /srv/ganeti/export
57
58 After this, use ``gnt-cluster init``.