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.
- Kamaki repository: http://github.com/grnet/kamaki
- Kamaki at PyPI: http://pypi.python.org/pypi/kamaki
- Synnefo APT repositories: http://apt.dev.grnet.gr
3.1. Linux and Unix-like environments¶
3.1.1. Debian¶
For Debian 8.0 (jessie):
As root, append the following to /etc/apt/sources.list
deb http://apt.dev.grnet.gr jessie/
Note
For Debian 7.0 (wheezy) replace jessie/ with wheezy/ 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.6. Enabling terminal colors (optional but recommended)¶
The python ansicolors library enables colorful terminal outputs. To install it under Debian use the following command as root:
# apt-get install python-ansicolors
After the installation, tell kamaki to use the feature by executing:
$ kamaki config set colors on
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:
- 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
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
- Python 2.7 (Official versions)
- Setuptools (Official versions and workarounds)
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