Skip to content
Snippets Groups Projects
Commit f0b21d37 authored by Nikos Skalkotos's avatar Nikos Skalkotos
Browse files

Add basic usage documentation

parent 2d86bc44
No related branches found
No related tags found
No related merge requests found
......@@ -15,6 +15,7 @@ Contents:
overview
install
usage
Indices and tables
......
docs/snapshots/01_wizard.png

14 KiB

docs/snapshots/02_name.png

9.51 KiB

docs/snapshots/03_description.png

10.4 KiB

docs/snapshots/04_account.png

10.6 KiB

docs/snapshots/05_token.png

9.3 KiB

docs/snapshots/06_confirm.png

9.45 KiB

Usage
=====
snf-image-creator comes in 2 variants:
* snf-mkimage: A user-friendly dialog-based program
* snf-image-creator: A non-interactive command line program
Creating a new image
--------------------
Suppose you want to create a new ubuntu server image. Download the installation
disk from the internet:
.. code-block:: console
$ wget http://ubuntureleases.tsl.gr/12.04.1/ubuntu-12.04.1-server-amd64.iso
Create a 2G sparce file to host the new system:
.. code-block:: console
$ truncate -s 2G ubuntu_hd.raw
And install the ubuntu system on this file:
.. code-block:: console
$ sudo kvm -boot d -drive file=ubuntu_hd.raw,format=raw,cache=none,if=virtio \
-cdrom ubuntu-12.04.1-server-amd64.iso
After this, become root, activate the virtual environment you have installed
snf-image-creator in, and use *snf-mkimage* to create and upload the image:
.. code-block:: console
$ sudo -s
$ source /path/to/snf-image-env/bin/activate
$ snf-mkimage ubuntu_hd.raw
In the first screen you will be asked to choose if you want to run the program
in *Wizand* or *Expert* mode. Choose *Wizard*.
.. image:: /snapshots/01_wizard.png
Then you will be asked to provide a name, a description, an ~okeanos account
and the token corresponding to this account. After that you will be asked to
confirm the provided data.
.. image:: /snapshots/06_confirm.png
Choosing *YES* will create the image and upload it to your ~okeanos account.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment