Personal tools
User Guide 1.3.x

From FOSS-Cloud

Master Index  |  Administration

This is the User Guide for the FOSS-Cloud 1.3.x

If you have installed a Demo-System continue with Installing Guest Operating System

User Administration


The user administation There are tree types of Users


Adding Networks

  1. Open Network
  2. Create a network if none is there
Network View

Example network

  • IP start address
  • Net Mask 24
  • Name network-pool-01
  • Domain Name "test.foss-group.org"
  • Domain Server(s)
  • Default Gateway
  • Broadcast Address
  • NTP Servers 0.ch.pool.ntp.org,1.ch.pool.ntp.org,etc.

Edit/Create Network

Adding Subnets

For each type of virtual machines you have to enter one range.

  1. Open Network
  2. Choose Subnets
  3. Click on the very right button for a network to add a range

Example first range

  • IP Start Address
  • Net Mask 28
  • Name "It is your choice"
  • Choose one of the three, for example template

Example second range

  • IP Start Address
  • Net Mask 28
  • Name "It is your choice"
  • Choose one of the three, for example static

Example third range

  • IP Start Address
  • Net Mask 28
  • Name "It is your choice"
  • Choose one of the three, for example dynamic

Edit/Create Network Range

Storage Pools

The storage pool defines, where the images are stored in the file system.

Storage Pool View

Adding Storage Pools

  1. Open Storage Pools
  2. Choose "Create" to make an new

You need to define the storage type and enter a descriptive name for the intended use of the pool.

View create storage pool

Edit Storage Pools

  1. Open Storage Pools
  2. Choose Storage Pools
  3. Click on the left button in the last row or click on the name of the storage pool. You can only edit name and description.
View edit storage pool

Delete Storage Pools

The very last button in the last row is to delete a storage pool. Be aware, only a storage pool who is not assigned to a vm-pool can be deleted. Therefore the button is deactivated.

Storage Pool View

Technical Note

The main path of storage is /var/virtualization/. There you can mount your storage system as example NAS, SAN or the storage nodes provided through FOSS-Cloud.

Predefined, VMs are stored as follow:

template = /var/virtualization/vm-template
dynamic = /var/virtualization/vm-dynamic
persistent/static = /var/virtualization/vm-persistent

Under /var/virtualization you can also mount different storage systems. So you are able to mount fast but expensive storage, or slow but cheeper storage.


The vm-Pool defines the specific environment of a defined usergroup. So the pool hold together storage pool, IP range and users. With a vm-Pool the runtime environment of the vm's is done.

VM Pool View

Create VM-Pools

  1. Open vm-Pools
  2. Choose create

Each vm-pool must have a network range and a vm-pool.

Example of vm-Pool

Create vm Pool

Edit a VM-Pool

  1. Open vm-Pools
  2. Choose vm-Pools
  3. Click on the very first button in the right row of the vm-pool you want to edit or click on the name of the vm-pool.

In the edit mode of the vm-pool you can change name and description and you can choose the network range.

If the pool is a dynamic vm-pool, you may also change the fields "minimal number of running VMs", "maximal number of running VMs" and "minimal number of free VMs". "Maximal number of running VMs" is active yet, the other two not. With the full functionality of the daemon the fields will be active.

Edit vm-Pool

Adding User and Groups

To add user and groups click on the two very right buttons in the row of your vm-Pool.In these pop ups you can add more then one user or groups to the vm-Pool.

Add User
Add Group

User Management

Assignment to VMs

The rights of users are administrated in the user management which contains user and group management. A user can be assigned to groups, vm-pools or direct to VMs. Groups can be assigned to vm-pools or direct to a VM. These assignments defines, which VMs a user can see.

User Role

The user role define, which functionality a user has on the VMs he can see, for example start, stop, edit, etc. Today there are 3 roles included in the FOSS-Cloud

  • VM-User
  • VM-Admin
  • Admin


The VM-User has just the right to see and access the VMs assigned to him.


The VM-Admin is a role between the Admin and the VM-User. He has the following rights:

  • In Assigned VMs he can see, start and connect to VMs assigned to him.
  • In Diagnostics he can see all VM's assigned to him.
  • In VM Pool he can see and edit all VM Pools assigned to him.
  • In Virtual Machine he can see, edit and manage VM's assigned to him.


The admin can see and connect to each VM and he has the right to do all.

Assign Role to User

You can assign a role to a user by creating or editing a user. A user can only have one role. Choose the role by clicking the appropriate radio button.

Go Top

Guest Operating System Installation

Upload ISO Files

For installing a guest operation system, a ISO must be uploaded


Creating a Profile

The profile creates the relationship between the ISO file and the FOSS-Cloud.

  1. Open Virtual Machines
  2. Choose vm-Profiles
  3. Choose the right Base Profile
  4. Choose the right architecture (Windows only x86_64)
  5. Chose the language (it is a information - not keyboard relevant)
  6. Choose the ISO file
  7. Fill out name and description
  8. Choose the amount of memory and volume capacity
  9. Choose amount of CPU
  10. Choose clock offset (normally Windows is "localtime" and Linux is "utc")
View Profile

Creating the profile will copy the ISO file in to the right place. Be patient!

Editing a Profile

You can change each value exept the name of the profiel


The template is for preparing the virtual machines for the use of either as a persistent or dynamic virtual machine.

View Template

Creating Template

  1. Choose the profile you have prepared before
  2. Add the vm-pool and one or more nodes, where you will run this vm (when the chosen vm-pool has only one node assigned, you don't have a choice)
  3. You can change all the other informations you have entered before

Click on "create" and the template is ready for installing the guest operating system.

View Creating

Edit Template

  1. Open Virtual Machines
  2. Choose vm-Template
  3. Click on the very first button in the right row of the template you want to edit or click on the name of the template.

You can change all information as follows:

  • Name
  • Description
  • IP Adress
  • Memory
  • Volume Capacity (only higher values are allowed)
  • CPU and Clock Offset

View edit Template

Installing the guest operating system

When the template is ready, you can start the installation with the green arrow. Afterwards you can click on the screen button on the right row to see the vm. This works only, when you have installed the spice client on your local machine.

In the guest operating system, you have to go through the installation process. After the installation do not make a reboot! You have to shut down the guest and then toogle the boot device to the harddisk. Otherwise the VM will restart the installation of the guest os, because he is booting again from CD.

Following some specialties of os:


Most Linux distributions should provide the so-called virtio-drivers on the installation CD. After the base installation you need to install the video driver, thats it.

Ubuntu and Debian

Ubuntu 10.10 or newer and Debian 6 (squeeze) or newer


During (or rather at the end) of the installation, when the /target is still mounted, change to a shell and take care of the Grub Problem

Video driver

Run the following command:

sudo aptitude install xserver-xorg-video-qxl

after the installation finished and Ubuntu is started.

Restart again.

Windows 7 and Windows Server 2008r2

Basic installation (Step 1)

If the profile and the template have been setup properly, FOSS-Cloud will automatically add a second virtual CD-Drive containing drivers for various editions and versions of Microsoft Windows.

Without these drivers, Windows will not recognize the harddisk, the network card or certain other virtual hardware.

During the installation of Windows, you will be presented an empty list of suitable drives to install Windows to. Below the list you have a button which gives you the option to select additional drivers for the storage hardware.

Click that button and browse the second CD drive. Look for a folder called Win7 and choose the subfolder according to the edition of Windows you're installing.

Afterwards you may or may not be asked, whether you want to trust the issuer ("RedHat Inc.") of this driver. Confirm that answer with yes.

After this step, you should see a storage device in the list. Choose it to continue the installation as you'd do with a Windows on real hardware.

Advanced driver installation (Step 2)

After Windows has started, you will have to install more drivers to get Internet connectivity and improved video output.

Open the device manager for this and right click on the Unknown network controller. Choose Update drivers, choose search on the computer and browse again the second CD drive and select the folder Win7\amd64 (Win7\x86 respectively).

You may again be presented a window asking for confirmation whether you want to trust the issuer ("RedHat Inc.") of this driver. Confirm again with yes.

Repeat the same procedure for any other unknown devices except for the "Unknown multimedia audio controller". For this you can choose the option to search online for a driver (may work only after registering Windows).

After a couple of seconds after the installation, Windows should pick-up an IP-adress from a DHCP-Server (provided by the FOSS-Cloud).

Unfortunately the graphics card driver is currently not provided on the CD image. Therefore you will have to download it from within the virtual machine.

Using the browser within the VM, go to http://www.spice-space.org/download.html, download the installer spice-guest-tools-X.X.exe and execute it.

On Windows 2008r2 the graphics drivers may not work because they are not digitally signed, but you still want to install the Spice Guest Tools to get clipboard sharing and auto-resizing of the Guest screen.


Black screen with Win7

If you access a Windows 7 virtual machine (VM), you occasionally get a black screen after a prolonged inactivity. You can avoid this by setting the options 'turn off screen' and 'save energie' to 'never'.

Shutdown and Restart Buttons

Remove Shutdown and Restart Buttons In Windows 7 http://www.howtogeek.com/howto/7553/remove-shutdown-and-restart-buttons-in-windows-7/

Persistent VM

A persistent VM can be a server or a workstation.

Create Persistent VM

To create a persistent vm you click on the button "VM Template => static VM". This will copy the template in to the persistent vms. Be patient, because this will copy the whole image >40 GB!

Adding User to VM

You can add user direct to the persistent vm or via vm-pool.

Adding user and groups to a persistent vm is similar to vm-pool

Dynamic VM

Create Dynamic VM

A dymamic VM is to serve a whole group of users with the same vm. The vm will be generated on the fly, when the user login or the vm will be prestarted.

View Dynamic VM

Caution: Be shure, the golden image is set active!

To create a dynamic vm you click on the button "VM Template => dynamic VM". This will copy the template in to the dynamic vms. Be patient, because this will copy the whole image >40 GB!

Migrate Dynamic VM


For special Dynamic VM's you have the posibility to go through the SysPrep. SysPrep is inactive in this version.

Edit Dynamic VM's

The edit of a dynamic VM is similar to editing a Template.

Adding User

When the dynamic vm is created, you have to add the user of this vm to the vm-pool of this dynamic vm.

To add user and groups see under vm-pool

Using the Dynamic VM

When this is done, you can logout an relogin with the user you have assigned. Only your assigned vms will be there. You can click on your screen symbol to start your dynamic virtual machine.


The integraton of Nodes is described in the Installation_Guide_1.2.x