root / docs / quick-install-guide.rst @ 2ca07643
History | View | Annotate | Download (3.1 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 unstable/ |
37 |
|
38 |
Then run: |
39 |
|
40 |
.. code-block:: console |
41 |
|
42 |
# apt-get update |
43 |
# apt-get install snf-deploy |
44 |
|
45 |
Synnefo installation |
46 |
==================== |
47 |
|
48 |
Now that you have `snf-deploy` successfully installed on your system, to install |
49 |
the whole Synnefo stack run: |
50 |
|
51 |
.. code-block:: console |
52 |
|
53 |
# snf-deploy all --autoconf |
54 |
|
55 |
This might take a while depending on the physical host you are running on, since |
56 |
it will download everything that is necessary, install and configure the whole |
57 |
stack. |
58 |
|
59 |
If the following ends without errors, you have successfully installed Synnefo. |
60 |
|
61 |
Accessing the Synnefo installation |
62 |
================================== |
63 |
|
64 |
Remote access |
65 |
------------- |
66 |
|
67 |
If you want to access the Synnefo installation from a remote machine, please |
68 |
first set your nameservers accordingly by adding the following line as your |
69 |
first nameserver in ``/etc/resolv.conf``: |
70 |
|
71 |
.. code-block:: console |
72 |
|
73 |
nameserver <IP> |
74 |
|
75 |
The <IP> is the public IP of the machine that you deployed Synnefo on, and want |
76 |
to access. |
77 |
|
78 |
Then open a browser and point to: |
79 |
|
80 |
`https://accounts.synnefo.live/im/` |
81 |
|
82 |
Local access |
83 |
------------ |
84 |
|
85 |
If you want to access the installation from the same machine it runs on, just |
86 |
open a browser and point to: |
87 |
|
88 |
`https://accounts.synnefo.live/im/` |
89 |
|
90 |
The <domain> is automatically set to ``synnefo.live``. A local BIND is already |
91 |
set up by `snf-deploy` to serve all FQDNs. |
92 |
|
93 |
Login |
94 |
----- |
95 |
|
96 |
Once you see the Login screen, go ahead and login using: |
97 |
|
98 |
| username: user@synnefo.org |
99 |
| password: 12345 |
100 |
|
101 |
which is the default user. If you see the welcome screen, you have successfully |
102 |
installed Synnefo on a single node. |
103 |
|
104 |
|
105 |
Caveats |
106 |
======= |
107 |
|
108 |
To be able to view all web pages make sure you have accepted all certificates |
109 |
for domains: |
110 |
|
111 |
* synnefo.live |
112 |
* accounts.synnefo.live |
113 |
* cyclades.synnefo.live |
114 |
* pithos.synnefo.live |
115 |
* cms.synnefo.live |
116 |
|
117 |
|
118 |
Using the installation |
119 |
====================== |
120 |
|
121 |
You should be able to: |
122 |
|
123 |
* Spawn VMs from the one public Image that is already registered |
124 |
* Upload files on Pithos |
125 |
* Create Private Networks |
126 |
* Connect VMs to Private Networks |
127 |
* Upload new Images |
128 |
* Register the new Images |
129 |
* Spawn VMs from your new Images |
130 |
* Use the kamaki command line client to access the REST APIs |