edu.umass.cs.reconfiguration.reconfigurationutils

Class ProximateBalance

java.lang.Object

edu.umass.cs.reconfiguration.reconfigurationutils.AbstractDemandProfile

edu.umass.cs.reconfiguration.reconfigurationutils.DemandProfile

edu.umass.cs.reconfiguration.reconfigurationutils.ProximateBalance

public class ProximateBalance
extends DemandProfile

Author:

arun

Nested Class Summary

Nested classes/interfaces inherited from class edu.umass.cs.reconfiguration.reconfigurationutils.DemandProfile

DemandProfile.Keys

Field Summary

Fields inherited from class edu.umass.cs.reconfiguration.reconfigurationutils.DemandProfile

interArrivalTime, lastReconfiguredProfile, lastRequestTime, minReconfigurationInterval, minRequestsBeforeDemandReport, minRequestsBeforeReconfiguration, numRequests, numTotalRequests

Fields inherited from class edu.umass.cs.reconfiguration.reconfigurationutils.AbstractDemandProfile

name

Constructor Summary

Constructors

Constructor and Description
ProximateBalance(org.json.JSONObject json) Required JSONObject constructor.
ProximateBalance(java.lang.String name) Required String constructor.

Method Summary

Modifier and Type	Method and Description
DemandProfile	clone() Creates a deep copy of this object.
void	combine(AbstractDemandProfile dp) Combine the new information in update into this.
org.json.JSONObject	getDemandStats() All relevant stats must be serializable into JSONObject.
double	getNumRequests()
double	getNumTotalRequests()
double	getRequestRate()
void	justReconfigured() Tells this that the current demand profile was just used to perform reconfiguration.
static void	main(java.lang.String[] args)
java.util.Set<java.lang.String>	reconfigure(java.util.Set<java.lang.String> curActives, ReconfigurableAppInfo nodeConfig) The main reconfiguration policy invoked at reconfigurators (not active replicas).
boolean	shouldReportDemandStats(Request request, java.net.InetAddress sender, ReconfigurableAppInfo nodeConfig) This method is used to inform the reconfiguration policy that request received from a client at IP address sender.

Methods inherited from class edu.umass.cs.reconfiguration.reconfigurationutils.DemandProfile

createDemandProfile

Methods inherited from class edu.umass.cs.reconfiguration.reconfigurationutils.AbstractDemandProfile

createDemandProfile, createDemandProfile, getName, reset

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ProximateBalance

public ProximateBalance(java.lang.String name)

Required String constructor.

Parameters:

name -

ProximateBalance

public ProximateBalance(org.json.JSONObject json)
                 throws org.json.JSONException

Required JSONObject constructor.

Parameters:

json -

Throws:

org.json.JSONException

Method Detail

shouldReportDemandStats

public boolean shouldReportDemandStats(Request request,
                                       java.net.InetAddress sender,
                                       ReconfigurableAppInfo nodeConfig)

This method is used to inform the reconfiguration policy that request received from a client at IP address sender. The parameter nodeConfig provides the list of all active replica locations. The reconfiguration policy may use this information to assimilate a demand distribution and use that to determine whether and how to reconfigure the current set of replicas. The simplistic example below ignores the sender information that in general is needed to determine the geo-distribution of demand.

Overrides:

shouldReportDemandStats in class DemandProfile

Returns:

Whether the active replica should send a demand report to the reconfigurator.

getRequestRate

public double getRequestRate()

Overrides:

getRequestRate in class DemandProfile

Returns:

Request rate for the service name.

getNumRequests

public double getNumRequests()

Overrides:

getNumRequests in class DemandProfile

Returns:

Number of requests for this service name since the most recent demand report was sent to reconfigurators.

getNumTotalRequests

public double getNumTotalRequests()

Overrides:

getNumTotalRequests in class DemandProfile

Returns:

Total number of requests for this service name.

getDemandStats

public org.json.JSONObject getDemandStats()

Description copied from class: AbstractDemandProfile

All relevant stats must be serializable into JSONObject. Any information not included in the returned JSONObject will not be available for use in the reconfiguration policy in AbstractDemandProfile.reconfigure(Set, ReconfigurableAppInfo) that is invoked at reconfigurators (not active replicas).

Overrides:

getDemandStats in class DemandProfile

Returns:

Demand statistics as JSON.

clone

public DemandProfile clone()

Description copied from class: AbstractDemandProfile

Creates a deep copy of this object. So, it must be the case that the return value != this, but the return value.equals(this). You may also need to override equals(.) and hashCode() methods accordingly. If an implementation of this class consists of non-primitive types, e.g., a Map, then a new Map has to be created inside the clone() method.

Overrides:

clone in class AbstractDemandProfile

combine

public void combine(AbstractDemandProfile dp)

Description copied from class: AbstractDemandProfile

Combine the new information in update into this. This method is used at reconfigurators to combine a newly received demand report with an existing demand report.

Overrides:

combine in class DemandProfile

reconfigure

public java.util.Set<java.lang.String> reconfigure(java.util.Set<java.lang.String> curActives,
                                                   ReconfigurableAppInfo nodeConfig)

Description copied from class: AbstractDemandProfile

The main reconfiguration policy invoked at reconfigurators (not active replicas).

Overrides:

reconfigure in class DemandProfile

Returns:

The list of reconfigured actives for the new placement. Simply returning null means no reconfiguration will happen. Returning a list that is the same as curActives means that a trivial reconfiguration will happen unless ReconfigurationConfig.RC.RECONFIGURE_IN_PLACE is set to false.

justReconfigured

public void justReconfigured()

Description copied from class: AbstractDemandProfile

Tells this that the current demand profile was just used to perform reconfiguration. This information is useful for implementing policies based on the difference between the current demand profile and the one at the time of the most recent reconfiguration, e.g., reconfigure only if the demand from some region has changed by more than 10%.

Overrides:

justReconfigured in class DemandProfile

main

public static void main(java.lang.String[] args)

Parameters:

args -