Statistics
| Branch: | Tag: | Revision:

root / docs / quick-install-guide.rst @ 54f8466b

History | View | Annotate | Download (3.2 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
To be able to view all web pages make sure you have accepted all certificates
110
for domains:
111

    
112
* synnefo.live
113
* accounts.synnefo.live
114
* cyclades.synnefo.live
115
* pithos.synnefo.live
116
* cms.synnefo.live
117

    
118

    
119
Using the installation
120
======================
121

    
122
You should be able to:
123

    
124
* Spawn VMs from the one public Image that is already registered
125
* Upload files on Pithos
126
* Create Private Networks
127
* Connect VMs to Private Networks
128
* Upload new Images
129
* Register the new Images
130
* Spawn VMs from your new Images
131
* Use the kamaki command line client to access the REST APIs