root / docs / quick-install-guide.rst @ b900c826
History | View | Annotate | Download (3.5 kB)
1 |
.. _quick-install-guide: |
---|---|
2 |
|
3 |
Quick Installation Guide |
4 |
^^^^^^^^^^^^^^^^^^^^^^^^ |
5 |
|
6 |
This is the Synnefo Quick Installation guide. |
7 |
|
8 |
It describes how to install the whole Synnefo stack on one (1) physical node, |
9 |
in less than 10 minutes. The installation uses the snf-deploy deployment tool |
10 |
and installs on a physical node that runs Debian Squeeze. After successful |
11 |
installation, you will have the following services running: |
12 |
|
13 |
* Identity Management (Astakos) |
14 |
* Object Storage Service (Pithos) |
15 |
* Compute Service (Cyclades) |
16 |
* Image Service (part of Cyclades) |
17 |
* Network Service (part of Cyclades) |
18 |
|
19 |
and a single unified Web UI to manage them all. |
20 |
|
21 |
|
22 |
Prerequisites |
23 |
============= |
24 |
|
25 |
To install Synnefo the only thing you need is a Debian Squeeze Base System that |
26 |
has access to the public Internet. |
27 |
|
28 |
Installation of snf-deploy |
29 |
========================== |
30 |
|
31 |
First of all we need to install the snf-deploy tool. To do so please add the |
32 |
following line in your ``/etc/apt/sources.list`` file: |
33 |
|
34 |
.. code-block:: console |
35 |
|
36 |
deb http://apt.dev.grnet.gr stable/ |
37 |
|
38 |
Then run: |
39 |
|
40 |
.. code-block:: console |
41 |
|
42 |
# curl https://dev.grnet.gr/files/apt-grnetdev.pub | apt-key add - |
43 |
# apt-get update |
44 |
# apt-get install snf-deploy |
45 |
|
46 |
Synnefo installation |
47 |
==================== |
48 |
|
49 |
Now that you have `snf-deploy` successfully installed on your system, to install |
50 |
the whole Synnefo stack run: |
51 |
|
52 |
.. code-block:: console |
53 |
|
54 |
# snf-deploy all --autoconf |
55 |
|
56 |
This might take a while depending on the physical host you are running on, since |
57 |
it will download everything that is necessary, install and configure the whole |
58 |
stack. |
59 |
|
60 |
If the following ends without errors, you have successfully installed Synnefo. |
61 |
|
62 |
Accessing the Synnefo installation |
63 |
================================== |
64 |
|
65 |
Remote access |
66 |
------------- |
67 |
|
68 |
If you want to access the Synnefo installation from a remote machine, please |
69 |
first set your nameservers accordingly by adding the following line as your |
70 |
first nameserver in ``/etc/resolv.conf``: |
71 |
|
72 |
.. code-block:: console |
73 |
|
74 |
nameserver <IP> |
75 |
|
76 |
The <IP> is the public IP of the machine that you deployed Synnefo on, and want |
77 |
to access. |
78 |
|
79 |
Then open a browser and point to: |
80 |
|
81 |
`https://accounts.synnefo.live/im/` |
82 |
|
83 |
Local access |
84 |
------------ |
85 |
|
86 |
If you want to access the installation from the same machine it runs on, just |
87 |
open a browser and point to: |
88 |
|
89 |
`https://accounts.synnefo.live/im/` |
90 |
|
91 |
The <domain> is automatically set to ``synnefo.live``. A local BIND is already |
92 |
set up by `snf-deploy` to serve all FQDNs. |
93 |
|
94 |
Login |
95 |
----- |
96 |
|
97 |
Once you see the Login screen, go ahead and login using: |
98 |
|
99 |
| username: user@synnefo.org |
100 |
| password: 12345 |
101 |
|
102 |
which is the default user. If you see the welcome screen, you have successfully |
103 |
installed Synnefo on a single node. |
104 |
|
105 |
|
106 |
Caveats |
107 |
======= |
108 |
|
109 |
Certificates |
110 |
------------ |
111 |
To be able to view all web pages make sure you have accepted all certificates |
112 |
for domains: |
113 |
|
114 |
* synnefo.live |
115 |
* accounts.synnefo.live |
116 |
* cyclades.synnefo.live |
117 |
* pithos.synnefo.live |
118 |
* cms.synnefo.live |
119 |
|
120 |
|
121 |
Spawning VMs |
122 |
------------ |
123 |
By default, snf-deploy can't spawn VMs. To be able to do so, edit |
124 |
``/etc/synnefo/cyclades.conf`` and change line 29 from: |
125 |
|
126 |
.. code-block:: console |
127 |
|
128 |
'no_install': True, |
129 |
|
130 |
to: |
131 |
|
132 |
.. code-block:: console |
133 |
|
134 |
'no_install': False, |
135 |
|
136 |
|
137 |
Using the installation |
138 |
====================== |
139 |
|
140 |
You should be able to: |
141 |
|
142 |
* Spawn VMs from the one public Image that is already registered |
143 |
* Upload files on Pithos |
144 |
* Create Private Networks |
145 |
* Connect VMs to Private Networks |
146 |
* Upload new Images |
147 |
* Register the new Images |
148 |
* Spawn VMs from your new Images |
149 |
* Use the kamaki command line client to access the REST APIs |