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(InetAddress hostAddress, InetAddress hostAddress2) Returns the distance between 2 hosts identified by their inet addresses.
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<InetAddress>	getHosts() Gets the set of hosts handled by resource manager.
HashMap<InetAddress,Long>	getHostTopology(InetAddress hostAddress) Gets the distances associated to the host.
boolean	knownHost(InetAddress hostAddress) 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

getDistance

Long getDistance(InetAddress hostAddress,
                 InetAddress hostAddress2)

Returns the distance between 2 hosts identified by their inet addresses.

Returns:

the distance between 2 nodes

getDistance

Long getDistance(String hostName,
                 String hostName2)

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

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

knownHost

boolean knownHost(InetAddress hostAddress)

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

Parameters:

hostAddress - the address of the host

Returns:

true if the host is known, false otherwise

getHosts

Set<InetAddress> getHosts()

Gets the set of hosts handled by resource manager.

Returns:

the set of hosts handled by resource manager

getHostTopology

HashMap<InetAddress,Long> getHostTopology(InetAddress hostAddress)

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:

hostAddress - - inet address 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