Statistics
| Branch: | Tag: | Revision:

root / docs / install.rst @ e08d574e

History | View | Annotate | Download (2.5 kB)

1 7b006adb Nikos Skalkotos
Installation
2 fa77d79a Nikos Skalkotos
^^^^^^^^^^^^
3 2d86bc44 Nikos Skalkotos
4 2d86bc44 Nikos Skalkotos
This guide describes how to install snf-image-creator on an Ubuntu 12.04 LTS
5 2d86bc44 Nikos Skalkotos
system. It it highly recommended to have virtualization capable hardware.
6 3f4e2409 Nikos Skalkotos
snf-image-creator will work on processors that do not support virtualization
7 3f4e2409 Nikos Skalkotos
but it will be extremely slow.
8 2d86bc44 Nikos Skalkotos
9 2d86bc44 Nikos Skalkotos
Dependencies
10 fa77d79a Nikos Skalkotos
============
11 2d86bc44 Nikos Skalkotos
12 2d86bc44 Nikos Skalkotos
snf-image-creator depends on the following programs:
13 2d86bc44 Nikos Skalkotos
14 2d86bc44 Nikos Skalkotos
 * Python 2 [http://www.python.org/]
15 2d86bc44 Nikos Skalkotos
 * Python setuptools [http://pypi.python.org/pypi/setuptools]
16 2d86bc44 Nikos Skalkotos
 * Python Dialog [http://pythondialog.sourceforge.net/]
17 2d86bc44 Nikos Skalkotos
 * Python bindings for libguestfs [http://libguestfs.org/]
18 2d86bc44 Nikos Skalkotos
 * Kamaki [https://code.grnet.gr/projects/kamaki]
19 20e37310 Nikos Skalkotos
 * Python sh (previously pbs) [https://github.com/amoffat/sh]
20 2d86bc44 Nikos Skalkotos
 * ANSI colors for Python [http://pypi.python.org/pypi/ansicolors]
21 2d86bc44 Nikos Skalkotos
 * progress [http://pypi.python.org/pypi/progress]
22 2d86bc44 Nikos Skalkotos
 * Python interface to sendfile [http://pypi.python.org/pypi/pysendfile]
23 2d86bc44 Nikos Skalkotos
24 e08d574e Alex Pyrgiotis
When installing snf-image-creator, the above dependencies are automatically
25 e08d574e Alex Pyrgiotis
resolved.
26 2d86bc44 Nikos Skalkotos
27 e08d574e Alex Pyrgiotis
Development repository addition
28 e08d574e Alex Pyrgiotis
===============================
29 2d86bc44 Nikos Skalkotos
30 e08d574e Alex Pyrgiotis
In order to install snf-image-creator and the rest of it's dependencies, you
31 e08d574e Alex Pyrgiotis
must first add GRNET's dev repo to your sources. You can use the following
32 e08d574e Alex Pyrgiotis
commands:
33 2d86bc44 Nikos Skalkotos
34 2d86bc44 Nikos Skalkotos
.. code-block:: console
35 2d86bc44 Nikos Skalkotos
36 e08d574e Alex Pyrgiotis
   cd /etc/apt/sources.list.d
37 e08d574e Alex Pyrgiotis
   echo "deb http://apt.dev.grnet.gr precise main" | \
38 e08d574e Alex Pyrgiotis
   sudo tee -a  apt.dev.grnet.gr.list
39 e08d574e Alex Pyrgiotis
   echo "deb-src http://apt.dev.grnet.gr precise main" | \
40 e08d574e Alex Pyrgiotis
   sudo tee -a apt.dev.grnet.gr.list
41 2d86bc44 Nikos Skalkotos
42 e08d574e Alex Pyrgiotis
You will also need to import the repo's GPG key. You can use the ``curl`` tool
43 e08d574e Alex Pyrgiotis
for this.
44 2d86bc44 Nikos Skalkotos
45 2d86bc44 Nikos Skalkotos
.. code-block:: console
46 2d86bc44 Nikos Skalkotos
47 e08d574e Alex Pyrgiotis
   $ sudo apt-get install curl
48 2d86bc44 Nikos Skalkotos
49 e08d574e Alex Pyrgiotis
Use the following command to import the GPG key:
50 2d86bc44 Nikos Skalkotos
51 2d86bc44 Nikos Skalkotos
.. code-block:: console
52 2d86bc44 Nikos Skalkotos
53 e08d574e Alex Pyrgiotis
   $ sudo curl https://dev.grnet.gr/files/apt-grnetdev.pub | sudo apt-key add -
54 a6f30600 Alex Pyrgiotis
55 e08d574e Alex Pyrgiotis
You can verify that the repo has been added successfully if snf-image-creator
56 e08d574e Alex Pyrgiotis
exists as a package. First do an update of your sources:
57 a6f30600 Alex Pyrgiotis
58 a6f30600 Alex Pyrgiotis
.. code-block:: console
59 b5053149 Alex Pyrgiotis
60 e08d574e Alex Pyrgiotis
   $ sudo apt-get update
61 a6f30600 Alex Pyrgiotis
62 e08d574e Alex Pyrgiotis
then check if snf-image-creator exists with the following command:
63 a6f30600 Alex Pyrgiotis
64 a6f30600 Alex Pyrgiotis
.. code-block:: console
65 a6f30600 Alex Pyrgiotis
66 e08d574e Alex Pyrgiotis
   $ apt-cache showpkg snf-image-creator
67 2d86bc44 Nikos Skalkotos
68 2d86bc44 Nikos Skalkotos
snf-image-creator Installation
69 fa77d79a Nikos Skalkotos
==============================
70 2d86bc44 Nikos Skalkotos
71 e08d574e Alex Pyrgiotis
If GRNET's dev repo has been added successfully, you can install
72 e08d574e Alex Pyrgiotis
snf-image-creator, along with its dependencies, with the following command:
73 2d86bc44 Nikos Skalkotos
74 2d86bc44 Nikos Skalkotos
.. code-block:: console
75 2d86bc44 Nikos Skalkotos
76 e08d574e Alex Pyrgiotis
   $ sudo apt-get install snf-image-creator
77 2d86bc44 Nikos Skalkotos
78 e08d574e Alex Pyrgiotis
The installation might take a while. Please note that at some point during the
79 e08d574e Alex Pyrgiotis
installation you will be prompted to create/update a "supermin appliance". This
80 e08d574e Alex Pyrgiotis
is a setting regarding libguestfs and you can safely choose "Yes".