root / docs / quick-install-guide.rst @ 454dca28
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 ``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 |
If you want to access the installation from the same machine it runs on, just |
65 |
open a browser and point to: |
66 |
|
67 |
`https://accounts.<domain>/im/` |
68 |
|
69 |
The <domain> is automatically set to ``hostname -d``. If this doesn't return |
70 |
anything, it is set to ``synnefo.deploy.local``. A local BIND is already set up |
71 |
by `snf-deploy` to serve all FQDNs. |
72 |
|
73 |
If you want to access the Synnefo installation from a remote machine, please |
74 |
first set your nameservers accordingly by adding the following line as your |
75 |
first nameserver in ``/etc/resolv.conf``: |
76 |
|
77 |
.. code-block:: console |
78 |
|
79 |
nameserver <IP> |
80 |
|
81 |
The <IP> is the public IP of the machine that you deployed Synnefo on, and want |
82 |
to access. |
83 |
|
84 |
Once you see the Login screen, go ahead and login using: |
85 |
|
86 |
| username: dimara@grnet.gr |
87 |
| password: lala |
88 |
|
89 |
which is the default user. If you see the welcome screen, you have successfully |
90 |
installed Synnefo on a single node. |
91 |
|
92 |
|
93 |
Caveats |
94 |
======= |
95 |
|
96 |
To be able to view all web pages make sure you have accepted all certificates |
97 |
for domains: |
98 |
|
99 |
* synnefo.deploy.local |
100 |
* accounts.synnefo.deploy.local |
101 |
* cyclades.synnefo.deploy.local |
102 |
* pithos.synnefo.deploy.local |
103 |
* cms.synnefo.deploy.local |
104 |
|
105 |
|
106 |
Using the installation |
107 |
====================== |
108 |
|
109 |
You should be able to: |
110 |
|
111 |
* Spawn VMs from the one public Image that is already registered |
112 |
* Upload files on Pithos |
113 |
* Create Private Networks |
114 |
* Connect VMs to Private Networks |
115 |
* Upload new Images |
116 |
* Register the new Images |
117 |
* Spawn VMs from your new Images |
118 |
* Use the kamaki command line client to access the REST APIs |