org.apache.slider.client.ipc

Class SliderClusterOperations

java.lang.Object

org.apache.slider.client.ipc.SliderClusterOperations

public class SliderClusterOperations
extends Object

Cluster operations at a slightly higher level than the RPC code

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.slf4j.Logger	log

Constructor Summary

Constructors

Constructor and Description
SliderClusterOperations(SliderClusterProtocol appMaster)

Method Summary

Methods

Modifier and Type	Method and Description
void	amSuicide(String text, int signal, int delay) Commit (possibly delayed) AM suicide
List<ClusterNode>	convertNodeWireToClusterNodes(List<Messages.RoleInstanceState> nodes) Unmarshall a list of nodes from a protobud response
String	echo(String text) Echo text (debug action)
Map<String,ComponentInformation>	enumComponents()
Map<String,ContainerInformation>	enumContainers()
boolean	flex(ConfTree resources) Flex operation
ApplicationLivenessInformation	getApplicationLiveness()
byte[]	getClientCertificateStore(String hostname, String clientId, String password, String type)
ClusterDescription	getClusterDescription() Connect to a live cluster and get its current state
ComponentInformation	getComponent(String componentName)
ContainerInformation	getContainer(String containerId)
List<ContainerInformation>	getContainers()
AggregateConf	getInstanceDefinition() Get the AM instance definition.
ApplicationLivenessInformation	getLivenessInformation() Get the application liveness
NodeInformation	getLiveNode(String hostname)
NodeInformationList	getLiveNodes()
ConfTreeOperations	getLiveResources()
AggregateConf	getModelDesired()
ConfTreeOperations	getModelDesiredAppconf()
ConfTreeOperations	getModelDesiredResources()
AggregateConf	getModelResolved()
ConfTreeOperations	getModelResolvedAppconf()
ConfTreeOperations	getModelResolvedResources()
ClusterNode	getNode(String uuid) Get a node from the AM
List<String>	innerListNodeUUIDSByRole(String role)
boolean	killContainer(String id) Kill a container
List<ClusterNode>	listClusterNodes(String[] uuids) Get the details on a list of uuids
List<ClusterNode>	listClusterNodesInRole(String role) List all nodes in a role.
String[]	listNodeUUIDsByRole(String role) List all node UUIDs in a role
PingInformation	ping(String text)
void	stop(String text)
String	toString()
int	waitForRoleInstanceLive(String role, long timeout) Wait for an instance of a named role to be live (or past it in the lifecycle)

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static final org.slf4j.Logger log

Constructor Detail

SliderClusterOperations

public SliderClusterOperations(SliderClusterProtocol appMaster)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

getNode

public ClusterNode getNode(String uuid)
                    throws IOException,
                           NoSuchNodeException,
                           org.apache.hadoop.yarn.exceptions.YarnException

Get a node from the AM

Parameters:

uuid - uuid of node

Returns:

deserialized node

Throws:

IOException - IO problems

NoSuchNodeException - if the node isn't found

org.apache.hadoop.yarn.exceptions.YarnException

convertNodeWireToClusterNodes

public List<ClusterNode> convertNodeWireToClusterNodes(List<Messages.RoleInstanceState> nodes)
                                                throws IOException

Unmarshall a list of nodes from a protobud response

Parameters:

nodes - node list

Returns:

possibly empty list of cluster nodes

Throws:

IOException

echo

public String echo(String text)
            throws org.apache.hadoop.yarn.exceptions.YarnException,
                   IOException

Echo text (debug action)

Parameters:

text - text

Returns:

the text, echoed back

Throws:

org.apache.hadoop.yarn.exceptions.YarnException

IOException

getClusterDescription

public ClusterDescription getClusterDescription()
                                         throws org.apache.hadoop.yarn.exceptions.YarnException,
                                                IOException

Connect to a live cluster and get its current state

Returns:

its description

Throws:

org.apache.hadoop.yarn.exceptions.YarnException

IOException

getInstanceDefinition

public AggregateConf getInstanceDefinition()
                                    throws org.apache.hadoop.yarn.exceptions.YarnException,
                                           IOException

Get the AM instance definition.

See SliderClusterProtocol.getInstanceDefinition(Messages.GetInstanceDefinitionRequestProto)

Returns:

current slider AM aggregate definition

Throws:

org.apache.hadoop.yarn.exceptions.YarnException

IOException

killContainer

public boolean killContainer(String id)
                      throws org.apache.hadoop.yarn.exceptions.YarnException,
                             IOException

Kill a container

Parameters:

id - container ID

Returns:

a success flag

Throws:

org.apache.hadoop.yarn.exceptions.YarnException

IOException

listNodeUUIDsByRole

public String[] listNodeUUIDsByRole(String role)
                             throws IOException,
                                    org.apache.hadoop.yarn.exceptions.YarnException

List all node UUIDs in a role

Parameters:

role - role name or "" for all

Returns:

an array of UUID strings

Throws:

IOException

org.apache.hadoop.yarn.exceptions.YarnException

innerListNodeUUIDSByRole

public List<String> innerListNodeUUIDSByRole(String role)
                                      throws IOException,
                                             org.apache.hadoop.yarn.exceptions.YarnException

Throws:

IOException

org.apache.hadoop.yarn.exceptions.YarnException

listClusterNodesInRole

public List<ClusterNode> listClusterNodesInRole(String role)
                                         throws IOException,
                                                org.apache.hadoop.yarn.exceptions.YarnException

List all nodes in a role. This is a double round trip: once to list the nodes in a role, another to get their details

Parameters:

role -

Returns:

an array of ContainerNode instances

Throws:

IOException

org.apache.hadoop.yarn.exceptions.YarnException

listClusterNodes

public List<ClusterNode> listClusterNodes(String[] uuids)
                                   throws IOException,
                                          org.apache.hadoop.yarn.exceptions.YarnException

Get the details on a list of uuids

Parameters:

uuids - instance IDs

Returns:

a possibly empty list of node details

Throws:

IOException

org.apache.hadoop.yarn.exceptions.YarnException

waitForRoleInstanceLive

public int waitForRoleInstanceLive(String role,
                          long timeout)
                            throws WaitTimeoutException,
                                   IOException,
                                   org.apache.hadoop.yarn.exceptions.YarnException

Wait for an instance of a named role to be live (or past it in the lifecycle)

Parameters:

role - role to look for

timeout - time to wait

Returns:

the state. If still in CREATED, the cluster didn't come up in the time period. If LIVE, all is well. If >LIVE, it has shut for a reason

Throws:

IOException - IO

SliderException - Slider

WaitTimeoutException - if the wait timed out

org.apache.hadoop.yarn.exceptions.YarnException

flex

public boolean flex(ConfTree resources)
             throws IOException

Flex operation

Parameters:

resources - new resources

Returns:

the response

Throws:

IOException

amSuicide

public void amSuicide(String text,
             int signal,
             int delay)
               throws IOException

Commit (possibly delayed) AM suicide

Parameters:

signal - exit code

text - text text to log

delay - delay in millis

Throws:

org.apache.hadoop.yarn.exceptions.YarnException

IOException

getLivenessInformation

public ApplicationLivenessInformation getLivenessInformation()
                                                      throws IOException

Get the application liveness

Returns:

current liveness information

Throws:

IOException

getModelDesired

public AggregateConf getModelDesired()
                              throws IOException

Throws:

IOException

getModelDesiredAppconf

public ConfTreeOperations getModelDesiredAppconf()
                                          throws IOException

Throws:

IOException

getModelDesiredResources

public ConfTreeOperations getModelDesiredResources()
                                            throws IOException

Throws:

IOException

getModelResolved

public AggregateConf getModelResolved()
                               throws IOException

Throws:

IOException

getModelResolvedAppconf

public ConfTreeOperations getModelResolvedAppconf()
                                           throws IOException

Throws:

IOException

getModelResolvedResources

public ConfTreeOperations getModelResolvedResources()
                                             throws IOException

Throws:

IOException

getLiveResources

public ConfTreeOperations getLiveResources()
                                    throws IOException

Throws:

IOException

enumContainers

public Map<String,ContainerInformation> enumContainers()
                                                throws IOException

Throws:

IOException

getContainer

public ContainerInformation getContainer(String containerId)
                                  throws IOException

Throws:

IOException

getContainers

public List<ContainerInformation> getContainers()
                                         throws IOException

Throws:

IOException

enumComponents

public Map<String,ComponentInformation> enumComponents()
                                                throws IOException

Throws:

IOException

getComponent

public ComponentInformation getComponent(String componentName)
                                  throws IOException

Throws:

IOException

getLiveNodes

public NodeInformationList getLiveNodes()
                                 throws IOException

Throws:

IOException

getLiveNode

public NodeInformation getLiveNode(String hostname)
                            throws IOException

Throws:

IOException

ping

public PingInformation ping(String text)
                     throws IOException

Throws:

IOException

stop

public void stop(String text)
          throws IOException

Throws:

IOException

getApplicationLiveness

public ApplicationLivenessInformation getApplicationLiveness()
                                                      throws IOException

Throws:

IOException

getClientCertificateStore

public byte[] getClientCertificateStore(String hostname,
                               String clientId,
                               String password,
                               String type)
                                 throws IOException

Throws:

IOException