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