org.apache.hadoop.yarn.server.resourcemanager

Class RMServerUtils

java.lang.Object

org.apache.hadoop.yarn.server.resourcemanager.RMServerUtils

public class RMServerUtils
extends Object

Utility methods to aid serving RM data through the REST and RPC APIs

Field Summary

Fields

Modifier and Type	Field and Description
static org.apache.hadoop.yarn.api.records.ApplicationResourceUsageReport	DUMMY_APPLICATION_RESOURCE_USAGE_REPORT Statically defined dummy ApplicationResourceUsageREport.

Constructor Summary

Constructors

Constructor and Description
RMServerUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static org.apache.hadoop.yarn.api.records.YarnApplicationAttemptState	createApplicationAttemptState(RMAppAttemptState rmAppAttemptState)
static org.apache.hadoop.yarn.api.records.YarnApplicationState	createApplicationState(RMAppState rmAppState)
static List<RMNode>	queryRMNodes(RMContext context, EnumSet<org.apache.hadoop.yarn.api.records.NodeState> acceptedStates)
static void	validateBlacklistRequest(org.apache.hadoop.yarn.api.records.ResourceBlacklistRequest blacklistRequest)
static void	validateContainerReleaseRequest(List<org.apache.hadoop.yarn.api.records.ContainerId> containerReleaseList, org.apache.hadoop.yarn.api.records.ApplicationAttemptId appAttemptId) It will validate to make sure all the containers belong to correct application attempt id.
static void	validateResourceRequests(List<org.apache.hadoop.yarn.api.records.ResourceRequest> ask, org.apache.hadoop.yarn.api.records.Resource maximumResource) Utility method to validate a list resource requests, by insuring that the requested memory/vcore is non-negative and not greater than max
static org.apache.hadoop.security.UserGroupInformation	verifyAccess(org.apache.hadoop.security.authorize.AccessControlList acl, String method, org.apache.commons.logging.Log LOG) Utility method to verify if the current user has access based on the passed AccessControlList

Methods inherited from class java.lang.Object

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

Field Detail

DUMMY_APPLICATION_RESOURCE_USAGE_REPORT

public static final org.apache.hadoop.yarn.api.records.ApplicationResourceUsageReport DUMMY_APPLICATION_RESOURCE_USAGE_REPORT

Statically defined dummy ApplicationResourceUsageREport. Used as a return value when a valid report cannot be found.

Constructor Detail

RMServerUtils

public RMServerUtils()

Method Detail

queryRMNodes

public static List<RMNode> queryRMNodes(RMContext context,
                        EnumSet<org.apache.hadoop.yarn.api.records.NodeState> acceptedStates)

validateResourceRequests

public static void validateResourceRequests(List<org.apache.hadoop.yarn.api.records.ResourceRequest> ask,
                            org.apache.hadoop.yarn.api.records.Resource maximumResource)
                                     throws org.apache.hadoop.yarn.exceptions.InvalidResourceRequestException

Utility method to validate a list resource requests, by insuring that the requested memory/vcore is non-negative and not greater than max

Throws:

org.apache.hadoop.yarn.exceptions.InvalidResourceRequestException

validateBlacklistRequest

public static void validateBlacklistRequest(org.apache.hadoop.yarn.api.records.ResourceBlacklistRequest blacklistRequest)
                                     throws org.apache.hadoop.yarn.exceptions.InvalidResourceBlacklistRequestException

Throws:

org.apache.hadoop.yarn.exceptions.InvalidResourceBlacklistRequestException

validateContainerReleaseRequest

public static void validateContainerReleaseRequest(List<org.apache.hadoop.yarn.api.records.ContainerId> containerReleaseList,
                                   org.apache.hadoop.yarn.api.records.ApplicationAttemptId appAttemptId)
                                            throws org.apache.hadoop.yarn.exceptions.InvalidContainerReleaseException

It will validate to make sure all the containers belong to correct application attempt id. If not then it will throw InvalidContainerReleaseException

Parameters:

containerReleaseList - containers to be released as requested by application master.

appAttemptId - Application attempt Id

Throws:

org.apache.hadoop.yarn.exceptions.InvalidContainerReleaseException

verifyAccess

public static org.apache.hadoop.security.UserGroupInformation verifyAccess(org.apache.hadoop.security.authorize.AccessControlList acl,
                                                           String method,
                                                           org.apache.commons.logging.Log LOG)
                                                                    throws IOException

Utility method to verify if the current user has access based on the passed AccessControlList

Parameters:

acl - the AccessControlList to check against

method - the method name to be logged

LOG - the logger to use

Returns:

UserGroupInformation of the current user

Throws:

IOException

createApplicationState

public static org.apache.hadoop.yarn.api.records.YarnApplicationState createApplicationState(RMAppState rmAppState)

createApplicationAttemptState

public static org.apache.hadoop.yarn.api.records.YarnApplicationAttemptState createApplicationAttemptState(RMAppAttemptState rmAppAttemptState)