Genocloud

Easy access

config_logo

Introduction

GenoCloud is a cloud computing platform. It is based on OpenNebula.

It provides compute and storage resources on-demand.

We do not compete against Amazon, RackSpace etc…, we provide free resources for academic research and experiments and not a system for production usage.

We target researchers needing resources to learn cloud computing, test a multi-server communication system or validate a model before moving to a commercial solution for example.

What you should know

Virtual machines are not persistent by default. This means that when a VM is shutdown, all disk is deleted. It is however possible to save a disk as a new image for later use.

Some quotas limit your usage of the cloud. If you reach those limits, you can ask for higher quotas.

First steps

After your account creation, you will receive credentials to connect to the web administration interface. You will also have a SSH public and private key that will be used to connect to the servers.

SSH access

Once the image instance is running and you have its IP address, you can connect to the server.

#ssh -A genocloud.genouest.org
#ssh root@myvmip

Once logged in, you are root on the server

If your SSH key is in your GenOuest home directory (id_rsa), then key will be automatically loaded. If this is not the case, you should load it with the ssh-add command. If you are using Putty to connect to genocloud, you can also add you SSH private key in the configuration.

IF you use your own image, and not a predefined one, the SSH key will not be preloaded on the server for authentication. You must use in this case the login/password you defined in your image.

HTTP proxy

An http proxy to the port 80 of your VM is automatically set. You can access your VM at URL http://cloud-mylastip.genouest.org/…, with mylastip the last digits of the VM IP address.

To access via http another port, you should add an internal proxy to your web server or ask for a public IP address (limited number).

Shared directory

A persistent shared directory is available on predefined images. It is available at location /omaha-beach/

After VM deletion, data are kept. However, there is no data backup.

EC2 interface

The EC2 credentials are the same than your genocloud credentials.

You can use common APIs in different languages to manage your cloud via EC2.

To know the AMI value, you can list the available images in the genocloud web interface. The AMI number is ami-000000 + image ID

Remote desktop access

If the image has a desktop (gnome, KDE, …) installed, it is possible to add a remote access.

To do so, one need to install x2go on the image and on the computer needing access. Instructions are available on x2go web site

Once installed, run x2goclient on your computer and configure it to use a SSH proxy using genokvm4.genouest.org as a proxy.

In case of error related to a host key, simply delete ~/.ssh/known_hosts file from your account.

S3 storage

To test S3, you will need an additional account. To get one, just send an email to the support.

We provide small storage capacities on S3, it should be used for test purposes only. S3 is provided by Eucalyptus Walrus component.

S3 web interface is accessible at https://genocloud.genouest.org:8443/#login

Messaging

A messaging tool, RabbitMQ, is also available. If requires a specific account, to get one, just send an email to the support.

RabbitMQ is an efficient message broker than can be used for your VMs communication.

XGrid and predefined clusters deployments

XGrid is an internal tool developed to ease the deployment of tools in the cloud.

It is used to setup Hadoop, SGE or manband workflows environments and can be extended with plugins to get more.

the XGrid web interface is accessible at http://cloud-mylastip.genouest.org//xgrid/admin

To connect to the interface, you must login with the admin login and a unique VM password. This password can be found in the VM in file /usr/share/xgrid/web/xgridconfig.rb (@@adminpwd)

The EC2 credentials, needed for the setup, are the same than your genocloud credentials.

Specific menus are available according to the selected image.

Main dashboard will provide a view of the VM launched from the interface with their CPU and RAM consumption as well as actions to delete them.

Each dashboard will have its own forms, but basically you will have to

  • select an AMI (take care to select the correct image, it will usually be the same as the image used to launch the current VM).
  • select the number of VM to launch
  • select the type of VM (master, slave, …)

New VMs will appear in GenoCloud dashboard too, and will be auto-configured.

Deploy XGrid cluster via command-line

It is possible to start a cluster (1 master + N nodes) via command-line.

To do so, connect to genocloud.genouest.org via SSH.

To get the list of available images (select the « debian-virtio »)

xgrid-launcher.rb  -m 192.168.2.91 -a MY_CLOUD_LOGIN -p MY_CLOUD_PASSWORD --list

To start a cluster:

xgrid-launcher.rb -m 192.168.2.91 -a MY_CLOUD_LOGIN -p MY_CLOUD_PASSWORD -x -i ami-00000092 -q 2  -t hadoop
  • ami-00000092 should be replaced by the selected image id from the –list command.
  • -q : number of nodes
  • -t : hadoop or sge
  • -g (optional): password to set for the xgrid web admin interface, if none, one will be generated automatically