root / docs / installation.rst @ 9e4508df
History | View | Annotate | Download (3.5 kB)
1 | 457cb69b | Stavros Sachtouris | Installation |
---|---|---|---|
2 | 457cb69b | Stavros Sachtouris | ============ |
3 | 457cb69b | Stavros Sachtouris | |
4 | 7536c9bf | Stavros Sachtouris | 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 advanced Linux/Unix-like users, it should be quite straightforward to install and have it up and running in most popular platforms. |
5 | 457cb69b | Stavros Sachtouris | |
6 | 5f5045b5 | Stavros Sachtouris | |
7 | 2151584b | Stavros Sachtouris | * Kamaki repository: `http://code.grnet.gr/git/kamaki <http://code.grnet.gr/git/kamaki>`_ |
8 | 2151584b | Stavros Sachtouris | |
9 | 2151584b | Stavros Sachtouris | * Synnefo Linux packages: `http://apt.dev.grnet.gr <http://apt.dev.grnet.gr>`_ |
10 | 2151584b | Stavros Sachtouris | |
11 | 457cb69b | Stavros Sachtouris | Linux and Unix-like enviroments |
12 | 457cb69b | Stavros Sachtouris | ------------------------------- |
13 | 457cb69b | Stavros Sachtouris | |
14 | 5f5045b5 | Stavros Sachtouris | .. _installing-from-source-ref: |
15 | 5f5045b5 | Stavros Sachtouris | |
16 | 457cb69b | Stavros Sachtouris | Installing from source (git repos.) |
17 | 457cb69b | Stavros Sachtouris | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
18 | 457cb69b | Stavros Sachtouris | |
19 | 961e6040 | Stavros Sachtouris | Requirements |
20 | 961e6040 | Stavros Sachtouris | """""""""""" |
21 | 961e6040 | Stavros Sachtouris | |
22 | 961e6040 | Stavros Sachtouris | Essential: |
23 | 961e6040 | Stavros Sachtouris | |
24 | 961e6040 | Stavros Sachtouris | * Python 2.6 or better [http://www.python.org] |
25 | 961e6040 | Stavros Sachtouris | * Python setuptools [http://pypi.python.org/pypi/setuptools] |
26 | 961e6040 | Stavros Sachtouris | |
27 | 961e6040 | Stavros Sachtouris | Optional: |
28 | 961e6040 | Stavros Sachtouris | |
29 | 961e6040 | Stavros Sachtouris | * VirtualEnv (python-virtualenv) [http://www.virtualenv.org] |
30 | 961e6040 | Stavros Sachtouris | |
31 | 5f5045b5 | Stavros Sachtouris | 1. Setup a virtual enviroment (optional) |
32 | 5f5045b5 | Stavros Sachtouris | """""""""""""""""""""""""""""""""""""""" |
33 | 5f5045b5 | Stavros Sachtouris | |
34 | 5f5045b5 | Stavros Sachtouris | With virtualenv users can setup kamaki and synnefo services in a sandbox environment. |
35 | 2151584b | Stavros Sachtouris | |
36 | 2151584b | Stavros Sachtouris | .. code-block:: console |
37 | 2151584b | Stavros Sachtouris | |
38 | 2151584b | Stavros Sachtouris | $ virtualenv kamaki-env |
39 | 2151584b | Stavros Sachtouris | |
40 | 2151584b | Stavros Sachtouris | $ source kamaki-env/bin/activate |
41 | 2151584b | Stavros Sachtouris | |
42 | 961e6040 | Stavros Sachtouris | 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>`_ |
43 | 2151584b | Stavros Sachtouris | |
44 | 961e6040 | Stavros Sachtouris | 2. Install snf-common |
45 | 961e6040 | Stavros Sachtouris | """"""""""""""""""""" |
46 | 5f5045b5 | Stavros Sachtouris | |
47 | 961e6040 | Stavros Sachtouris | Package snf-common is part of the synnefo project and is a kamaki dependency since version 0.6.0. |
48 | 2151584b | Stavros Sachtouris | |
49 | 2151584b | Stavros Sachtouris | .. code-block:: console |
50 | 2151584b | Stavros Sachtouris | |
51 | 2151584b | Stavros Sachtouris | $ git clone http://code.grnet.gr/git/synnefo |
52 | 2151584b | Stavros Sachtouris | |
53 | 2151584b | Stavros Sachtouris | $ cd synnefo/snf-common |
54 | 2151584b | Stavros Sachtouris | |
55 | 2151584b | Stavros Sachtouris | $ ./setup build install |
56 | 2151584b | Stavros Sachtouris | |
57 | 2151584b | Stavros Sachtouris | $ cd - |
58 | 2151584b | Stavros Sachtouris | |
59 | 5f5045b5 | Stavros Sachtouris | 3. Install kamaki |
60 | 5f5045b5 | Stavros Sachtouris | """"""""""""""""" |
61 | 2151584b | Stavros Sachtouris | |
62 | 2151584b | Stavros Sachtouris | .. code-block:: console |
63 | 2151584b | Stavros Sachtouris | |
64 | 2151584b | Stavros Sachtouris | $ git clone http://code.grnet.gr/git/kamaki |
65 | 2151584b | Stavros Sachtouris | |
66 | 2151584b | Stavros Sachtouris | $ cd kamaki |
67 | 2151584b | Stavros Sachtouris | |
68 | 2151584b | Stavros Sachtouris | $ ./setup build install |
69 | 2151584b | Stavros Sachtouris | |
70 | 5f5045b5 | Stavros Sachtouris | 4. Install progress and/or ansicolors (optional) |
71 | 5f5045b5 | Stavros Sachtouris | """""""""""""""""""""""""""""""""""""""""""""""" |
72 | 2151584b | Stavros Sachtouris | |
73 | 5f5045b5 | Stavros Sachtouris | progress: command-line progress bars (in some commands) |
74 | 5f5045b5 | Stavros Sachtouris | |
75 | 5f5045b5 | Stavros Sachtouris | ansicolors: color kamaki output (can switched on and off in `setup <setup.html>`_) |
76 | 2151584b | Stavros Sachtouris | |
77 | 2151584b | Stavros Sachtouris | .. code-block:: console |
78 | 2151584b | Stavros Sachtouris | |
79 | 2151584b | Stavros Sachtouris | $ pip install progress |
80 | 2151584b | Stavros Sachtouris | |
81 | 2151584b | Stavros Sachtouris | $ pip install ansicolors |
82 | 2151584b | Stavros Sachtouris | |
83 | 457cb69b | Stavros Sachtouris | Ubuntu and Debian packages |
84 | 457cb69b | Stavros Sachtouris | ^^^^^^^^^^^^^^^^^^^^^^^^^^ |
85 | 457cb69b | Stavros Sachtouris | |
86 | 5f5045b5 | Stavros Sachtouris | The following steps describe a command-line approach, but any graphic package manager can be used instead. |
87 | 5f5045b5 | Stavros Sachtouris | |
88 | 5f5045b5 | Stavros Sachtouris | 1. Add the following to apt sources list |
89 | 5f5045b5 | Stavros Sachtouris | """""""""""""""""""""""""""""""""""""""" |
90 | 5f5045b5 | Stavros Sachtouris | |
91 | 5f5045b5 | Stavros Sachtouris | * Debian:: |
92 | 5f5045b5 | Stavros Sachtouris | |
93 | 5f5045b5 | Stavros Sachtouris | deb http://apt.dev.grnet.gr/ sid main |
94 | 5f5045b5 | Stavros Sachtouris | |
95 | 5f5045b5 | Stavros Sachtouris | * Ubuntu:: |
96 | 5f5045b5 | Stavros Sachtouris | |
97 | 5f5045b5 | Stavros Sachtouris | deb http://apt.dev.grnet.gr/ precise main |
98 | 5f5045b5 | Stavros Sachtouris | |
99 | 5f5045b5 | Stavros Sachtouris | 2. Update |
100 | 5f5045b5 | Stavros Sachtouris | """"""""" |
101 | 5f5045b5 | Stavros Sachtouris | |
102 | 5f5045b5 | Stavros Sachtouris | .. code-block:: console |
103 | 5f5045b5 | Stavros Sachtouris | |
104 | 5f5045b5 | Stavros Sachtouris | $ sudo apt-get update |
105 | 5f5045b5 | Stavros Sachtouris | |
106 | 5f5045b5 | Stavros Sachtouris | .. note:: Safely ignore a signature verification error like the following, if it emerges: |
107 | 5f5045b5 | Stavros Sachtouris | |
108 | 5f5045b5 | Stavros Sachtouris | .. warning:: GPG error: http://apt.dev.grnet.gr precise/sid InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY XXXXXXXX |
109 | 5f5045b5 | Stavros Sachtouris | |
110 | 5f5045b5 | Stavros Sachtouris | 3. Install kamaki |
111 | 5f5045b5 | Stavros Sachtouris | """"""""""""""""" |
112 | 5f5045b5 | Stavros Sachtouris | |
113 | 5f5045b5 | Stavros Sachtouris | Since version 0.6.0, the package snf-common (available at synnefo apt repository) will be automatically installed as a dependency. |
114 | 5f5045b5 | Stavros Sachtouris | |
115 | 5f5045b5 | Stavros Sachtouris | .. code-block:: console |
116 | 5f5045b5 | Stavros Sachtouris | |
117 | 5f5045b5 | Stavros Sachtouris | $ sudo apt-get install kamaki |
118 | 5f5045b5 | Stavros Sachtouris | |
119 | 5f5045b5 | Stavros Sachtouris | 4. Install ansicolors and/or progress (Optional) |
120 | 5f5045b5 | Stavros Sachtouris | """""""""""""""""""""""""""""""""""""""""""""""" |
121 | 5f5045b5 | Stavros Sachtouris | |
122 | 5f5045b5 | Stavros Sachtouris | .. code-block:: console |
123 | 5f5045b5 | Stavros Sachtouris | |
124 | 5f5045b5 | Stavros Sachtouris | $ sudo apt-get install python-ansicolors |
125 | 5f5045b5 | Stavros Sachtouris | |
126 | 5f5045b5 | Stavros Sachtouris | $ sudo apt-get install python-progress |
127 | 5f5045b5 | Stavros Sachtouris | |
128 | 5f5045b5 | Stavros Sachtouris | Mac OS X |
129 | 5f5045b5 | Stavros Sachtouris | -------- |
130 | 5f5045b5 | Stavros Sachtouris | |
131 | 5f5045b5 | Stavros Sachtouris | Kamaki can be installed on Mac OS X systems from source, by following the steps at :ref:`installing-from-source-ref`. |
132 | 457cb69b | Stavros Sachtouris | |
133 | 457cb69b | Stavros Sachtouris | Windows |
134 | 457cb69b | Stavros Sachtouris | ------- |
135 | 457cb69b | Stavros Sachtouris | |
136 | 9e4508df | Stavros Sachtouris | 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. |