4 This guide describes how to install snf-image-creator on an Ubuntu 12.04 LTS
5 system. It it highly recommended to have virtualization capable hardware.
6 snf-image-creator will work on processors that do not support virtualization
7 but it will be extremely slow.
12 snf-image-creator depends on the following programs:
14 * Python 2 [http://www.python.org/]
15 * Python development headers
16 * Python setuptools [http://pypi.python.org/pypi/setuptools]
17 * Python Dialog [http://pythondialog.sourceforge.net/]
18 * Python gevent library [http://pypi.python.org/pypi/gevent]
19 * Python bindings for libguestfs [http://libguestfs.org/]
20 * Kamaki [https://code.grnet.gr/projects/kamaki]
21 * Python sh (previously pbs) [https://github.com/amoffat/sh]
22 * ANSI colors for Python [http://pypi.python.org/pypi/ansicolors]
23 * progress [http://pypi.python.org/pypi/progress]
24 * Python interface to sendfile [http://pypi.python.org/pypi/pysendfile]
26 The first six programs (python2, python-dev, setuptools, Python-Dialog,
27 python-gevent and libguestfs) need to be installed manually by the user. In an
28 Ubuntu 12.04 LTS system this can be achieved by installing packages provided by
29 the distribution, using the following command:
31 .. code-block:: console
33 $ apt-get install python-setuptools python-guestfs python-dialog \
34 python-gevent python-dev
36 The rest of the dependencies will be automatically resolved by setuptools.
37 Keep in mind though that git needs to be installed to download the source
38 files. You can use the following command:
40 .. code-block:: console
44 Python Virtual Environment
45 ==========================
47 Since snf-image-creator and the rest of it's dependencies won't be installed
48 using packages, it's better to work in an isolated python virtual environment
49 (virtualenv). Installing the Virtual Python Environment builder in Ubuntu can
50 be accomplished using the following command:
52 .. code-block:: console
54 $ apt-get install python-virtualenv
56 Now, create a new python virtual environment like this:
58 .. code-block:: console
60 $ virtualenv --system-site-packages ~/image-creator-env
62 and activate it by executing:
64 .. code-block:: console
66 $ source ~/image-creator-env/bin/activate
68 You can later deactivate it using the following command:
70 .. code-block:: console
75 snf-common Installation
76 =======================
78 Install snf-common from source, by cloning it's repository:
80 .. code-block:: console
83 $ git clone https://code.grnet.gr/git/synnefo
84 $ cd synnefo/snf-common
85 $ python setup.py build
87 Then, make sure you are within the activated virtual environment before you
89 .. code-block:: console
91 $ python setup.py install
96 Install kamaki from source, by cloning it's repository:
98 .. code-block:: console
101 $ git clone https://code.grnet.gr/git/kamaki
105 As above, make sure you are within the activated virtual environment before you
108 .. code-block:: console
112 snf-image-creator Installation
113 ==============================
115 Install snf-image-creator the same way:
117 .. code-block:: console
120 $ git clone https://code.grnet.gr/git/snf-image-creator
121 $ git checkout stable-0.1
122 $ cd snf-image-creator
125 And from within the virtual environment execute:
127 .. code-block:: console