Revision ec3b8f78 docs/installation.rst
| b/docs/installation.rst | ||
|---|---|---|
| 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. |
|
Also available in: Unified diff