org.ow2.proactive.resourcemanager.frontend.topology

Interface Topology

All Superinterfaces:

Serializable

All Known Implementing Classes:

TopologyImpl

@PublicAPI
public interface Topology
extends Serializable

Interface represents hosts topology handled by resource manager. Users may receive the topology information using ResourceManager.getTopology() method.

Method Summary

Modifier and Type	Method and Description
List<Cluster<String>>	clusterize(int numberOfClusters, DistanceFunction distanceFunction) Clustirizes hosts into clusters based on their proximity
Long	getDistance(org.objectweb.proactive.core.node.Node node, org.objectweb.proactive.core.node.Node node2) Returns the distance between 2 nodes.
Long	getDistance(String hostName, String hostName2) Returns the distance between 2 hosts identified by their domain names.
Set<String>	getHosts() Gets the set of hosts handled by resource manager.
HashMap<String,Long>	getHostTopology(String hostName) Gets the distances associated to the host.
InetAddress	getInetAddress(String hostName) Return the inet address associated with this host
boolean	knownHost(String hostName) Checks if the information about host is presented in the topology records.
boolean	onSameHost(org.objectweb.proactive.core.node.Node node, org.objectweb.proactive.core.node.Node node2) Checks if 2 nodes are on the sane host.

Method Detail

getDistance

Long getDistance(org.objectweb.proactive.core.node.Node node,
                 org.objectweb.proactive.core.node.Node node2)

Returns the distance between 2 nodes.

Returns:

the distance between 2 nodes

onSameHost

boolean onSameHost(org.objectweb.proactive.core.node.Node node,
                   org.objectweb.proactive.core.node.Node node2)

Checks if 2 nodes are on the sane host.

Returns:

true if 2 nodes are on the same hosts, false otherwise

getDistance

Long getDistance(String hostName,
                 String hostName2)

Returns the distance between 2 hosts identified by their domain names.

Returns:

the distance between 2 nodes

knownHost

boolean knownHost(String hostName)

Checks if the information about host is presented in the topology records.

Parameters:

hostName - name of the host

Returns:

true if the host is known, false otherwise

getHosts

Set<String> getHosts()

Gets the set of hosts handled by resource manager.

Returns:

the set of hosts handled by resource manager

getInetAddress

InetAddress getInetAddress(String hostName)

Return the inet address associated with this host

Parameters:

hostName -

Returns:

associated inetAddress

getHostTopology

HashMap<String,Long> getHostTopology(String hostName)

Gets the distances associated to the host. Note that it does not return information about all hosts handled by the resource manager but rather the information about hosts added before the one specified.

Parameters:

hostName - - name of the host

Returns:

distances map to nodes added before this one

clusterize

List<Cluster<String>> clusterize(int numberOfClusters,
                                 DistanceFunction distanceFunction)

Clustirizes hosts into clusters based on their proximity

Parameters:

numberOfClusters - the number of clusters to produce

distanceFunction - the function for distances recalculation

Returns:

the list of host clusters