Quick Installation Guide on Debian Wheezy

This is the Synnefo Quick Installation guide.

It describes how to install the whole Synnefo stack on one (1) physical node, in less than 10 minutes. The installation uses the snf-deploy deployment tool and installs on a physical node that runs Debian Wheezy. After successful installation, you will have the following services running:

  • Identity Management (Astakos)
  • Object Storage Service (Pithos)
  • Compute Service (Cyclades)
  • Image Service (part of Cyclades)
  • Network Service (part of Cyclades)

and a single unified Web UI to manage them all.

Prerequisites

To install Synnefo the only thing you need is a Debian Wheezy Base System that has access to the public Internet.

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 /etc/apt/sources.list file:

deb http://apt.dev.grnet.gr wheezy/

Then run:

# curl https://dev.grnet.gr/files/apt-grnetdev.pub | apt-key add -
# apt-get update
# apt-get install snf-deploy

Synnefo configuration & installation

Configuration

Now that you have snf-deploy successfully installed on your system, you can continue with configuring and installing Synnefo. Configuration files for snf-deploy can be found in /etc/snf-deploy, the defaults should work out of the box for most setups. If for some reason you encounter any problems, you should check there for network conflicts, etc.

Installation

To install the whole Synnefo stack run:

# snf-deploy all --autoconf

This might take a while depending on the physical host you are running on, since it will download everything that is necessary, install and configure the whole stack.

If the following ends without errors, you have successfully installed Synnefo.

Accessing the Synnefo installation

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 first nameserver in /etc/resolv.conf:

nameserver <IP>

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://synnefo.live/

Local access

If you want to access the installation from the same machine it runs on, just open a browser and point to:

https://synnefo.live/

The default <domain> is 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:

password: 12345

which is the default user. If you see the welcome screen, you have successfully installed Synnefo on a single node.

Caveats

Certificates

To be able to view all web pages make sure you have accepted all certificates for domains:

  • synnefo.live
  • accounts.synnefo.live
  • cyclades.synnefo.live
  • pithos.synnefo.live
  • cms.synnefo.live

Using the installation

You should be able to:

  • Spawn VMs from the one public Image that is already registered
  • Upload files on Pithos
  • Create Private Networks
  • Connect VMs to Private Networks
  • Upload new Images
  • Register the new Images
  • Spawn VMs from your new Images
  • Use the kamaki command line client to access the REST APIs