code.grnet.gr Git - snf-image/blob - docs/installation.rst

   1 Installation
   2 ============
   3
   4 Before installing snf-image be sure to have a working Ganeti installation in
   5 your cluster. The installation process should take place in **all** ganeti
   6 nodes. Here we will describe the installation in a single node. The process is
   7 identical for all nodes and should be repeated manually or automatically, e.g.,
   8 with puppet.
   9
  10 Installing snf-image using packages
  11 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  12
  13 For Debian Linux we provide packages in our apt repository. For Debian Squeeze
  14 add the following lines to ``/etc/apt/sources.list`` file:
  15
  16 ``deb http://apt.dev.grnet.gr squeeze/``
  17
  18 ``deb-src http://apt.dev.grnet.gr squeeze/``
  19
  20 For Debian Wheezy add the following lines:
  21
  22 ``deb http://apt.dev.grnet.gr wheezy/``
  23
  24 ``deb-src http://apt.dev.grnet.gr wheezy/``
  25
  26 After you update ``/etc/apt/sources.list`` import the repo's GPG key:
  27
  28 .. code-block:: console
  29
  30   $ curl https://dev.grnet.gr/files/apt-grnetdev.pub | apt-key add -
  31
  32 To install the package use the following commands:
  33
  34 .. code-block:: console
  35
  36   $ apt-get update
  37   $ apt-get install snf-image
  38
  39 The last command will also download and install the *snf-image-helper* image in
  40 the post install phase of the package installation.
  41
  42 Installing snf-image from source
  43 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  44
  45 To install snf-image from source, download the provided source package:
  46
  47 .. code-block:: console
  48
  49   $ wget http://apt.dev.grnet.gr/wheezy/snf-image_<VERSION>.orig.tar.gz
  50
  51 Untar, configure and compile the source:
  52
  53 .. code-block:: console
  54
  55   $ tar -xvf snf-image_<VERSION>.orig.tar.gz
  56   $ cd snf-image_<VERSION>/snf-image-host
  57   $ ./autoget.sh
  58   $ ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
  59   $ make
  60
  61 Install snf-image:
  62
  63 .. code-block:: console
  64
  65   $ make install
  66   $ install -Dm600 defaults /etc/default/snf-image
  67
  68 Finally, install the helper image by executing:
  69
  70 .. code-block:: console
  71
  72   $ snf-image-update-helper
  73