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