| 11 |
11 |
Linux and Unix-like enviroments
|
| 12 |
12 |
-------------------------------
|
| 13 |
13 |
|
|
14 |
Ubuntu and Debian packages
|
|
15 |
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
16 |
|
|
17 |
The following steps describe a command-line approach, but any graphic package manager can be used instead.
|
|
18 |
|
|
19 |
Add the following to apt sources list
|
|
20 |
"""""""""""""""""""""""""""""""""""""
|
|
21 |
|
|
22 |
As root, append one of the following to */etc/apt/sources.list*:
|
|
23 |
|
|
24 |
* Debian Sid (kamaki 0.6.2)::
|
|
25 |
|
|
26 |
deb http://apt.dev.grnet.gr/ sid main
|
|
27 |
|
|
28 |
* Debian Stable (kamaki 0.6.1)::
|
|
29 |
|
|
30 |
deb http://apt.dev.grnet.gr/ squeeze main
|
|
31 |
deb http://apt2.dev.grnet.gr stable/
|
|
32 |
|
|
33 |
* Ubuntu (kamaki 0.6.1)::
|
|
34 |
|
|
35 |
deb http://apt.dev.grnet.gr/ precise main
|
|
36 |
|
|
37 |
|
|
38 |
Update
|
|
39 |
""""""
|
|
40 |
|
|
41 |
.. note:: make sure the GPG public key for the GRNET dev team is added:
|
|
42 |
|
|
43 |
.. code-block:: console
|
|
44 |
|
|
45 |
$ curl https://dev.grnet.gr/files/apt-grnetdev.pub|apt-key add -
|
|
46 |
|
|
47 |
otherwise *apt-get update* will produce GPG warnings.
|
|
48 |
|
|
49 |
.. code-block:: console
|
|
50 |
|
|
51 |
$ sudo apt-get update
|
|
52 |
|
|
53 |
|
|
54 |
Install kamaki
|
|
55 |
""""""""""""""
|
|
56 |
|
|
57 |
.. note:: **versions 0.6.0 - 0.6.1:**
|
|
58 |
|
|
59 |
The *snf-common* package (available at synnefo apt repository) will be automatically installed as a dependency.
|
|
60 |
|
|
61 |
.. note:: **versions 0.6.2 and on:**
|
|
62 |
|
|
63 |
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.
|
|
64 |
|
|
65 |
.. code-block:: console
|
|
66 |
|
|
67 |
$ sudo apt-get install kamaki
|
|
68 |
|
|
69 |
Install ansicolors and/or progress (Optional)
|
|
70 |
"""""""""""""""""""""""""""""""""""""""""""""
|
|
71 |
|
|
72 |
.. code-block:: console
|
|
73 |
|
|
74 |
$ sudo apt-get install python-ansicolors
|
|
75 |
$ sudo apt-get install python-progress
|
|
76 |
|
| 14 |
77 |
.. _installing-from-source-ref:
|
| 15 |
78 |
|
| 16 |
79 |
Installing from source (git repos.)
|
| ... | ... | |
| 28 |
91 |
|
| 29 |
92 |
* VirtualEnv (python-virtualenv) [http://www.virtualenv.org]
|
| 30 |
93 |
|
| 31 |
|
1. Setup a virtual enviroment (optional)
|
| 32 |
|
""""""""""""""""""""""""""""""""""""""""
|
|
94 |
Setup a virtual enviroment (optional)
|
|
95 |
"""""""""""""""""""""""""""""""""""""
|
| 33 |
96 |
|
| 34 |
97 |
With virtualenv users can setup kamaki and synnefo services in a sandbox environment.
|
| 35 |
98 |
|
| ... | ... | |
| 40 |
103 |
|
| 41 |
104 |
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>`_
|
| 42 |
105 |
|
| 43 |
|
2. Install objpool (was: snf-common)
|
| 44 |
|
""""""""""""""""""""""""""""""""""""""""""
|
|
106 |
Install objpool (was: snf-common)
|
|
107 |
"""""""""""""""""""""""""""""""""
|
| 45 |
108 |
|
| 46 |
109 |
.. note:: **versions 0.6.0 - 0.6.1**
|
| 47 |
110 |
|
| ... | ... | |
| 65 |
128 |
$ ./setup build install
|
| 66 |
129 |
$ cd -
|
| 67 |
130 |
|
| 68 |
|
3. Install kamaki
|
| 69 |
|
"""""""""""""""""
|
|
131 |
Install kamaki
|
|
132 |
""""""""""""""
|
| 70 |
133 |
|
| 71 |
134 |
.. code-block:: console
|
| 72 |
135 |
|
| ... | ... | |
| 74 |
137 |
$ cd kamaki
|
| 75 |
138 |
$ ./setup build install
|
| 76 |
139 |
|
| 77 |
|
4. Install progress and/or ansicolors (optional)
|
| 78 |
|
""""""""""""""""""""""""""""""""""""""""""""""""
|
|
140 |
Install progress and/or ansicolors (optional)
|
|
141 |
"""""""""""""""""""""""""""""""""""""""""""""
|
| 79 |
142 |
|
| 80 |
143 |
progress: command-line progress bars (in some commands)
|
| 81 |
144 |
|
| ... | ... | |
| 86 |
149 |
$ pip install progress
|
| 87 |
150 |
$ pip install ansicolors
|
| 88 |
151 |
|
| 89 |
|
Ubuntu and Debian packages
|
| 90 |
|
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
| 91 |
|
|
| 92 |
|
The following steps describe a command-line approach, but any graphic package manager can be used instead.
|
| 93 |
|
|
| 94 |
|
1. Add the following to apt sources list
|
| 95 |
|
""""""""""""""""""""""""""""""""""""""""
|
| 96 |
|
|
| 97 |
|
* Debian::
|
| 98 |
|
|
| 99 |
|
deb http://apt.dev.grnet.gr/ sid main
|
| 100 |
|
|
| 101 |
|
* Ubuntu::
|
| 102 |
|
|
| 103 |
|
deb http://apt.dev.grnet.gr/ precise main
|
| 104 |
|
|
| 105 |
|
2. Update
|
| 106 |
|
"""""""""
|
| 107 |
|
|
| 108 |
|
.. code-block:: console
|
| 109 |
|
|
| 110 |
|
$ sudo apt-get update
|
| 111 |
|
|
| 112 |
|
.. note:: Don't forget to get the GPG public key for the GRNET dev team:
|
| 113 |
|
|
| 114 |
|
.. code-block:: console
|
| 115 |
|
|
| 116 |
|
$ curl https://dev.grnet.gr/files/apt-grnetdev.pub|apt-key add -
|
| 117 |
|
|
| 118 |
|
otherwise *apt-get update* will produce GPG warnings.
|
| 119 |
|
|
| 120 |
|
3. Install kamaki
|
| 121 |
|
"""""""""""""""""
|
| 122 |
|
|
| 123 |
|
.. note:: **versions 0.6.0 - 0.6.1:**
|
| 124 |
|
|
| 125 |
|
The *snf-common* package (available at synnefo apt repository) will be automatically installed as a dependency.
|
| 126 |
|
|
| 127 |
|
.. note:: **versions 0.6.2 and on:**
|
| 128 |
|
|
| 129 |
|
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.
|
| 130 |
|
|
| 131 |
|
.. code-block:: console
|
| 132 |
|
|
| 133 |
|
$ sudo apt-get install kamaki
|
| 134 |
|
|
| 135 |
|
4. Install ansicolors and/or progress (Optional)
|
| 136 |
|
""""""""""""""""""""""""""""""""""""""""""""""""
|
| 137 |
|
|
| 138 |
|
.. code-block:: console
|
| 139 |
|
|
| 140 |
|
$ sudo apt-get install python-ansicolors
|
| 141 |
|
$ sudo apt-get install python-progress
|
| 142 |
|
|
| 143 |
152 |
Mac OS X
|
| 144 |
153 |
--------
|
| 145 |
154 |
|
| ... | ... | |
| 148 |
157 |
Windows
|
| 149 |
158 |
-------
|
| 150 |
159 |
|
| 151 |
|
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.
|
|
160 |
Since version 0.6.2 kamaki can run on Windows, either on standard Windows console, or inside an improved command line shell.
|