org.apache.slider.server.appmaster.state

Class NodeEntry

java.lang.Object

org.apache.slider.server.appmaster.state.NodeEntry

All Implemented Interfaces:

Cloneable

public class NodeEntry
extends Object
implements Cloneable

Information about the state of a role on a specific node instance. No fields are synchronized; sync on the instance to work with it

The two fields `releasing` and `requested` are used to track the ongoing state of YARN requests; they do not need to be persisted across stop/start cycles. They may be relevant across AM restart, but without other data structures in the AM, not enough to track what the AM was up to before it was restarted. The strategy will be to ignore unexpected allocation responses (which may come from pre-restart) requests, while treating unexpected container release responses as failures.

The `active` counter is only decremented after a container release response has been received.

Field Summary

Fields

Modifier and Type	Field and Description
int	rolePriority

Constructor Summary

Constructors

Constructor and Description
NodeEntry(int rolePriority)

Method Summary

Methods

Modifier and Type	Method and Description
Object	clone()
boolean	containerCompleted(boolean wasReleased, ContainerOutcome outcome) completion event, which can be a planned or unplanned planned: dec our release count unplanned: dec our live count
int	getActive() return no of active instances -those that could be released as they are live and not already being released
int	getFailed()
int	getFailedRecently()
long	getLastUsed() Time last used.
int	getLive()
int	getPreempted()
int	getReleasing() No of instances in release state
int	getRequested() no of requests made of this role of this node.
int	getStartFailed()
int	getStarting()
boolean	isAntiAffinityConstraintHeld() Are the anti-affinity constraints held.
boolean	isAvailable() Is the node available for assignments? That is, it is not running any instances of this type, nor are there any requests oustanding for it.
boolean	notUsedSince(long absoluteTime) Return true if the node is not busy, and it has not been used since the absolute time
void	onStartCompleted()
boolean	onStartFailed() start failed -decrement the starting flag.
void	onStarting()
void	release() Release an instance -which is no longer marked as active
void	request() request a node:
void	requestCompleted() A request made explicitly to this node has completed
void	resetFailedRecently() Reset the failed recently count.
NodeEntryInformation	serialize() Produced a serialized form which can be served up as JSON
void	setFailedRecently(int failedRecently)
void	setLastUsed(long lastUsed)
void	setLive(int v) Set the live value directly -used on AM restart
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

rolePriority

public final int rolePriority

Constructor Detail

NodeEntry

public NodeEntry(int rolePriority)

Method Detail

isAvailable

public boolean isAvailable()

Is the node available for assignments? That is, it is not running any instances of this type, nor are there any requests oustanding for it.

Returns:

true if a new request could be issued without taking the number of instances > 1.

isAntiAffinityConstraintHeld

public boolean isAntiAffinityConstraintHeld()

Are the anti-affinity constraints held. That is, zero or one node running or starting

Returns:

true if the constraint holds.

getActive

public int getActive()

return no of active instances -those that could be released as they are live and not already being released

Returns:

a number, possibly 0

notUsedSince

public boolean notUsedSince(long absoluteTime)

Return true if the node is not busy, and it has not been used since the absolute time

Parameters:

absoluteTime - time

Returns:

true if the node could be cleaned up

getLive

public int getLive()

getStarting

public int getStarting()

setLive

public void setLive(int v)

Set the live value directly -used on AM restart

Parameters:

v - value

onStarting

public void onStarting()

onStartCompleted

public void onStartCompleted()

onStartFailed

public boolean onStartFailed()

start failed -decrement the starting flag.

Returns:

true if the node is now available

getRequested

public int getRequested()

no of requests made of this role of this node. If it goes above 1 there's a problem

request

public void request()

request a node:

requestCompleted

public void requestCompleted()

A request made explicitly to this node has completed

getReleasing

public int getReleasing()

No of instances in release state

release

public void release()

Release an instance -which is no longer marked as active

containerCompleted

public boolean containerCompleted(boolean wasReleased,
                         ContainerOutcome outcome)

completion event, which can be a planned or unplanned planned: dec our release count unplanned: dec our live count

Parameters:

wasReleased - true if this was planned

outcome -

Returns:

true if this node is now available

getLastUsed

public long getLastUsed()

Time last used.

setLastUsed

public void setLastUsed(long lastUsed)

getStartFailed

public int getStartFailed()

getFailed

public int getFailed()

getFailedRecently

public int getFailedRecently()

setFailedRecently

public void setFailedRecently(int failedRecently)

getPreempted

public int getPreempted()

resetFailedRecently

public void resetFailedRecently()

Reset the failed recently count.

toString

public String toString()

Overrides:

toString in class Object

serialize

public NodeEntryInformation serialize()

Produced a serialized form which can be served up as JSON

Returns:

a summary of the current role status.

clone

public Object clone()
             throws CloneNotSupportedException

Overrides:

clone in class Object

Throws:

CloneNotSupportedException