org.cloudbus.cloudsim.datacenters

Interface Datacenter

All Superinterfaces:

Cloneable, Comparable<SimEntity>, Identificable, Nameable, Runnable, SimEntity

All Known Implementing Classes:

DatacenterSimple, NetworkDatacenter

public interface Datacenter
extends SimEntity

An interface to be implemented by each class that provides Datacenter features. The interface implements the Null Object Design Pattern in order to start avoiding NullPointerException when using the NULL object instead of attributing null to Datacenter variables.

Since:

CloudSim Plus 1.0

Author:

Rodrigo N. Calheiros, Anton Beloglazov, Manoel Campos da Silva Filho

Nested Class Summary

Nested classes/interfaces inherited from interface org.cloudbus.cloudsim.core.SimEntity

SimEntity.State

Field Summary

Fields

Modifier and Type	Field and Description
static double	DEF_BANDWIDTH_PERCENT_FOR_MIGRATION The default percentage of bandwidth allocated for VM migration, is a value is not set.
static Datacenter	NULL A property that implements the Null Object Design Pattern for Datacenter objects.

Method Summary

Modifier and Type	Method and Description
int	addFile(File file) Adds a file into the resource's storage before the experiment starts.
<T extends Host> Datacenter	addHost(T host) Physically expands the Datacenter by adding a new Host (physical machine) to it.
<T extends Host> Datacenter	addHostList(List<T> hostList) Physically expands the Datacenter by adding a List of new Hosts (physical machines) to it.
double	getBandwidthPercentForMigration() Gets the percentage of the bandwidth allocated to a Host to migrate VMs.
DatacenterCharacteristics	getCharacteristics() Gets the Datacenter characteristics.
Host	getHost(int index)
<T extends Host> List<T>	getHostList() Gets an unmodifiable host list.
double	getPower() Gets an estimation of Datacenter power consumption (in Watts/Second).
double	getPowerInKWattsHour() Gets an estimation the Datacenter power consumption (in Kilo Watts/Hour).
double	getSchedulingInterval() Gets the scheduling interval to process each event received by the Datacenter (in seconds).
List<FileStorage>	getStorageList() Gets a read-only list of storage devices of the Datacenter.
VmAllocationPolicy	getVmAllocationPolicy() Gets the policy to be used by the Datacenter to allocate VMs into hosts.
<T extends Vm> List<T>	getVmList() Gets a read-only list all VMs from all Hosts of this Datacenter.
void	setBandwidthPercentForMigration(double bandwidthPercentForMigration) Sets the percentage of the bandwidth allocated to a Host to migrate VMs.
Datacenter	setSchedulingInterval(double schedulingInterval) Sets the scheduling delay to process each event received by the Datacenter (in seconds).
Datacenter	setStorageList(List<FileStorage> storageList) Sets the list of storage devices of the Datacenter.

Methods inherited from interface org.cloudbus.cloudsim.core.SimEntity

getSimulation, isStarted, println, println, processEvent, run, schedule, setLog, setName, setSimulation, setState, shutdownEntity, start

Methods inherited from interface org.cloudbus.cloudsim.core.Nameable

getName

Methods inherited from interface org.cloudbus.cloudsim.core.Identificable

getId

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

NULL

static final Datacenter NULL

A property that implements the Null Object Design Pattern for Datacenter objects.

DEF_BANDWIDTH_PERCENT_FOR_MIGRATION

static final double DEF_BANDWIDTH_PERCENT_FOR_MIGRATION

The default percentage of bandwidth allocated for VM migration, is a value is not set.

See Also:

setBandwidthPercentForMigration(double), Constant Field Values

Method Detail

addFile

int addFile(File file)

Adds a file into the resource's storage before the experiment starts. If the file is a master file, then it will be registered to the RC when the experiment begins.

Parameters:

file - a DataCloud file

Returns:

a tag number denoting whether this operation is a success or not

getHostList

<T extends Host> List<T> getHostList()

Gets an unmodifiable host list.

Type Parameters:

T - The generic type

Returns:

the host list

getHost

Host getHost(int index)

addHostList

<T extends Host> Datacenter addHostList(List<T> hostList)

Physically expands the Datacenter by adding a List of new Hosts (physical machines) to it. Hosts can be added before or after the simulation has started. If a Host is added during simulation execution, in case VMs are added dynamically too, they may be allocated to this new Host, depending on the VmAllocationPolicy.

If an ID is not assigned to a Host, the method assigns one.

Parameters:

hostList - the List of new hosts to be added

Returns:

See Also:

getVmAllocationPolicy()

addHost

<T extends Host> Datacenter addHost(T host)

Physically expands the Datacenter by adding a new Host (physical machine) to it. Hosts can be added before or after the simulation has started. If a Host is added during simulation execution, in case VMs are added dynamically too, they may be allocated to this new Host, depending on the VmAllocationPolicy.

If an ID is not assigned to the given Host, the method assigns one.

Parameters:

host - the new host to be added

Returns:

See Also:

getVmAllocationPolicy()

getVmAllocationPolicy

VmAllocationPolicy getVmAllocationPolicy()

Gets the policy to be used by the Datacenter to allocate VMs into hosts.

Returns:

the VM allocation policy

See Also:

VmAllocationPolicy

getVmList

<T extends Vm> List<T> getVmList()

Gets a read-only list all VMs from all Hosts of this Datacenter.

Type Parameters:

T - the class of VMs inside the list

Returns:

the list all VMs from all Hosts

getSchedulingInterval

double getSchedulingInterval()

Gets the scheduling interval to process each event received by the Datacenter (in seconds). This value defines the interval in which processing of Cloudlets will be updated. The interval doesn't affect the processing of such cloudlets, it only defines in which interval the processing will be updated. For instance, if it is set a interval of 10 seconds, the processing of cloudlets will be updated at every 10 seconds. By this way, trying to get the amount of instructions the cloudlet has executed after 5 seconds, by means of Cloudlet.getFinishedLengthSoFar(Datacenter), it will not return an updated value. By this way, one should set the scheduling interval to 5 to get an updated result. As longer is the interval, faster will be the simulation execution.

Returns:

the scheduling interval (in seconds)

setSchedulingInterval

Datacenter setSchedulingInterval(double schedulingInterval)

Sets the scheduling delay to process each event received by the Datacenter (in seconds).

Parameters:

schedulingInterval - the new scheduling interval (in seconds)

Returns:

See Also:

getSchedulingInterval()

getCharacteristics

DatacenterCharacteristics getCharacteristics()

Gets the Datacenter characteristics.

Returns:

the Datacenter characteristics

getStorageList

List<FileStorage> getStorageList()

Gets a read-only list of storage devices of the Datacenter.

Returns:

the storage list

setStorageList

Datacenter setStorageList(List<FileStorage> storageList)

Sets the list of storage devices of the Datacenter.

Parameters:

storageList - the new storage list

Returns:

getBandwidthPercentForMigration

double getBandwidthPercentForMigration()

Gets the percentage of the bandwidth allocated to a Host to migrate VMs. It's a value between [0 and 1] (where 1 is 100%). The default value is 0.5, meaning only 50% of the bandwidth will be allowed for migration, while the remaining will be used for VM services.

Returns:

See Also:

DEF_BANDWIDTH_PERCENT_FOR_MIGRATION

setBandwidthPercentForMigration

void setBandwidthPercentForMigration(double bandwidthPercentForMigration)

Sets the percentage of the bandwidth allocated to a Host to migrate VMs. It's a value between [0 and 1] (where 1 is 100%). The default value is 0.5, meaning only 50% of the bandwidth will be allowed for migration, while the remaining will be used for VM services.

Parameters:

bandwidthPercentForMigration - the bandwidth migration percentage to set

getPower

double getPower()

Gets an estimation of Datacenter power consumption (in Watts/Second).

To get actual power consumption, it's required to enable Host's StateHistory by calling Host.enableStateHistory() and use each Host PowerModel to compute power usage based on the CPU utilization got form the StateHistory.

Returns:

th estimated power consumption (in Watts/Second)

getPowerInKWattsHour

double getPowerInKWattsHour()

Gets an estimation the Datacenter power consumption (in Kilo Watts/Hour).

Returns:

the estimated power consumption (in Kilo Watts/Hour)

See Also:

getPower()