This documentation is obsolete: please head here for an up-to-date documentation

Introduction

Genostack is a cloud computing platform based on OpenStack. It provides computing and storage resources on-demand.

Accessing Genostack

Genostack

Main

Configure your SSH key

Configure your SSH key

Launch a new instance

To launch a new instance (and monitor existing one), simply head to the “Instances” tab.

Then, click on “Launch instance”. The pop-up will then allow you to customize your instance.

Some parameters (marked by *) are required to launch a new instance.

a) Details

The “Details” tab will allow you to select the instance name, and the number of instances you want to launch. You can also see how many you can launch in regard to your quotas.

b) Source

In this tab, you can select the source of the instance you wish to use. You can select two types of source : Images or Volumes.

Both types can be subdivised in “normal” and “snapshot”. “Snapshot” refers to your images, saved in a snapshot format for preservation.

When booting from an Image, you can choose to create a volume. The instance will then be booted on the volume (Future snapshots will be volumes type).

Difference between source type

The volume size must be bigger than the Image RAW size (usually 20 Go)

c) Flavors

Flavors are the “size” of the instance, in terms of memory, cores and disk space. (If you boot from a volume, the disk space will be the size of your volume, no matter the flavor you choose). The minimal disk size that you can use is dependent of the source (usually 20 Go).

d) Network

Only one network is available. Please select the “provider” network.

e) Security group

The “Default” security group will be selected if there are no other. If you wish to use your own security group, please select it here.

f) Key pair

You can select the ssh key pair you wish to be injected in the instance there. Without it, you will not be able to access your instance

g) Configuration

You can inject a personalized script in the instance which will be executed after boot. The data will be inject either via an API call or a configuration file, depending on the user choice.

Others:

The “Network ports” and “Metadata” tabs are unnecessary to launch an instance.


You can then launch your instance by using the “Launch instance” button. When its read, you will be able to see the IP allocated.

Frontend connection

First, you must log on the machine “openstack.genouest.org“ with SSH to access on your VM.

ssh mygenouestlogin@openstack.genouest.org

On this machine, you can access to your GenOuest home directory.

Connecting to your machine

You can connect to your machine from the frontend with this command

ssh root@your_ip

You can find your_ip in the Genostack dashboard, in the instance tab.

You can also copy your genocluster files on the VM using this command:

scp myfile root@your_ip

Virtual Machine access (HTTP/S)

Default access (port 80)

By default, you can access to your VM (port 80) from your web browser via this URL :

http://openstack-your-ip.genouest.org

You will need to replace all “.” in the ip by “-“ (With the exception of the .genouest.org)

Example: http://openstack-192-168-100-66.genouest.org

You can also access your instance in HTTPS

Example: https://openstack-192-168-100-66.genouest.org

Please note that the HTTPS will still be redirected to the port 80 of the instance

It is also possible to have different names for the same VM:

Example:

Both URLs will be forwarded to the same virtual machine, but prefix (jupyter and myapp in example, but any name can be used) can help you to do your own proxying in your VMs. Using this URLs scheming name also automatically support websockets.

Custom access (ports & websocket)

You can now customize the web proxy for your instance. More details here.

Add user (optional)

Once you are logged into your VM, you can add a new user / password (SSH key will be not required anymore)

adduser my_new_user

Change the root password (optional)

Once you’re logged into your VM, you can change the root password (SSH key will be not required anymore)

passwd root

Instance creation example