root / docs / index.rst @ 20c0dfdc
History | View | Annotate | Download (5.7 kB)
1 | aacbeed2 | Constantinos Venetsanopoulos | Welcome to Synnefo's documentation |
---|---|---|---|
2 | bc055d09 | Constantinos Venetsanopoulos | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
3 | 9940eacf | Kostas Papadimitriou | |
4 | 9940eacf | Kostas Papadimitriou | .. image:: /images/synnefo-logo.png |
5 | 9940eacf | Kostas Papadimitriou | |
6 | 31e6eb2d | Constantinos Venetsanopoulos | | Synnefo is open source cloud software, used to create massively scalable IaaS |
7 | 31e6eb2d | Constantinos Venetsanopoulos | clouds. |
8 | 64bcbfe9 | Kostas Papadimitriou | | Synnefo uses `Google Ganeti <http://code.google.com/p/ganeti/>`_ for the low |
9 | 31e6eb2d | Constantinos Venetsanopoulos | level VM management part. |
10 | 9940eacf | Kostas Papadimitriou | |
11 | aacbeed2 | Constantinos Venetsanopoulos | | You can see Synnefo in action, powering GRNET's |
12 | 31e6eb2d | Constantinos Venetsanopoulos | `~okeanos public cloud service <http://okeanos.io>`_. |
13 | d0e436db | Constantinos Venetsanopoulos | | It is a collection of components (snf-*), most of them written in python, that |
14 | d0e436db | Constantinos Venetsanopoulos | are used as the building bricks to provide the following services: |
15 | 9940eacf | Kostas Papadimitriou | |
16 | d0e436db | Constantinos Venetsanopoulos | .. toctree:: |
17 | d0e436db | Constantinos Venetsanopoulos | :maxdepth: 1 |
18 | 9940eacf | Kostas Papadimitriou | |
19 | bc055d09 | Constantinos Venetsanopoulos | Identity Management (codename: astakos) <astakos> |
20 | 301294a9 | Constantinos Venetsanopoulos | Object Storage Service (codename: pithos) <pithos> |
21 | b11446c1 | Constantinos Venetsanopoulos | Compute Service (codename: cyclades) <cyclades> |
22 | b11446c1 | Constantinos Venetsanopoulos | Network Service (part of Cyclades) <networks> |
23 | 301294a9 | Constantinos Venetsanopoulos | Image Service (codename: plankton) <plankton> |
24 | bc055d09 | Constantinos Venetsanopoulos | Volume Storage Service (codename: archipelago) <archipelago> |
25 | d0e436db | Constantinos Venetsanopoulos | |
26 | d6153e72 | Kostas Papadimitriou | .. image:: images/synnefo-overview.png |
27 | 16539dad | Kostas Papadimitriou | :target: _images/synnefo-overview.png |
28 | d6153e72 | Kostas Papadimitriou | |
29 | 301294a9 | Constantinos Venetsanopoulos | There are also the following tools: |
30 | 9940eacf | Kostas Papadimitriou | |
31 | 9940eacf | Kostas Papadimitriou | .. toctree:: |
32 | 9940eacf | Kostas Papadimitriou | :maxdepth: 1 |
33 | 9940eacf | Kostas Papadimitriou | |
34 | 301294a9 | Constantinos Venetsanopoulos | kamaki: Command-line client <http://docs.dev.grnet.gr/kamaki/latest/index.html> |
35 | 20c0dfdc | Dimitris Aragiorgis | snf-deploy: Synnefo deployment tool <snf-deploy> |
36 | 301294a9 | Constantinos Venetsanopoulos | snf-image-creator: Image bundling/uploading/registering tool <http://docs.dev.grnet.gr/snf-image-creator/latest/index.html> |
37 | 301294a9 | Constantinos Venetsanopoulos | snf-image: Secure image deployment tool <snf-image> |
38 | 77180645 | Dimitris Aragiorgis | |
39 | d0e436db | Constantinos Venetsanopoulos | |
40 | aacbeed2 | Constantinos Venetsanopoulos | Synnefo is designed to be as simple, scalable and production ready as possible. |
41 | d0e436db | Constantinos Venetsanopoulos | Furthermore, although it can be deployed in small configurations, its prime |
42 | 301294a9 | Constantinos Venetsanopoulos | target is large installations. |
43 | d0e436db | Constantinos Venetsanopoulos | |
44 | 301294a9 | Constantinos Venetsanopoulos | All Synnefo components use an intuitive settings mechanism, that adds and removes |
45 | 301294a9 | Constantinos Venetsanopoulos | settings dynamically as components are getting added or removed from a physical |
46 | 301294a9 | Constantinos Venetsanopoulos | node. All settings are stored in a single location. |
47 | d0e436db | Constantinos Venetsanopoulos | |
48 | 301294a9 | Constantinos Venetsanopoulos | .. _general-arch: |
49 | d0e436db | Constantinos Venetsanopoulos | |
50 | eab73849 | Constantinos Venetsanopoulos | Synnefo General Architecture |
51 | eab73849 | Constantinos Venetsanopoulos | ============================ |
52 | eab73849 | Constantinos Venetsanopoulos | |
53 | eab73849 | Constantinos Venetsanopoulos | The following graph shows the whole Synnefo architecture and how it interacts |
54 | 301294a9 | Constantinos Venetsanopoulos | with multiple Ganeti clusters. |
55 | eab73849 | Constantinos Venetsanopoulos | |
56 | 301294a9 | Constantinos Venetsanopoulos | .. image:: images/synnefo-arch2.png |
57 | 16539dad | Kostas Papadimitriou | :width: 100% |
58 | 301294a9 | Constantinos Venetsanopoulos | :target: _images/synnefo-arch2.png |
59 | eab73849 | Constantinos Venetsanopoulos | |
60 | 301294a9 | Constantinos Venetsanopoulos | Synnefo also supports RADOS as an alternative storage backend for |
61 | 301294a9 | Constantinos Venetsanopoulos | Files/Images/VM disks. :ref:`Here <syn+archip+rados>` is a graph that shows |
62 | 301294a9 | Constantinos Venetsanopoulos | Synnefo running with two different storage backends. |
63 | eab73849 | Constantinos Venetsanopoulos | |
64 | bc055d09 | Constantinos Venetsanopoulos | Synnefo Guides |
65 | bc055d09 | Constantinos Venetsanopoulos | ============== |
66 | d0e436db | Constantinos Venetsanopoulos | |
67 | 20c0dfdc | Dimitris Aragiorgis | There are 4 guides for Synnefo. |
68 | 77180645 | Dimitris Aragiorgis | |
69 | 20c0dfdc | Dimitris Aragiorgis | .. For the really impatient snf-deploy tool allows you to install all software |
70 | 20c0dfdc | Dimitris Aragiorgis | .. components from scratch (creating locally kvm based Virtual Machines) or to an |
71 | 20c0dfdc | Dimitris Aragiorgis | .. existing cluster (in the same network subnet and domain, same network |
72 | 20c0dfdc | Dimitris Aragiorgis | .. configuration, vanilla debian squeeze and installed ssh keys). Please note that |
73 | 20c0dfdc | Dimitris Aragiorgis | .. this should be used only for testing or demo installations because most of the |
74 | 20c0dfdc | Dimitris Aragiorgis | .. times the prerequisites cannot be satisfied due to the underlying |
75 | 20c0dfdc | Dimitris Aragiorgis | .. infrastructure complexity (especially as far as networks is conserned). |
76 | 6928da52 | Dimitris Aragiorgis | |
77 | 301294a9 | Constantinos Venetsanopoulos | The quick installation guide describes how to install the whole Synnefo stack |
78 | 7a3439cf | Constantinos Venetsanopoulos | in just two physical nodes, for testing purposes. This guide is useful to those |
79 | 301294a9 | Constantinos Venetsanopoulos | interested in deploying Synnefo in large scale, as a starting point that will |
80 | 301294a9 | Constantinos Venetsanopoulos | help them get familiar with the Synnefo components and overall architecture, as |
81 | 7a3439cf | Constantinos Venetsanopoulos | well as the interconnection between different services. Such an installation, |
82 | 301294a9 | Constantinos Venetsanopoulos | also provides a quick preview of the basic Synnefo features, although we would |
83 | 301294a9 | Constantinos Venetsanopoulos | like to think that Synnefo's real power unveils while scaling. |
84 | 7a3439cf | Constantinos Venetsanopoulos | |
85 | 7a3439cf | Constantinos Venetsanopoulos | The Administrator's Guide targets system administrators, who want to dive into |
86 | 301294a9 | Constantinos Venetsanopoulos | more details and common tasks regarding Synnefo. For the experienced Synnefo |
87 | 301294a9 | Constantinos Venetsanopoulos | administrator, there is also a section that describes how to deploy Synnefo in |
88 | 301294a9 | Constantinos Venetsanopoulos | large scale with a corresponding guide. |
89 | 7a3439cf | Constantinos Venetsanopoulos | |
90 | 301294a9 | Constantinos Venetsanopoulos | The Developer's Guide targets developers, who want to build on top of Synnefo |
91 | 301294a9 | Constantinos Venetsanopoulos | and so describes all the different types of interfaces Synnefo provides to the |
92 | 301294a9 | Constantinos Venetsanopoulos | external world. The Integrator's Guide targets developers, who want to actually |
93 | 301294a9 | Constantinos Venetsanopoulos | extend/modify/change Synnefo itself, so describes Synnefo's indepth |
94 | 301294a9 | Constantinos Venetsanopoulos | architecture and the internals of Synnefo components (currently out-of-date!). |
95 | 6928da52 | Dimitris Aragiorgis | |
96 | 77180645 | Dimitris Aragiorgis | |
97 | 77180645 | Dimitris Aragiorgis | .. toctree:: |
98 | 7a3439cf | Constantinos Venetsanopoulos | :maxdepth: 1 |
99 | 7a3439cf | Constantinos Venetsanopoulos | |
100 | 090e5bfa | Dimitris Aragiorgis | Quick Installation Guide (on two nodes) <quick-install-admin-guide> |
101 | d0e436db | Constantinos Venetsanopoulos | |
102 | bc055d09 | Constantinos Venetsanopoulos | .. toctree:: |
103 | bc055d09 | Constantinos Venetsanopoulos | :maxdepth: 2 |
104 | bdb83fd6 | cven | |
105 | bc055d09 | Constantinos Venetsanopoulos | Administrator's Guide <admin-guide> |
106 | bc055d09 | Constantinos Venetsanopoulos | Developer's Guide <dev-guide> |
107 | bc055d09 | Constantinos Venetsanopoulos | Integrator's Guide <intgrt-guide> |
108 | d0e436db | Constantinos Venetsanopoulos | |
109 | d0e436db | Constantinos Venetsanopoulos | |
110 | 44c34efd | Constantinos Venetsanopoulos | List of all Synnefo components |
111 | 44c34efd | Constantinos Venetsanopoulos | ============================== |
112 | 44c34efd | Constantinos Venetsanopoulos | |
113 | 44c34efd | Constantinos Venetsanopoulos | They are also available from our apt repository: ``apt.okeanos.grnet.gr`` |
114 | 44c34efd | Constantinos Venetsanopoulos | |
115 | bb440e17 | Kostas Papadimitriou | * `snf-common <http://docs.dev.grnet.gr/snf-common/latest/index.html>`_ |
116 | bb440e17 | Kostas Papadimitriou | * `snf-webproject <http://docs.dev.grnet.gr/snf-webproject/latest/index.html>`_ |
117 | bb440e17 | Kostas Papadimitriou | * `snf-astakos-app <http://docs.dev.grnet.gr/astakos/latest/index.html>`_ |
118 | bb440e17 | Kostas Papadimitriou | * `snf-pithos-backend <http://docs.dev.grnet.gr/pithos/latest/backends.html>`_ |
119 | bb440e17 | Kostas Papadimitriou | * `snf-pithos-app <http://docs.dev.grnet.gr/pithos/latest/index.html>`_ |
120 | bb440e17 | Kostas Papadimitriou | * `snf-pithos-webclient <http://docs.dev.grnet.gr/pithos-webclient/latest/index.html>`_ |
121 | bb440e17 | Kostas Papadimitriou | * `snf-cyclades-app <http://docs.dev.grnet.gr/snf-cyclades-app/latest/index.html>`_ |
122 | bb440e17 | Kostas Papadimitriou | * `snf-cyclades-gtools <http://docs.dev.grnet.gr/snf-cyclades-gtools/latest/index.html>`_ |
123 | bb440e17 | Kostas Papadimitriou | * `snf-vncauthproxy <https://code.grnet.gr/projects/vncauthproxy>`_ |
124 | bb440e17 | Kostas Papadimitriou | * `snf-image <https://code.grnet.gr/projects/snf-image/wiki/>`_ |
125 | 73c2ce37 | Constantinos Venetsanopoulos | * `snf-image-creator <http://docs.dev.grnet.gr/snf-image-creator/latest/index.html>`_ |
126 | bb440e17 | Kostas Papadimitriou | * `snf-occi <http://docs.dev.grnet.gr/snf-occi/latest/index.html>`_ |
127 | bb440e17 | Kostas Papadimitriou | * `snf-cloudcms <http://docs.dev.grnet.gr/snf-cloudcms/latest/index.html>`_ |
128 | bb440e17 | Kostas Papadimitriou | * `nfdhcpd <https://code.grnet.gr/projects/nfdhcpd>`_ |
129 | 44c34efd | Constantinos Venetsanopoulos | |
130 | 44c34efd | Constantinos Venetsanopoulos | |
131 | d0e436db | Constantinos Venetsanopoulos | Contact |
132 | bc055d09 | Constantinos Venetsanopoulos | ======= |
133 | d0e436db | Constantinos Venetsanopoulos | |
134 | eab73849 | Constantinos Venetsanopoulos | You can contact the Synnefo team at the following mailing lists: |
135 | 9940eacf | Kostas Papadimitriou | |
136 | eab73849 | Constantinos Venetsanopoulos | * Users list: synnefo@googlegroups.com |
137 | eab73849 | Constantinos Venetsanopoulos | * Developers list: synnefo-devel@googlegroups.com |
138 | bc055d09 | Constantinos Venetsanopoulos | |
139 | 301294a9 | Constantinos Venetsanopoulos | The official site is: |
140 | 301294a9 | Constantinos Venetsanopoulos | |
141 | 301294a9 | Constantinos Venetsanopoulos | `http://www.synnefo.org <http://www.synnefo.org>`_ |
142 | 301294a9 | Constantinos Venetsanopoulos | |
143 | 9940eacf | Kostas Papadimitriou | Indices and tables |
144 | bc055d09 | Constantinos Venetsanopoulos | ================== |
145 | 9940eacf | Kostas Papadimitriou | |
146 | 9940eacf | Kostas Papadimitriou | |
147 | 9940eacf | Kostas Papadimitriou | * :ref:`genindex` |
148 | 9940eacf | Kostas Papadimitriou | * :ref:`modindex` |
149 | 9940eacf | Kostas Papadimitriou | * :ref:`search` |