hu.mta.sztaki.lpds.cloud.simulator.iaas
Interface VMManager<E,F>

Type Parameters:

E - The type of the system that will manage the VMs.

F - The kind of the managed capacities behind the VMManager.

All Known Implementing Classes:

IaaSService, PhysicalMachine

public interface VMManager<E,F>

This interface intends to provide a generic overview of the VM management functionalities in a system.

Author:

Gabor Kecskemeti, Distributed and Parallel Systems Group, University of Innsbruck (c) 2013

Nested Class Summary

static interface	VMManager.CapacityChangeEvent<F>
static class	VMManager.NoSuchVMException Receiving this kind of exception shows that the system does not recognize the VM it should operate on.
static class	VMManager.VMManagementException This is a generic class to represent all kinds of problems that could occur while managing VMs on the system.

Method Summary

ResourceConstraints	getCapacities()
Collection<VirtualMachine>	listVMs() Provides an overview on the VMs currently in the system
void	migrateVM(VirtualMachine vm, E target) Migrates a VM from the current system to another.
void	reallocateResources(VirtualMachine vm, ResourceConstraints newresources) Allows fine-grained resource utilization setup of the particular VM after it was allocated on the system.
VirtualMachine[]	requestVM(VirtualAppliance va, ResourceConstraints rc, Repository vaSource, int count, HashMap<String,Object> schedulingConstraints) Creates a new VM in the system and immediately returns with a new VM object.
void	subscribeToCapacityChanges(VMManager.CapacityChangeEvent<F> e)
void	terminateVM(VirtualMachine vm, boolean killTasks) Terminates a VM in the system.
void	unsubscribeFromCapacityChanges(VMManager.CapacityChangeEvent<F> e)

Method Detail

requestVM

VirtualMachine[] requestVM(VirtualAppliance va,
                           ResourceConstraints rc,
                           Repository vaSource,
                           int count,
                           HashMap<String,Object> schedulingConstraints)
                           throws VMManager.VMManagementException,
                                  NetworkNode.NetworkException

Creates a new VM in the system and immediately returns with a new VM object. The user have to check if the VM is actually running through the VM object. Implementors should ensure that the particular VA is accessible for the system before the VM gets started.

Parameters:

va - the kind of VM to be created

Returns:

the new VM

Throws:

VMManager.VMManagementException - if the request cannot be fulfilled for some reason

NetworkNode.NetworkException

terminateVM

void terminateVM(VirtualMachine vm,
                 boolean killTasks)
                 throws VMManager.NoSuchVMException,
                        VMManager.VMManagementException

Terminates a VM in the system. Ensures that it is not running after the request completes anymore.

Parameters:

vm - the VM to be terminated

Throws:

VMManager.NoSuchVMException - if the request was issued for a VM unknown in the system

VMManager.VMManagementException - if the request cannot be fulfilled for some reason

migrateVM

void migrateVM(VirtualMachine vm,
               E target)
               throws VMManager.NoSuchVMException,
                      VMManager.VMManagementException,
                      NetworkNode.NetworkException

Migrates a VM from the current system to another. The VM is not going to be running during this period. It will not consume resources on the current system anymore

Parameters:

vm - the VM to be relocated

target - the target system that should host the VM in the future

Throws:

VMManager.NoSuchVMException - if the request was issued for a VM unknown in the system

VMManager.VMManagementException - if the request cannot be fulfilled for some reason

NetworkNode.NetworkException

reallocateResources

void reallocateResources(VirtualMachine vm,
                         ResourceConstraints newresources)
                         throws VMManager.NoSuchVMException,
                                VMManager.VMManagementException

Allows fine-grained resource utilization setup of the particular VM after it was allocated on the system. Even during its runtime. Don't forget that in real VMs resource availability changes might cause troubles. Apply it rarely if you are not sure it will also work in the real world!

Parameters:

vm - The VM to be adjusted

newresources - The new amount of resources needed (this could not only raise the available resources of the VM but also decrease them

Throws:

VMManager.NoSuchVMException - if the request was issued for a VM unknown in the system

VMManager.VMManagementException - if the request cannot be fulfilled for some reason

listVMs

Collection<VirtualMachine> listVMs()

Provides an overview on the VMs currently in the system

Returns:

the VMs currently registered with the system (they are either alredy running or will run in the foreseeable future

getCapacities

ResourceConstraints getCapacities()

subscribeToCapacityChanges

void subscribeToCapacityChanges(VMManager.CapacityChangeEvent<F> e)

unsubscribeFromCapacityChanges

void unsubscribeFromCapacityChanges(VMManager.CapacityChangeEvent<F> e)