3. Installation

This guide describes the standard installation process for kamaki, with the aspiration of covering as much cases as possible. Although kamaki was initially targeted to Linux/Unix-like users, it is quite straightforward to install and have it up and running in all platforms running Python 2.6 or 2.7.

3.1. Linux and Unix-like environments

3.1.1. Debian

For Debian 9.0 (stretch):

  • As root, append the following to /etc/apt/sources.list

    deb http://apt.dev.grnet.gr stretch/
    

Note

For Debian 8.0 (jessie) replace stretch/ with jessie/ in the appeded line above

  • Make sure the GPG public key for the Synnefo repository is added:

    # curl https://dev.grnet.gr/files/apt-grnetdev.pub|apt-key add -
    

    otherwise apt-get update will produce GPG warnings.

  • Update and install:

    # apt-get update
    # apt-get install kamaki
    

3.1.2. Ubuntu

For Ubuntu 12.04 LTS, 14.04 LTS and 16.04 LTS:

$ sudo apt-get install python-software-properties
$ sudo add-apt-repository ppa:grnet/synnefo
$ sudo apt-get update
$ sudo apt-get install kamaki

3.1.3. Fedora

For Fedora 23:

# cd /etc/yum.repos.d
# wget http://download.opensuse.org/repositories/home:/GRNET:/synnefo/Fedora_21/home:GRNET:synnefo.repo
# yum install kamaki

3.1.4. CentOS

For CentOS 7:

# cd /etc/yum.repos.d
# wget http://download.opensuse.org/repositories/home:/GRNET:/synnefo/CentOS_7/home:GRNET:synnefo.repo
# yum install kamaki

3.1.5. OpenSUSE

For OpenSUSE 13.2:

# zypper ar -f http://download.opensuse.org/repositories/home:/GRNET:/synnefo/openSUSE_13.2/home:GRNET:synnefo.repo
# zypper in kamaki

3.1.7. Adding support for unit tests (developers only)

To make the unit tests work, install the python mock library. Under Debian you can do this by executing the following command as root:

# apt-get install python-mock

3.2. Installing from pypi

Requirements:

Installation:

$ pip install kamaki

Optional packages: The ansicolors package enables terminal output coloring. The mock package allows unit testing while hacking the code.

$ pip install ansicolors
$ pip install mock

3.3. Mac OS X

Kamaki can be installed on Mac OS X systems, by following the steps at Enabling terminal colors (optional but recommended).

3.4. Windows

Kamaki can be installed on Windows by following the pypi method. Installing the requirements is a bit different than in other systems.

Requirements

3.4.1. Install Python

Note

Skip this step if python 2.7 is already installed

Download and run the Windows installer from the download page pick the one that fits your 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:\Python27;C:\Python27\Scripts
    

Note

Path values are separated by semicolons

Warning

In case of a different version, C:\Python27 should be replaced with the actual python path in the system

3.4.2. Install Setuptools

Note

Skip this step if setuptools are already installed

See here for installation instructions.

Note

Users with 64-bit platforms should download the ez_setup.py script and install it from a command shell. In the following example, the script was downloaded at C:\Downloads:

C:\> cd Downloads
C:\Downloads\> python ez_setup.py
...
Installation finished
C:\Downloads\>

3.4.3. Install kamaki

$ easy_install kamaki