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 GNU/Linux and Ubuntu we provide packages in our apt repository.
  14
  15 For Debian Squeeze add the following lines to ``/etc/apt/sources.list`` file:
  16
  17 ``deb http://apt.dev.grnet.gr squeeze/``
  18
  19 ``deb-src http://apt.dev.grnet.gr squeeze/``
  20
  21 For Debian Wheezy add the following lines:
  22
  23 ``deb http://apt.dev.grnet.gr wheezy/``
  24
  25 ``deb-src http://apt.dev.grnet.gr wheezy/``
  26
  27 For Ubuntu 12.04 LTS add the following lines:
  28
  29 ``deb http://apt.dev.grnet.gr precise/``
  30
  31 ``deb-src http://apt.dev.grnet.gr precise/``
  32
  33 After you update ``/etc/apt/sources.list`` import the repo's GPG key:
  34
  35 .. code-block:: console
  36
  37   $ curl https://dev.grnet.gr/files/apt-grnetdev.pub | apt-key add -
  38
  39 To install the package use the following commands:
  40
  41 .. code-block:: console
  42
  43   $ apt-get update
  44   $ apt-get install snf-image
  45
  46 The last command will also download and install the *snf-image-helper* image in
  47 the post install phase of the package installation.
  48
  49 Installing snf-image from source
  50 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  51
  52 To install snf-image from source, download the provided source package:
  53
  54 .. code-block:: console
  55
  56   $ wget http://apt.dev.grnet.gr/wheezy/snf-image_<VERSION>.orig.tar.gz
  57
  58 Untar, configure and compile the source:
  59
  60 .. code-block:: console
  61
  62   $ tar -xvf snf-image_<VERSION>.orig.tar.gz
  63   $ cd snf-image_<VERSION>/snf-image-host
  64   $ ./autoget.sh
  65   $ ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
  66   $ make
  67
  68 Install snf-image:
  69
  70 .. code-block:: console
  71
  72   $ make install
  73   $ install -Dm600 defaults /etc/default/snf-image
  74
  75 Finally, install the helper image by executing:
  76
  77 .. code-block:: console
  78
  79   $ snf-image-update-helper
  80