Synnefo » ./kamaki

* Synnefo Linux packages: `http://apt.dev.grnet.gr <http://apt.dev.grnet.gr>`_, `http://apt2.dev.grnet.gr <http://apt2.dev.grnet.gr>`_

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

Requirements

^^^^^^^^^^^^

* Python 2.7 or better (Official versions `here <http://www.python.org/getit>`_)

* Git (download `windows version <http://git-scm.com/download/win>`_)

* Setuptools (Official versions and workarrounds `here <http://pypi.python.org/pypi/setuptools>`_)

Installation from source

^^^^^^^^^^^^^^^^^^^^^^^^

Install python

""""""""""""""

Download and run the Windows installer from `here <http://www.python.org/getit>`_

Users should pick the installer that fits their windows version and architecture.

Add python to windows path

""""""""""""""""""""""""""

The following will allow users to run python and python scripts from command line.

* Select **System** from the Control Panel, select the **Advanced** tab, the **Environment Variables** button and then find the **PATH** (user or system) and **edit**

* Without removing existing values, append the following to PATH:

    C:\Python;C:\Python\Scripts

    .. note:: Path values are separated by a semicolons

    .. warning:: C:\Python should be replaced with the actual python path in the system, e.g. C:\Python27

Install setuptools

""""""""""""""""""

According to the corresponding `python.org page <http://pypi.python.org/pypi/setuptools>`_, the setuptools installer doesn't currently work on 64bit machines.

* Users with 32-bit operating systems should download and run the graphic installer

* 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, the script is downloaded at C:\Downloads::

    C:\> cd Downloads

    C:\Downloads\> python ez_setup.py

    ...

    Installation finished

    C:\Downloads\>

Install GIT

"""""""""""

Download GIT from `here <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.

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::

    $ kamaki --version