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