Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
S
snf-image-creator
Manage
Activity
Members
Labels
Plan
Issues
0
Issue boards
Milestones
Wiki
Code
Merge requests
0
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
itminedu
snf-image-creator
Commits
2d86bc44
Commit
2d86bc44
authored
12 years ago
by
Nikos Skalkotos
Browse files
Options
Downloads
Patches
Plain Diff
Add documentation for installing snf-image-creator
parent
7b006adb
No related branches found
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
docs/install.rst
+98
-0
98 additions, 0 deletions
docs/install.rst
with
98 additions
and
0 deletions
docs/install.rst
+
98
−
0
View file @
2d86bc44
Installation
============
This guide describes how to install snf-image-creator on an Ubuntu 12.04 LTS
system. It it highly recommended to have virtualization capable hardware.
snf-image-creator can work on processors that do not support virtualization but
it will be extremely slow.
Dependencies
------------
snf-image-creator depends on the following programs:
* Python 2 [http://www.python.org/]
* Python setuptools [http://pypi.python.org/pypi/setuptools]
* Python Dialog [http://pythondialog.sourceforge.net/]
* Python bindings for libguestfs [http://libguestfs.org/]
* Kamaki [https://code.grnet.gr/projects/kamaki]
* Python Sybprocess Wrapper [http://pypi.python.org/pypi/pbs]
* ANSI colors for Python [http://pypi.python.org/pypi/ansicolors]
* progress [http://pypi.python.org/pypi/progress]
* Python interface to sendfile [http://pypi.python.org/pypi/pysendfile]
The first four programs (python2, setuptools, libguestfs and Python Dialog)
need to be installed manually by the user. In an Ubuntu 12.04 LTS system this
can be archived using packages directly provided by the distribution, using
the following command:
.. code-block:: console
$ apt-get install python-setuptools python-guestfs python-dialog
The rest of the dependencies will be resolved by setuptools.
Python Virtual Environment
--------------------------
Since snf-image-creator and the rest of it's dependencies won't be installed
using packages provided by the distribution it's better to work in an isolated
python virtual environment (virtualenv). Installing the Virtual Python
Environment builder in Ubuntu can be accomplished using the following command:
.. code-block:: console
$ apt-get install python-virtualenv
Now, create a new python virtual environment like this:
.. code-block:: console
$ virtualenv --system-site-packages ~/image-creator-env
and activate it by executing:
.. code-block:: console
$ source ~/image-creator-env/bin/activate
You can later deactivate it using the following command:
.. code-block:: console
$ deactivate
kamaki Installation
-------------------
Install kamaki from source, by cloning it's repository:
.. code-block:: console
$ git clone https://code.grnet.gr/git/kamaki
$ cd kamaki
$ ./setup build
Then, make sure you are within the activated virtual environment before you
execute:
.. code-block:: console
$ ./setup install
snf-image-creator Installation
------------------------------
Install snf-image-creator the same way:
.. code-block:: console
$ git clone https://code.grnet.gr/git/snf-image-creator
$ cd snf-image-creator
$ ./setup build
And from within the virtual environment execute:
.. code-block:: console
$ ./setup install
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment