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 can work on processors that do not support virtualization but
7 it will be extremely slow.
12 snf-image-creator depends on the following programs:
14 * Python 2 [http://www.python.org/]
15 * Python setuptools [http://pypi.python.org/pypi/setuptools]
16 * Python Dialog [http://pythondialog.sourceforge.net/]
17 * Python bindings for libguestfs [http://libguestfs.org/]
18 * Kamaki [https://code.grnet.gr/projects/kamaki]
19 * Python Sybprocess Wrapper [http://pypi.python.org/pypi/pbs]
20 * ANSI colors for Python [http://pypi.python.org/pypi/ansicolors]
21 * progress [http://pypi.python.org/pypi/progress]
22 * Python interface to sendfile [http://pypi.python.org/pypi/pysendfile]
24 The first four programs (python2, setuptools, libguestfs and Python Dialog)
25 need to be installed manually by the user. In an Ubuntu 12.04 LTS system this
26 can be archived using packages directly provided by the distribution, using
27 the following command:
29 .. code-block:: console
31 $ apt-get install python-setuptools python-guestfs python-dialog
33 The rest of the dependencies will be resolved by setuptools.
35 Python Virtual Environment
36 --------------------------
38 Since snf-image-creator and the rest of it's dependencies won't be installed
39 using packages provided by the distribution it's better to work in an isolated
40 python virtual environment (virtualenv). Installing the Virtual Python
41 Environment builder in Ubuntu can be accomplished using the following command:
43 .. code-block:: console
45 $ apt-get install python-virtualenv
47 Now, create a new python virtual environment like this:
49 .. code-block:: console
51 $ virtualenv --system-site-packages ~/image-creator-env
53 and activate it by executing:
55 .. code-block:: console
57 $ source ~/image-creator-env/bin/activate
59 You can later deactivate it using the following command:
61 .. code-block:: console
69 Install kamaki from source, by cloning it's repository:
71 .. code-block:: console
73 $ git clone https://code.grnet.gr/git/kamaki
77 Then, make sure you are within the activated virtual environment before you
80 .. code-block:: console
84 snf-image-creator Installation
85 ------------------------------
87 Install snf-image-creator the same way:
89 .. code-block:: console
91 $ git clone https://code.grnet.gr/git/snf-image-creator
92 $ cd snf-image-creator
95 And from within the virtual environment execute:
97 .. code-block:: console