Commit 14ed06a0 authored by Constantinos Venetsanopoulos's avatar Constantinos Venetsanopoulos
Browse files

Quick install guide: update and link to index page

parent da2224e5
......@@ -65,23 +65,23 @@ Synnefo running with two different storage backends.
Synnefo Guides
==============
There are 3 guides for Synnefo.
.. For the really impatient snf-deploy tool allows you to install all software
.. components from scratch (creating locally kvm based Virtual Machines) or to an
.. existing cluster (in the same network subnet and domain, same network
.. configuration, vanilla debian squeeze and installed ssh keys). Please note that
.. this should be used only for testing or demo installations because most of the
.. times the prerequisites cannot be satisfied due to the underlying
.. infrastructure complexity (especially as far as networks is concerned).
The admin's installation guide describes how to install the whole Synnefo stack
in just two physical nodes, for testing purposes. This guide is useful to those
interested in deploying Synnefo in large scale, as a starting point that will
help them get familiar with the Synnefo components and overall architecture, as
well as the interconnection between different services. Such an installation,
also provides a quick preview of the basic Synnefo features, although we like to
think that Synnefo's real power unveils while scaling.
There are 4 guides for Synnefo.
The Quick Installation guide describes how to install Synnefo on a single node
in less than 10 minutes using the `snf-deploy` tool. This kind of installation
is targeted for testing and demo environments rather than production usage
deployments. It is the perfect way, even for an inexperienced user to have the
whole Synnefo stack up and running and allows for a quick preview of the basic
Synnefo features.
The Admin's installation guide describes how to install the whole Synnefo stack
in just two physical nodes. This guide is useful to those interested in
deploying Synnefo in large scale, as a starting point that will help them get
familiar with the Synnefo components and overall architecture, as well as the
interconnection between different services. This guide explains the whole
procedure step by step, without the use of the `snf-deploy` tool. Anyone
familiar with this guide, will be able to easily install Synnefo in a larger
number of nodes too, or even expand the two node installation dynamically.
The Administrator's Guide targets system administrators, who want to dive into
more details and common tasks regarding Synnefo. For the experienced Synnefo
......@@ -101,6 +101,7 @@ external world. Also documents all Synnefo external REST APIs.
.. toctree::
:maxdepth: 1
Quick Installation Guide (single node) <quick-install-guide>
Installation Guide (on two nodes) <quick-install-admin-guide>
.. toctree::
......
......@@ -29,7 +29,7 @@ Installation of snf-deploy
==========================
First of all we need to install the snf-deploy tool. To do so please add the
following line in your ``sources.list`` file:
following line in your ``/etc/apt/sources.list`` file:
.. code-block:: console
......@@ -61,14 +61,8 @@ If the following ends without errors, you have successfully installed Synnefo.
Accessing the Synnefo installation
==================================
If you want to access the installation from the same machine it runs on, just
open a browser and point to:
`https://accounts.<domain>/im/`
The <domain> is automatically set to ``hostname -d``. If this doesn't return
anything, it is set to ``synnefo.deploy.local``. A local BIND is already set up
by `snf-deploy` to serve all FQDNs.
Remote access
-------------
If you want to access the Synnefo installation from a remote machine, please
first set your nameservers accordingly by adding the following line as your
......@@ -81,10 +75,28 @@ first nameserver in ``/etc/resolv.conf``:
The <IP> is the public IP of the machine that you deployed Synnefo on, and want
to access.
Then open a browser and point to:
`https://accounts.synnefo.live/im/`
Local access
------------
If you want to access the installation from the same machine it runs on, just
open a browser and point to:
`https://accounts.synnefo.live/im/`
The <domain> is automatically set to ``synnefo.live``. A local BIND is already
set up by `snf-deploy` to serve all FQDNs.
Login
-----
Once you see the Login screen, go ahead and login using:
| username: dimara@grnet.gr
| password: lala
| username: user@synnefo.org
| password: 12345
which is the default user. If you see the welcome screen, you have successfully
installed Synnefo on a single node.
......@@ -96,11 +108,11 @@ Caveats
To be able to view all web pages make sure you have accepted all certificates
for domains:
* synnefo.deploy.local
* accounts.synnefo.deploy.local
* cyclades.synnefo.deploy.local
* pithos.synnefo.deploy.local
* cms.synnefo.deploy.local
* synnefo.live
* accounts.synnefo.live
* cyclades.synnefo.live
* pithos.synnefo.live
* cms.synnefo.live
Using the installation
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment