* Kamaki repository: `http://code.grnet.gr/git/kamaki <http://code.grnet.gr/git/kamaki>`_
-* Synnefo Linux packages: `http://apt.dev.grnet.gr <http://apt.dev.grnet.gr>`_
+* Synnefo Linux packages: `http://apt.dev.grnet.gr <http://apt.dev.grnet.gr>`_, `http://apt2.dev.grnet.gr <http://apt2.dev.grnet.gr>`_
Linux and Unix-like enviroments
-------------------------------
+Debian:
+^^^^^^^
+
+The following steps describe a command-line approach, but any graphic package manager can be used instead.
+
+* As root, append the following to */etc/apt/sources.list* ::
+
+ deb http://apt.dev.grnet.gr/ squeeze main
+ deb http://apt2.dev.grnet.gr stable/
+
+* Make sure the GPG public key for the GRNET dev team is added:
+
+ .. code-block:: console
+
+ $ sudo curl https://dev.grnet.gr/files/apt-grnetdev.pub|apt-key add -
+
+ otherwise *apt-get update* will produce GPG warnings.
+
+* Update the Debian sources:
+
+ .. code-block:: console
+
+ $ sudo apt-get update
+
+* Install kamaki:
+
+ .. code-block:: console
+
+ $ sudo apt-get install kamaki
+
+Ubuntu
+^^^^^^
+
+The following steps describe a command-line approach, but any graphic package manager can be used instead.
+
+* Let ppa take care of the repository configuration:
+
+ .. code-block:: console
+
+ $ sudo apt-get install python-software-properties
+ $ sudo add-apt-repository ppa:grnet/synnefo
+
+* Update the Debian sources:
+
+ .. code-block:: console
+
+ $ sudo apt-get update
+
+* Install kamaki:
+
+ .. code-block:: console
+
+ $ sudo apt-get install kamaki
+
+Install ansicolors and/or progress (Optional but recommended)
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+.. code-block:: console
+
+ $ sudo apt-get install python-ansicolors
+ $ sudo apt-get install python-progress
+
.. _installing-from-source-ref:
Installing from source (git repos.)
* VirtualEnv (python-virtualenv) [http://www.virtualenv.org]
-1. Setup a virtual enviroment (optional)
-""""""""""""""""""""""""""""""""""""""""
+Setup a virtual enviroment (optional)
+"""""""""""""""""""""""""""""""""""""
With virtualenv users can setup kamaki and synnefo services in a sandbox environment.
A more detailed example of using virtual env can be found at the `snf-image-creator setup guide <http://docs.dev.grnet.gr/snf-image-creator/latest/install.html#python-virtual-environment>`_
-2. Install objpool (was: snf-common)
-""""""""""""""""""""""""""""""""""""""""""
-
-.. note:: **versions 0.6.0 - 0.6.1**
-
- Package snf-common is part of the synnefo project and used to be a kamaki dependency in versions from 0.6.0 to 0.6.1 to provide a connection pooling mechanism. Users who still run 0.6.0 or 0.6.1 may need to manually install the snf-common package:
-
- .. code-block:: console
-
- $ git clone http://code.grnet.gr/git/synnefo
- $ cd synnefo/snf-common
- $ ./setup build install
- $ cd -
+Install objpool (was: snf-common)
+"""""""""""""""""""""""""""""""""
-**Version 0.6.2 and on:**
-
-Since 0.6.2, kamaki is based on objpool (hence the snf-common dependency is now obsolete). The objpool package is easy to install from source, even on windows platforms:
+Since 0.6.2, kamaki is based on python-objpool. The objpool package is easy to install from source (even on windows platforms):
.. code-block:: console
$ ./setup build install
$ cd -
-3. Install kamaki
-"""""""""""""""""
+Install kamaki
+""""""""""""""
+
+Kamaki can be downloaded from `this location <https://code.grnet.gr/projects/kamaki/files>`_, where users can pick the version they prefer and unzip it locally:
+
+.. code-block:: console
+
+ $ tar xvfz kamaki-0.6.2.tar.gz
+
+or it can be downloaded directly from the git repository:
.. code-block:: console
$ git clone http://code.grnet.gr/git/kamaki
+
+and then installed by the setup script:
+
+.. code-block:: console
+
$ cd kamaki
$ ./setup build install
-4. Install progress and/or ansicolors (optional)
-""""""""""""""""""""""""""""""""""""""""""""""""
+Install progress and/or ansicolors (optional)
+"""""""""""""""""""""""""""""""""""""""""""""
progress: command-line progress bars (in some commands)
$ pip install progress
$ pip install ansicolors
-Ubuntu and Debian packages
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+Mac OS X
+--------
-The following steps describe a command-line approach, but any graphic package manager can be used instead.
+Kamaki can be installed on Mac OS X systems from source, by following the steps at :ref:`installing-from-source-ref`.
-1. Add the following to apt sources list
-""""""""""""""""""""""""""""""""""""""""
+Windows
+-------
-* Debian::
+Since version 0.6.2 kamaki can run on Windows, either on standard Windows console, or inside an improved command line shell. The present guide presents a tested method for using kamaki in windows
- deb http://apt.dev.grnet.gr/ sid main
+Requirements
+^^^^^^^^^^^^
-* Ubuntu::
+* Python 2.7 or better (`Official versions <http://www.python.org/getit>`_)
- deb http://apt.dev.grnet.gr/ precise main
+* Git (download `windows version <http://git-scm.com/download/win>`_)
-2. Update
-"""""""""
+* Setuptools (`Official versions and workarounds <http://pypi.python.org/pypi/setuptools>`_)
-.. code-block:: console
+Installation from source
+^^^^^^^^^^^^^^^^^^^^^^^^
- $ sudo apt-get update
+Install python
+""""""""""""""
-.. note:: Don't forget to get the GPG public key for the GRNET dev team:
+Download and run the Windows installer from `here <http://www.python.org/getit>`_
- .. code-block:: console
+Users should pick the installer that fits their windows version and architecture.
- $ curl https://okeanos.io/files/apt-grnetdev.pub|apt-key add -
+Add python to windows path
+""""""""""""""""""""""""""
- otherwise *apt-get update* will produce GPG warnings.
+The following will allow users to run python and python scripts from command line.
-3. Install kamaki
-"""""""""""""""""
+* Select **System** from the Control Panel, select the **Advanced** tab, the **Environment Variables** button and then find the **PATH** (user or system) and **edit**
-.. note:: **versions 0.6.0 - 0.6.1:**
+* Without removing existing values, append the following to PATH::
- The *snf-common* package (available at synnefo apt repository) will be automatically installed as a dependency.
+ C:\Python;C:\Python\Scripts
-.. note:: **versions 0.6.2 and on:**
+.. note:: Path values are separated by semicolons
- Since version 0.6.2, *objpool* replaces *snf-common*. The objpool package is also available at synnefo repository and is automatically installed as a dependency. The *snf-common* dependency is removed.
+.. warning:: C:\\Python should be replaced with the actual python path in the system, e.g. C:\\Python27
-.. code-block:: console
+Install setuptools
+""""""""""""""""""
- $ sudo apt-get install kamaki
+According to the corresponding `python org page <http://pypi.python.org/pypi/setuptools>`_, the setuptools installer doesn't currently work on 64bit machines.
-4. Install ansicolors and/or progress (Optional)
-""""""""""""""""""""""""""""""""""""""""""""""""
+* Users with 32-bit operating systems should download and run the graphic installer
-.. code-block:: console
+* Users with 64-bit machines should download the `ez_setup.py <http://peak.telecommunity.com/dist/ez_setup.py>`_ script and install it from a command shell. In the following example, the script was downloaded at C:\\Downloads::
- $ sudo apt-get install python-ansicolors
- $ sudo apt-get install python-progress
+ C:\> cd Downloads
+ C:\Downloads\> python ez_setup.py
+ ...
+ Installation finished
+ C:\Downloads\>
-Mac OS X
---------
+Install GIT
+"""""""""""
-Kamaki can be installed on Mac OS X systems from source, by following the steps at :ref:`installing-from-source-ref`.
+`Download GIT <http://git-scm.com/download/win>`_ and run the graphic installer. During the installation, users will be able to modify some installation options. The present guide is tested with the default selections.
-Windows
--------
+After the installation is completed, a GIT standalone shell will be installed (a desktop shortcut is created, by default). Users are advised to run kamaki through this shell.
+
+Install kamaki
+""""""""""""""
+
+* Run the GIT standalone shell
+
+* Enter the location where kamaki will be installed, e.g. **C:\\**
+
+ .. code-block:: console
+
+ $ cd /c/
+
+* Download source from GRNET repository
+
+ .. code-block:: console
+
+ $ git clone http://code.grnet.gr/git/kamaki
+ Cloning into 'kamaki'...
+ Receiving objects: ...
+ Resolving Deltas: ...
+
+* Enter source and install kamaki
+
+ .. code-block:: console
+
+ $ cd kamaki
+ $ python setup.py install
+ running install
+ ...
+ Finished processing dependencies for kamaki==0.6.2
+
+.. warning:: kamaki version should be 0.6.2 or better, otherwise it will not function. Users can test that by running::
-Although it is proven not too tricky to install kamaki on Windows console using `git for windows <http://git-scm.com/downloads>`_, Windows environments are not supported at the time being.
+ $ kamaki --version