package org.cloudbus.cloudsim.container.core;
import org.cloudbus.cloudsim.container.lists.ContainerVmPeList;
import org.cloudbus.cloudsim.core.CloudSim;
import java.util.List;
/**
* Created by sareh on 10/07/15.
*/
public class ContainerDatacenterCharacteristics {
/**
* The resource id -- setup when Resource is created.
*/
private int id;
/**
* The architecture.
*/
private String architecture;
/**
* The os.
*/
private String os;
/**
* The host list.
*/
private List<? extends ContainerHost> hostList;
/**
* The time zone -- difference from GMT.
*/
private double timeZone;
/**
* Price/CPU-unit if unit = sec., then G$/CPU-sec.
*/
private double costPerSecond;
/**
* Resource Types -- allocation policy.
*/
private int allocationPolicy;
/**
* Time-shared system using Round-Robin algorithm.
*/
public static final int TIME_SHARED = 0;
/**
* Spaced-shared system using First Come First Serve (FCFS) algorithm.
*/
public static final int SPACE_SHARED = 1;
/**
* Assuming all PEs in all Machines have the same rating.
*/
public static final int OTHER_POLICY_SAME_RATING = 2;
/**
* Assuming all PEs in a Machine have the same rating. However, each Machine has different
* rating to each other.
*/
public static final int OTHER_POLICY_DIFFERENT_RATING = 3;
/**
* A resource that supports Advanced Reservation mechanisms.
*/
public static final int ADVANCE_RESERVATION = 4;
/**
* The vmm.
*/
private String vmm;
/**
* The cost per mem.
*/
private double costPerMem;
/**
* The cost per storage.
*/
private double costPerStorage;
/**
* The cost per bw.
*/
private double costPerBw;
/**
* Allocates a new DatacenterCharacteristics object. If the time zone is invalid, then by
* default, it will be GMT+0.
*
* @param architecture the architecture of a resource
* @param os the operating system used
* @param vmm the virtual machine monitor used
* @param hostList list of machines in a resource
* @param timeZone local time zone of a user that owns this reservation. Time zone should be of
* range [GMT-12 ... GMT+13]
* @param costPerSec the cost per sec to use this resource
* @param costPerMem the cost to use memory in this resource
* @param costPerStorage the cost to use storage in this resource
* @param costPerBw the cost per bw
* @pre architecture != null
* @pre OS != null
* @pre VMM != null
* @pre machineList != null
* @pre timeZone >= -12 && timeZone <= 13
* @pre costPerSec >= 0.0
* @pre costPerMem >= 0
* @pre costPerStorage >= 0
* @post $none
*/
public ContainerDatacenterCharacteristics(
String architecture,
String os,
String vmm,
List<? extends ContainerHost> hostList,
double timeZone,
double costPerSec,
double costPerMem,
double costPerStorage,
double costPerBw) {
setId(-1);
setArchitecture(architecture);
setOs(os);
setHostList(hostList);
setAllocationPolicy(allocationPolicy);
setCostPerSecond(costPerSec);
setTimeZone(0.0);
setVmm(vmm);
setCostPerMem(costPerMem);
setCostPerStorage(costPerStorage);
setCostPerBw(costPerBw);
}
/**
* Gets the name of a resource.
*
* @return the resource name
* @pre $none
* @post $result != null
*/
public String getResourceName() {
return CloudSim.getEntityName(getId());
}
/**
* Gets a Machine with at least one empty Pe.
*
* @return a Machine object or if not found
* @pre $none
* @post $none
*/
public ContainerHost getHostWithFreePe() {
return ContainerHostList.getHostWithFreePe(getHostList());
}
/**
* Gets a Machine with at least a given number of free Pe.
*
* @param peNumber the pe number
* @return a Machine object or if not found
* @pre $none
* @post $none
*/
public ContainerHost getHostWithFreePe(int peNumber) {
return ContainerHostList.getHostWithFreePe(getHostList(), peNumber);
}
/**
* Gets Millions Instructions Per Second (MIPS) Rating of a Processing Element (Pe). It is
* assumed all PEs' rating is same in a given machine.
*
* @return the MIPS Rating or if no PEs are exists.
* @pre $none
* @post $result >= -1
*/
public int getMipsOfOnePe() {
if (getHostList().size() == 0) {
return -1;
}
return ContainerVmPeList.getMips(getHostList().get(0).getPeList(), 0);
}
/**
* Gets Millions Instructions Per Second (MIPS) Rating of a Processing Element (Pe). It is
* essential to use this method when a resource is made up of heterogenous PEs/machines.
*
* @param id the machine ID
* @param peId the Pe ID
* @return the MIPS Rating or if no PEs are exists.
* @pre id >= 0
* @pre peID >= 0
* @post $result >= -1
*/
public int getMipsOfOnePe(int id, int peId) {
if (getHostList().size() == 0) {
return -1;
}
return ContainerVmPeList.getMips(ContainerHostList.getById(getHostList(), id).getPeList(), peId);
}
/**
* Gets the total MIPS rating, which is the sum of MIPS rating of all machines in a resource.
* <p/>
* Total MIPS rating for:
* <ul>
* <li>TimeShared = 1 Rating of a Pe * Total number of PEs
* <li>Other policy same rating = same as TimeShared
* <li>SpaceShared = Sum of all PEs in all Machines
* <li>Other policy different rating = same as SpaceShared
* <li>Advance Reservation = 0 or unknown. You need to calculate this manually.
* </ul>
*
* @return the sum of MIPS ratings
* @pre $none
* @post $result >= 0
*/
public int getMips() {
int mips = 0;
switch (getAllocationPolicy()) {
// Assuming all PEs in all Machine have same rating.
case ContainerDatacenterCharacteristics.TIME_SHARED:
case ContainerDatacenterCharacteristics.OTHER_POLICY_SAME_RATING:
mips = getMipsOfOnePe() * ContainerHostList.getNumberOfPes(getHostList());
break;
// Assuming all PEs in a given Machine have the same rating.
// But different machines in a Cluster can have different rating
case ContainerDatacenterCharacteristics.SPACE_SHARED:
case ContainerDatacenterCharacteristics.OTHER_POLICY_DIFFERENT_RATING:
for (ContainerHost host : getHostList()) {
mips += host.getTotalMips();
}
break;
default:
break;
}
return mips;
}
/**
* Gets the CPU time given the specified parameters (only for TIME_SHARED). <tt>NOTE:</tt> The
* CPU time for SPACE_SHARED and ADVANCE_RESERVATION are not yet implemented.
*
* @param cloudletLength the length of a Cloudlet
* @param load the load of a Cloudlet
* @return the CPU time
* @pre cloudletLength >= 0.0
* @pre load >= 0.0
* @post $result >= 0.0
*/
public double getCpuTime(double cloudletLength, double load) {
double cpuTime = 0.0;
switch (getAllocationPolicy()) {
case ContainerDatacenterCharacteristics.TIME_SHARED:
cpuTime = cloudletLength / (getMipsOfOnePe() * (1.0 - load));
break;
default:
break;
}
return cpuTime;
}
/**
* Gets the total number of PEs for all Machines.
*
* @return number of PEs
* @pre $none
* @post $result >= 0
*/
public int getNumberOfPes() {
return ContainerHostList.getNumberOfPes(getHostList());
}
/**
* Gets the total number of <tt>FREE</tt> or non-busy PEs for all Machines.
*
* @return number of PEs
* @pre $none
* @post $result >= 0
*/
public int getNumberOfFreePes() {
return ContainerHostList.getNumberOfFreePes(getHostList());
}
/**
* Gets the total number of <tt>BUSY</tt> PEs for all Machines.
*
* @return number of PEs
* @pre $none
* @post $result >= 0
*/
public int getNumberOfBusyPes() {
return ContainerHostList.getNumberOfBusyPes(getHostList());
}
/**
* Sets the particular Pe status on a Machine.
*
* @param status Pe status, either <tt>Pe.FREE</tt> or <tt>Pe.BUSY</tt>
* @param hostId Machine ID
* @param peId Pe id
* @return otherwise (Machine id or Pe id might not be exist)
* @pre machineID >= 0
* @pre peID >= 0
* @post $none
*/
public boolean setPeStatus(int status, int hostId, int peId) {
return ContainerHostList.setPeStatus(getHostList(), status, hostId, peId);
}
/**
* Gets the cost per Millions Instruction (MI) associated with a resource.
*
* @return the cost using a resource
* @pre $none
* @post $result >= 0.0
*/
public double getCostPerMi() {
return getCostPerSecond() / getMipsOfOnePe();
}
/**
* Gets the total number of machines.
*
* @return total number of machines this resource has.
*/
public int getNumberOfHosts() {
return getHostList().size();
}
/**
* Gets the current number of failed machines.
*
* @return current number of failed machines this resource has.
*/
public int getNumberOfFailedHosts() {
int numberOfFailedHosts = 0;
for (ContainerHost host : getHostList()) {
if (host.isFailed()) {
numberOfFailedHosts++;
}
}
return numberOfFailedHosts;
}
/**
* Checks whether all machines of this resource are working properly or not.
*
* @return if all machines are working, otherwise
*/
public boolean isWorking() {
boolean result = false;
if (getNumberOfFailedHosts() == 0) {
result = true;
}
return result;
}
/**
* Get the cost to use memory in this resource.
*
* @return the cost to use memory
*/
public double getCostPerMem() {
return costPerMem;
}
/**
* Sets cost to use memory.
*
* @param costPerMem cost to use memory
* @pre costPerMem >= 0
* @post $none
*/
public void setCostPerMem(double costPerMem) {
this.costPerMem = costPerMem;
}
/**
* Get the cost to use storage in this resource.
*
* @return the cost to use storage
*/
public double getCostPerStorage() {
return costPerStorage;
}
/**
* Sets cost to use storage.
*
* @param costPerStorage cost to use storage
* @pre costPerStorage >= 0
* @post $none
*/
public void setCostPerStorage(double costPerStorage) {
this.costPerStorage = costPerStorage;
}
/**
* Get the cost to use bandwidth in this resource.
*
* @return the cost to use bw
*/
public double getCostPerBw() {
return costPerBw;
}
/**
* Sets cost to use bw cost to use bw.
*
* @param costPerBw the cost per bw
* @pre costPerBw >= 0
* @post $none
*/
public void setCostPerBw(double costPerBw) {
this.costPerBw = costPerBw;
}
/**
* Gets the VMM in use in the datacenter.
*
* @return the VMM name
*/
public String getVmm() {
return vmm;
}
/**
* Gets the id.
*
* @return the id
*/
public int getId() {
return id;
}
/**
* Sets the id.
*
* @param id the new id
*/
protected void setId(int id) {
this.id = id;
}
/**
* Gets the architecture.
*
* @return the architecture
*/
protected String getArchitecture() {
return architecture;
}
/**
* Sets the architecture.
*
* @param architecture the new architecture
*/
protected void setArchitecture(String architecture) {
this.architecture = architecture;
}
/**
* Gets the os.
*
* @return the os
*/
protected String getOs() {
return os;
}
/**
* Sets the os.
*
* @param os the new os
*/
protected void setOs(String os) {
this.os = os;
}
/**
* Gets the host list.
*
* @param <T> the generic type
* @return the host list
*/
@SuppressWarnings("unchecked")
public <T extends ContainerHost> List<T> getHostList() {
return (List<T>) hostList;
}
/**
* Sets the host list.
*
* @param <T> the generic type
* @param hostList the new host list
*/
protected <T extends ContainerHost> void setHostList(List<T> hostList) {
this.hostList = hostList;
}
/**
* Gets the time zone.
*
* @return the time zone
*/
protected double getTimeZone() {
return timeZone;
}
/**
* Sets the time zone.
*
* @param timeZone the new time zone
*/
protected void setTimeZone(double timeZone) {
this.timeZone = timeZone;
}
/**
* Gets the cost per second.
*
* @return the cost per second
*/
public double getCostPerSecond() {
return costPerSecond;
}
/**
* Sets the cost per second.
*
* @param costPerSecond the new cost per second
*/
protected void setCostPerSecond(double costPerSecond) {
this.costPerSecond = costPerSecond;
}
/**
* Gets the allocation policy.
*
* @return the allocation policy
*/
protected int getAllocationPolicy() {
return allocationPolicy;
}
/**
* Sets the allocation policy.
*
* @param allocationPolicy the new allocation policy
*/
protected void setAllocationPolicy(int allocationPolicy) {
this.allocationPolicy = allocationPolicy;
}
/**
* Sets the vmm.
*
* @param vmm the new vmm
*/
protected void setVmm(String vmm) {
this.vmm = vmm;
}
}