Synnefo

Installation of `kamaki`

~~~~~~~~~~~~~~~~~~~~~~~~

You can install `kamaki` anywhere you like, since it is a standalone client of

the APIs and talks to the installation over `http`. For the purpose of this

guide we will assume that we have downloaded the `Debian Squeeze Base Image

<https://pithos.okeanos.grnet.gr/public/9epgb>`_ and stored it under node1's

``/srv/images`` directory. For that reason we will install `kamaki` on node1,

too. We do this by running:

.. code-block:: console

   # apt-get install kamaki

Configuration of kamaki

~~~~~~~~~~~~~~~~~~~~~~~

Now we need to setup kamaki, by adding the appropriate URLs and tokens of our

installation. We do this by running:

.. code-block:: console

   $ kamaki config set cloud.default.url \

       "https://node1.example.com/astakos/identity/v2.0"

   $ kamaki config set cloud.default.token USER_TOKEN

Both the Authentication URL and the USER_TOKEN appear on the user's

`API access` web page on the Astakos Web UI.

You can see that the new configuration options have been applied correctly,

either by checking the editable file ``~/.kamakirc`` or by running:

.. code-block:: console

   $ kamaki config list

A quick test to check that kamaki is configured correctly, is to try to

authenticate a user based on his/her token (in this case the user is you):

.. code-block:: console

  $ kamaki user authenticate

The above operation provides various user information, e.g. UUID (the unique

user id) which might prove useful in some operations.

Upload an Image file to Pithos

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Now, that we have set up `kamaki` we will upload the Image that we have

downloaded and stored under ``/srv/images/``. Although we can upload the Image

under the root ``Pithos`` container (as you may have done when uploading the

Image from the Pithos Web UI), we will create a new container called ``images``

and store the Image under that container. We do this for two reasons:

a) To demonstrate how to create containers other than the default ``Pithos``.

   This can be done only with the `kamaki` client and not through the Web UI.

b) As a best organization practise, so that you won't have your Image files

   tangled along with all your other Pithos files and directory structures.

We create the new ``images`` container by running:

.. code-block:: console

   $ kamaki container create images

To check if the container has been created, list all containers of your

account:

.. code-block:: console

  $ kamaki file list /images

Then, we upload the Image file to that container:

.. code-block:: console

   $ kamaki file upload /srv/images/debian_base-6.0-7-x86_64.diskdump /images

The first is the local path and the second is the remote container on Pithos.

Check if the file has been uploaded, by listing the container contents:

.. code-block:: console

  $ kamaki file list /images

Alternatively check if the new container and file appear on the Pithos Web UI.

   $ kamaki image register --name "Debian Base" \

                           --location /images/debian_base-6.0-11-x86_64.diskdump \

                           --public \

                           --disk-format=diskdump \

                           --property OSFAMILY=linux --property ROOT_PARTITION=1 \

                           --property description="Debian Squeeze Base System" \

                           --property size=451 --property kernel=2.6.32 --property GUI="No GUI" \

                           --property sortorder=1 --property USERS=root --property OS=debian