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.
For Debian 7.0 (wheezy):
As root, append the following to /etc/apt/sources.list
deb http://apt.dev.grnet.gr wheezy/
Make sure the GPG public key for the Synnefo repository is added:
$ sudo curl https://dev.grnet.gr/files/apt-grnetdev.pub|apt-key add -
otherwise apt-get update will produce GPG warnings.
Update and install:
$ sudo apt-get update $ sudo apt-get install kamaki
The “python-ansicolors” package enables colorful terminal outputs.
E.g., in Debian:
$ sudo apt-get install python-ansicolors
After the installation, tell kamaki to use the feature
$ kamaki config set colors on
Install the “python-mock” package to make unit tests work (developers only).
$ sudo apt-get install python-mock
For Ubuntu 12.04 LTS, 12.10 and 13.04:
$ sudo apt-get install python-software-properties
$ sudo add-apt-repository ppa:grnet/synnefo
$ sudo apt-get update
$ sudo apt-get install kamaki
For Fedora 17:
$ cd /etc/yum.repos.d
$ wget http://download.opensuse.org/repositories/home:/GRNET:/synnefo/Fedora_17/home:GRNET:synnefo.repo
$ yum install kamaki
For CentOS 6:
$ cd /etc/yum.repos.d
$ wget http://download.opensuse.org/repositories/home:/GRNET:/synnefo/CentOS_CentOS-6/home:GRNET:synnefo.repo
$ yum install kamaki
For OpenSUSE 12.3:
$ zypper ar -f http://download.opensuse.org/repositories/home:/GRNET:/synnefo/openSUSE_12.3/home:GRNET:synnefo.repo
$ zypper in kamaki
Requirements:
- Python 2.7 [http://www.python.org]
- Python setuptools [http://pypi.python.org/pypi/setuptools]
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
Kamaki can be installed on Mac OS X systems, by following the steps at Installing from pypi.
Kamaki can be installed on Windows by following the pypi method. Installing the requirements is a bit different than in other systems.
Requirements
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.
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
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\>
$ easy_install kamaki