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