ibis.constellation

Class ConstellationConfiguration

java.lang.Object

ibis.constellation.ConstellationConfiguration

public class ConstellationConfiguration
extends java.lang.Object

A ConstellationConfiguration represents some capabilities for running activities. These capabilities could represent a single core, a multiple-core processor, some specialized hardware, or an entire cluster. It is up to the application how these configurations represent the hardware. An executor that corresponds to a specific ConstellationConfiguration is a member of a StealPool, and can steal activities from another StealPool. These steal pools are to be provided to the constructor of the ConstellationConfiguration. Also, three (possibly different) steal strategies, represented by StealStrategy are to be provided:

• a local steal strategy, which decides which activities to execute when stealing from the executor at hand;
• a "constellation-wide" steal strategy, which decides which activities to execute when stealing from within this constellation instance, but from other executors;
• a remote steal strategy, which decides which activities to execute when stealing from other constellation instances.

Constructor Summary

Constructors

Constructor and Description
ConstellationConfiguration(AbstractContext context) Constructs a ConstellationConfiguration with the specified parameters.
ConstellationConfiguration(AbstractContext context, StealPool belongsTo, StealPool stealsFrom, StealStrategy localStealStrategy, StealStrategy constellationStealStrategy, StealStrategy remoteStealStrategy) Constructs a ConstellationConfiguration with the specified parameters.
ConstellationConfiguration(AbstractContext context, StealStrategy stealStrategy) Constructs a ConstellationConfiguration with the specified parameters.
ConstellationConfiguration(AbstractContext context, StealStrategy localStealStrategy, StealStrategy remoteStealStrategy) Constructs a ConstellationConfiguration with the specified parameters.
ConstellationConfiguration(AbstractContext context, StealStrategy localStealStrategy, StealStrategy constellationStealStrategy, StealStrategy remoteStealStrategy) Constructs a ConstellationConfiguration with the specified parameters.

Method Summary

Modifier and Type	Method and Description
StealPool	getBelongsToPool() Returns the pool to which executors of this ConstellationConfiguration belong.
StealStrategy	getConstellationStealStrategy() Returns the constellation steal strategy of this ConstellationConfiguration.
AbstractContext	getContext() Returns the context of this ConstellationConfiguration.
StealStrategy	getLocalStealStrategy() Returns the local steal strategy of thisConstellationConfiguration.
StealStrategy	getRemoteStealStrategy() Returns the remote steal strategy of this ConstellationConfiguration.
StealPool	getStealsFrom() Returns the pool from which executors of this ConstellationConfiguration can steal.
void	setBelongsToPool(StealPool myPool)
void	setConstellationStealStrategy(StealStrategy constellationStealStrategy)
void	setContext(AbstractContext context)
void	setLocalStealStrategy(StealStrategy localStealStrategy)
void	setRemoteStealStrategy(StealStrategy remoteStealStrategy)
void	setStealsFrom(StealPool stealsFrom)

Methods inherited from class java.lang.Object

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

Constructor Detail

ConstellationConfiguration

public ConstellationConfiguration(AbstractContext context,
                                  StealPool belongsTo,
                                  StealPool stealsFrom,
                                  StealStrategy localStealStrategy,
                                  StealStrategy constellationStealStrategy,
                                  StealStrategy remoteStealStrategy)

Constructs a ConstellationConfiguration with the specified parameters. Executors with this configuration will behave as described by the parameter section below.

Parameters:

belongsTo - steal pool that these executors will belong to.

stealsFrom - steal pool that these executors will steal from.

context - context of these executors, to be used in finding matching activities

localStealStrategy - steal strategy for local steals

constellationStealStrategy - steal strategy for steals within this constellation, from other executors.

remoteStealStrategy - steal strategy for stealing from other constellation instances.

Throws:

java.lang.IllegalArgumentException - when any of the specified parameters is null.

ConstellationConfiguration

public ConstellationConfiguration(AbstractContext context,
                                  StealStrategy localStealStrategy,
                                  StealStrategy constellationStealStrategy,
                                  StealStrategy remoteStealStrategy)

Constructs a ConstellationConfiguration with the specified parameters. Executors with this configuration will behave as described by the parameter section below. This version of the constructor uses StealPool.WORLD for both steal pools.

Parameters:

context - context of these executors, to be used in finding matching activities

localStealStrategy - steal strategy for local steals

constellationStealStrategy - steal strategy for steals within this constellation, from other executors.

remoteStealStrategy - steal strategy for stealing from other constellation instances.

Throws:

java.lang.IllegalArgumentException - when any of the specified parameters is null.

ConstellationConfiguration

public ConstellationConfiguration(AbstractContext context,
                                  StealStrategy stealStrategy)

Constructs a ConstellationConfiguration with the specified parameters. Executors with this configuration will behave as described by the parameter section below. This version of the constructor uses StealPool.WORLD for both steal pools.

Parameters:

context - context of these executors, to be used in finding matching activities

stealStrategy - steal strategy for all steals

Throws:

java.lang.IllegalArgumentException - when any of the specified parameters is null.

ConstellationConfiguration

public ConstellationConfiguration(AbstractContext context,
                                  StealStrategy localStealStrategy,
                                  StealStrategy remoteStealStrategy)

Constructs a ConstellationConfiguration with the specified parameters. Executors with this configuration will behave as described by the parameter section below. This version of the constructor uses StealPool.WORLD for both steal pools.

Parameters:

context - context of these executors, to be used in finding matching activities

localStealStrategy - steal strategy for local steals

remoteStealStrategy - steal strategy for stealing from other constellation instances or other executors.

Throws:

java.lang.IllegalArgumentException - when any of the specified parameters is null.

ConstellationConfiguration

public ConstellationConfiguration(AbstractContext context)

Constructs a ConstellationConfiguration with the specified parameters. Executors with this configuration will behave as described by the parameter section below. This version of the constructor uses StealPool.WORLD for both steal pools, and StealStrategy.SMALLEST for the steal strategies.

Parameters:

context - context of these executors, to be used in finding matching activities

Throws:

java.lang.IllegalArgumentException - when any of the specified parameters is null.

Method Detail

getContext

public AbstractContext getContext()

Returns the context of this ConstellationConfiguration.

Returns:

the context

setContext

public void setContext(AbstractContext context)

getLocalStealStrategy

public StealStrategy getLocalStealStrategy()

Returns the local steal strategy of thisConstellationConfiguration.

Returns:

the local steal strategy.

setLocalStealStrategy

public void setLocalStealStrategy(StealStrategy localStealStrategy)

getConstellationStealStrategy

public StealStrategy getConstellationStealStrategy()

Returns the constellation steal strategy of this ConstellationConfiguration.

Returns:

the constellation steal strategy.

setConstellationStealStrategy

public void setConstellationStealStrategy(StealStrategy constellationStealStrategy)

getRemoteStealStrategy

public StealStrategy getRemoteStealStrategy()

Returns the remote steal strategy of this ConstellationConfiguration.

Returns:

the remote steal strategy.

setRemoteStealStrategy

public void setRemoteStealStrategy(StealStrategy remoteStealStrategy)

getBelongsToPool

public StealPool getBelongsToPool()

Returns the pool to which executors of this ConstellationConfiguration belong.

Returns:

the membership pool.

setBelongsToPool

public void setBelongsToPool(StealPool myPool)

getStealsFrom

public StealPool getStealsFrom()

Returns the pool from which executors of this ConstellationConfiguration can steal.

Returns:

the pool to steal from.

setStealsFrom

public void setStealsFrom(StealPool stealsFrom)