| /** |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package org.apache.hadoop.yarn.conf; |
| |
| import java.net.InetSocketAddress; |
| import java.util.Arrays; |
| import java.util.Collections; |
| import java.util.List; |
| |
| import org.apache.hadoop.HadoopIllegalArgumentException; |
| import org.apache.hadoop.classification.InterfaceAudience.Private; |
| import org.apache.hadoop.classification.InterfaceAudience.Public; |
| import org.apache.hadoop.classification.InterfaceStability.Evolving; |
| import org.apache.hadoop.classification.InterfaceStability.Unstable; |
| import org.apache.hadoop.conf.Configuration; |
| import org.apache.hadoop.http.HttpConfig; |
| import org.apache.hadoop.net.NetUtils; |
| import org.apache.hadoop.util.StringUtils; |
| import org.apache.hadoop.yarn.api.ApplicationConstants; |
| |
| @Public |
| @Evolving |
| public class YarnConfiguration extends Configuration { |
| |
| @Private |
| public static final String CS_CONFIGURATION_FILE= "capacity-scheduler.xml"; |
| |
| @Private |
| public static final String HADOOP_POLICY_CONFIGURATION_FILE = |
| "hadoop-policy.xml"; |
| |
| @Private |
| public static final String YARN_SITE_CONFIGURATION_FILE = "yarn-site.xml"; |
| |
| private static final String YARN_DEFAULT_CONFIGURATION_FILE = |
| "yarn-default.xml"; |
| |
| @Private |
| public static final String CORE_SITE_CONFIGURATION_FILE = "core-site.xml"; |
| |
| @Private |
| public static final List<String> RM_CONFIGURATION_FILES = |
| Collections.unmodifiableList(Arrays.asList( |
| CS_CONFIGURATION_FILE, |
| HADOOP_POLICY_CONFIGURATION_FILE, |
| YARN_SITE_CONFIGURATION_FILE, |
| CORE_SITE_CONFIGURATION_FILE)); |
| |
| @Evolving |
| public static final int APPLICATION_MAX_TAGS = 10; |
| |
| @Evolving |
| public static final int APPLICATION_MAX_TAG_LENGTH = 100; |
| |
| static { |
| Configuration.addDefaultResource(YARN_DEFAULT_CONFIGURATION_FILE); |
| Configuration.addDefaultResource(YARN_SITE_CONFIGURATION_FILE); |
| } |
| |
| //Configurations |
| |
| public static final String YARN_PREFIX = "yarn."; |
| |
| /** Delay before deleting resource to ease debugging of NM issues */ |
| public static final String DEBUG_NM_DELETE_DELAY_SEC = |
| YarnConfiguration.NM_PREFIX + "delete.debug-delay-sec"; |
| |
| //////////////////////////////// |
| // IPC Configs |
| //////////////////////////////// |
| public static final String IPC_PREFIX = YARN_PREFIX + "ipc."; |
| |
| /** Factory to create client IPC classes.*/ |
| public static final String IPC_CLIENT_FACTORY_CLASS = |
| IPC_PREFIX + "client.factory.class"; |
| public static final String DEFAULT_IPC_CLIENT_FACTORY_CLASS = |
| "org.apache.hadoop.yarn.factories.impl.pb.RpcClientFactoryPBImpl"; |
| |
| /** Factory to create server IPC classes.*/ |
| public static final String IPC_SERVER_FACTORY_CLASS = |
| IPC_PREFIX + "server.factory.class"; |
| public static final String DEFAULT_IPC_SERVER_FACTORY_CLASS = |
| "org.apache.hadoop.yarn.factories.impl.pb.RpcServerFactoryPBImpl"; |
| |
| /** Factory to create serializeable records.*/ |
| public static final String IPC_RECORD_FACTORY_CLASS = |
| IPC_PREFIX + "record.factory.class"; |
| public static final String DEFAULT_IPC_RECORD_FACTORY_CLASS = |
| "org.apache.hadoop.yarn.factories.impl.pb.RecordFactoryPBImpl"; |
| |
| /** RPC class implementation*/ |
| public static final String IPC_RPC_IMPL = |
| IPC_PREFIX + "rpc.class"; |
| public static final String DEFAULT_IPC_RPC_IMPL = |
| "org.apache.hadoop.yarn.ipc.HadoopYarnProtoRPC"; |
| |
| //////////////////////////////// |
| // Resource Manager Configs |
| //////////////////////////////// |
| public static final String RM_PREFIX = "yarn.resourcemanager."; |
| |
| public static final String RM_CLUSTER_ID = RM_PREFIX + "cluster-id"; |
| |
| public static final String RM_HOSTNAME = RM_PREFIX + "hostname"; |
| |
| /** The address of the applications manager interface in the RM.*/ |
| public static final String RM_ADDRESS = |
| RM_PREFIX + "address"; |
| public static final int DEFAULT_RM_PORT = 8032; |
| public static final String DEFAULT_RM_ADDRESS = |
| "0.0.0.0:" + DEFAULT_RM_PORT; |
| |
| /** The actual bind address for the RM.*/ |
| public static final String RM_BIND_HOST = |
| RM_PREFIX + "bind-host"; |
| |
| /** The number of threads used to handle applications manager requests.*/ |
| public static final String RM_CLIENT_THREAD_COUNT = |
| RM_PREFIX + "client.thread-count"; |
| public static final int DEFAULT_RM_CLIENT_THREAD_COUNT = 50; |
| |
| /** The Kerberos principal for the resource manager.*/ |
| public static final String RM_PRINCIPAL = |
| RM_PREFIX + "principal"; |
| |
| /** The address of the scheduler interface.*/ |
| public static final String RM_SCHEDULER_ADDRESS = |
| RM_PREFIX + "scheduler.address"; |
| public static final int DEFAULT_RM_SCHEDULER_PORT = 8030; |
| public static final String DEFAULT_RM_SCHEDULER_ADDRESS = "0.0.0.0:" + |
| DEFAULT_RM_SCHEDULER_PORT; |
| |
| /** Miniumum request grant-able by the RM scheduler. */ |
| public static final String RM_SCHEDULER_MINIMUM_ALLOCATION_MB = |
| YARN_PREFIX + "scheduler.minimum-allocation-mb"; |
| public static final int DEFAULT_RM_SCHEDULER_MINIMUM_ALLOCATION_MB = 1024; |
| public static final String RM_SCHEDULER_MINIMUM_ALLOCATION_VCORES = |
| YARN_PREFIX + "scheduler.minimum-allocation-vcores"; |
| public static final int DEFAULT_RM_SCHEDULER_MINIMUM_ALLOCATION_VCORES = 1; |
| |
| /** Maximum request grant-able by the RM scheduler. */ |
| public static final String RM_SCHEDULER_MAXIMUM_ALLOCATION_MB = |
| YARN_PREFIX + "scheduler.maximum-allocation-mb"; |
| public static final int DEFAULT_RM_SCHEDULER_MAXIMUM_ALLOCATION_MB = 8192; |
| public static final String RM_SCHEDULER_MAXIMUM_ALLOCATION_VCORES = |
| YARN_PREFIX + "scheduler.maximum-allocation-vcores"; |
| public static final int DEFAULT_RM_SCHEDULER_MAXIMUM_ALLOCATION_VCORES = 4; |
| |
| /** Number of threads to handle scheduler interface.*/ |
| public static final String RM_SCHEDULER_CLIENT_THREAD_COUNT = |
| RM_PREFIX + "scheduler.client.thread-count"; |
| public static final int DEFAULT_RM_SCHEDULER_CLIENT_THREAD_COUNT = 50; |
| |
| /** If the port should be included or not in the node name. The node name |
| * is used by the scheduler for resource requests allocation location |
| * matching. Typically this is just the hostname, using the port is needed |
| * when using minicluster and specific NM are required.*/ |
| public static final String RM_SCHEDULER_INCLUDE_PORT_IN_NODE_NAME = |
| YARN_PREFIX + "scheduler.include-port-in-node-name"; |
| public static final boolean DEFAULT_RM_SCHEDULER_USE_PORT_FOR_NODE_NAME = |
| false; |
| |
| /** |
| * Enable periodic monitor threads. |
| * @see #RM_SCHEDULER_MONITOR_POLICIES |
| */ |
| public static final String RM_SCHEDULER_ENABLE_MONITORS = |
| RM_PREFIX + "scheduler.monitor.enable"; |
| public static final boolean DEFAULT_RM_SCHEDULER_ENABLE_MONITORS = false; |
| |
| /** List of SchedulingEditPolicy classes affecting the scheduler. */ |
| public static final String RM_SCHEDULER_MONITOR_POLICIES = |
| RM_PREFIX + "scheduler.monitor.policies"; |
| |
| /** The address of the RM web application.*/ |
| public static final String RM_WEBAPP_ADDRESS = |
| RM_PREFIX + "webapp.address"; |
| |
| public static final int DEFAULT_RM_WEBAPP_PORT = 8088; |
| public static final String DEFAULT_RM_WEBAPP_ADDRESS = "0.0.0.0:" + |
| DEFAULT_RM_WEBAPP_PORT; |
| |
| /** The https address of the RM web application.*/ |
| public static final String RM_WEBAPP_HTTPS_ADDRESS = |
| RM_PREFIX + "webapp.https.address"; |
| public static final boolean YARN_SSL_CLIENT_HTTPS_NEED_AUTH_DEFAULT = false; |
| public static final String YARN_SSL_SERVER_RESOURCE_DEFAULT = "ssl-server.xml"; |
| |
| public static final int DEFAULT_RM_WEBAPP_HTTPS_PORT = 8090; |
| public static final String DEFAULT_RM_WEBAPP_HTTPS_ADDRESS = "0.0.0.0:" |
| + DEFAULT_RM_WEBAPP_HTTPS_PORT; |
| |
| public static final String RM_RESOURCE_TRACKER_ADDRESS = |
| RM_PREFIX + "resource-tracker.address"; |
| public static final int DEFAULT_RM_RESOURCE_TRACKER_PORT = 8031; |
| public static final String DEFAULT_RM_RESOURCE_TRACKER_ADDRESS = |
| "0.0.0.0:" + DEFAULT_RM_RESOURCE_TRACKER_PORT; |
| |
| /** The expiry interval for application master reporting.*/ |
| public static final String RM_AM_EXPIRY_INTERVAL_MS = |
| YARN_PREFIX + "am.liveness-monitor.expiry-interval-ms"; |
| public static final int DEFAULT_RM_AM_EXPIRY_INTERVAL_MS = 600000; |
| |
| /** How long to wait until a node manager is considered dead.*/ |
| public static final String RM_NM_EXPIRY_INTERVAL_MS = |
| YARN_PREFIX + "nm.liveness-monitor.expiry-interval-ms"; |
| public static final int DEFAULT_RM_NM_EXPIRY_INTERVAL_MS = 600000; |
| |
| /** Are acls enabled.*/ |
| public static final String YARN_ACL_ENABLE = |
| YARN_PREFIX + "acl.enable"; |
| public static final boolean DEFAULT_YARN_ACL_ENABLE = false; |
| |
| /** ACL of who can be admin of YARN cluster.*/ |
| public static final String YARN_ADMIN_ACL = |
| YARN_PREFIX + "admin.acl"; |
| public static final String DEFAULT_YARN_ADMIN_ACL = "*"; |
| |
| /** ACL used in case none is found. Allows nothing. */ |
| public static final String DEFAULT_YARN_APP_ACL = " "; |
| |
| /** The address of the RM admin interface.*/ |
| public static final String RM_ADMIN_ADDRESS = |
| RM_PREFIX + "admin.address"; |
| public static final int DEFAULT_RM_ADMIN_PORT = 8033; |
| public static final String DEFAULT_RM_ADMIN_ADDRESS = "0.0.0.0:" + |
| DEFAULT_RM_ADMIN_PORT; |
| |
| /**Number of threads used to handle RM admin interface.*/ |
| public static final String RM_ADMIN_CLIENT_THREAD_COUNT = |
| RM_PREFIX + "admin.client.thread-count"; |
| public static final int DEFAULT_RM_ADMIN_CLIENT_THREAD_COUNT = 1; |
| |
| /** |
| * The maximum number of application attempts. |
| * It's a global setting for all application masters. |
| */ |
| public static final String RM_AM_MAX_ATTEMPTS = |
| RM_PREFIX + "am.max-attempts"; |
| public static final int DEFAULT_RM_AM_MAX_ATTEMPTS = 2; |
| |
| /** The keytab for the resource manager.*/ |
| public static final String RM_KEYTAB = |
| RM_PREFIX + "keytab"; |
| |
| /**The kerberos principal to be used for spnego filter for RM.*/ |
| public static final String RM_WEBAPP_SPNEGO_USER_NAME_KEY = |
| RM_PREFIX + "webapp.spnego-principal"; |
| |
| /**The kerberos keytab to be used for spnego filter for RM.*/ |
| public static final String RM_WEBAPP_SPNEGO_KEYTAB_FILE_KEY = |
| RM_PREFIX + "webapp.spnego-keytab-file"; |
| |
| /** |
| * Flag to enable override of the default kerberos authentication filter with |
| * the RM authentication filter to allow authentication using delegation |
| * tokens(fallback to kerberos if the tokens are missing). Only applicable |
| * when the http authentication type is kerberos. |
| */ |
| public static final String RM_WEBAPP_DELEGATION_TOKEN_AUTH_FILTER = RM_PREFIX |
| + "webapp.delegation-token-auth-filter.enabled"; |
| public static final boolean DEFAULT_RM_WEBAPP_DELEGATION_TOKEN_AUTH_FILTER = |
| true; |
| |
| /** How long to wait until a container is considered dead.*/ |
| public static final String RM_CONTAINER_ALLOC_EXPIRY_INTERVAL_MS = |
| RM_PREFIX + "rm.container-allocation.expiry-interval-ms"; |
| public static final int DEFAULT_RM_CONTAINER_ALLOC_EXPIRY_INTERVAL_MS = 600000; |
| |
| /** Path to file with nodes to include.*/ |
| public static final String RM_NODES_INCLUDE_FILE_PATH = |
| RM_PREFIX + "nodes.include-path"; |
| public static final String DEFAULT_RM_NODES_INCLUDE_FILE_PATH = ""; |
| |
| /** Path to file with nodes to exclude.*/ |
| public static final String RM_NODES_EXCLUDE_FILE_PATH = |
| RM_PREFIX + "nodes.exclude-path"; |
| public static final String DEFAULT_RM_NODES_EXCLUDE_FILE_PATH = ""; |
| |
| /** Number of threads to handle resource tracker calls.*/ |
| public static final String RM_RESOURCE_TRACKER_CLIENT_THREAD_COUNT = |
| RM_PREFIX + "resource-tracker.client.thread-count"; |
| public static final int DEFAULT_RM_RESOURCE_TRACKER_CLIENT_THREAD_COUNT = 50; |
| |
| /** The class to use as the resource scheduler.*/ |
| public static final String RM_SCHEDULER = |
| RM_PREFIX + "scheduler.class"; |
| |
| public static final String DEFAULT_RM_SCHEDULER = |
| "org.apache.hadoop.yarn.server.resourcemanager.scheduler.capacity.CapacityScheduler"; |
| |
| /** RM set next Heartbeat interval for NM */ |
| public static final String RM_NM_HEARTBEAT_INTERVAL_MS = |
| RM_PREFIX + "nodemanagers.heartbeat-interval-ms"; |
| public static final long DEFAULT_RM_NM_HEARTBEAT_INTERVAL_MS = 1000; |
| |
| /** Number of worker threads that write the history data. */ |
| public static final String RM_HISTORY_WRITER_MULTI_THREADED_DISPATCHER_POOL_SIZE = |
| RM_PREFIX + "history-writer.multi-threaded-dispatcher.pool-size"; |
| public static final int DEFAULT_RM_HISTORY_WRITER_MULTI_THREADED_DISPATCHER_POOL_SIZE = |
| 10; |
| |
| //Delegation token related keys |
| public static final String DELEGATION_KEY_UPDATE_INTERVAL_KEY = |
| RM_PREFIX + "delegation.key.update-interval"; |
| public static final long DELEGATION_KEY_UPDATE_INTERVAL_DEFAULT = |
| 24*60*60*1000; // 1 day |
| public static final String DELEGATION_TOKEN_RENEW_INTERVAL_KEY = |
| RM_PREFIX + "delegation.token.renew-interval"; |
| public static final long DELEGATION_TOKEN_RENEW_INTERVAL_DEFAULT = |
| 24*60*60*1000; // 1 day |
| public static final String DELEGATION_TOKEN_MAX_LIFETIME_KEY = |
| RM_PREFIX + "delegation.token.max-lifetime"; |
| public static final long DELEGATION_TOKEN_MAX_LIFETIME_DEFAULT = |
| 7*24*60*60*1000; // 7 days |
| |
| public static final String RECOVERY_ENABLED = RM_PREFIX + "recovery.enabled"; |
| public static final boolean DEFAULT_RM_RECOVERY_ENABLED = false; |
| |
| @Private |
| public static final String RM_WORK_PRESERVING_RECOVERY_ENABLED = RM_PREFIX |
| + "work-preserving-recovery.enabled"; |
| @Private |
| public static final boolean DEFAULT_RM_WORK_PRESERVING_RECOVERY_ENABLED = |
| false; |
| |
| /** Zookeeper interaction configs */ |
| public static final String RM_ZK_PREFIX = RM_PREFIX + "zk-"; |
| |
| public static final String RM_ZK_ADDRESS = RM_ZK_PREFIX + "address"; |
| |
| public static final String RM_ZK_NUM_RETRIES = RM_ZK_PREFIX + "num-retries"; |
| public static final int DEFAULT_ZK_RM_NUM_RETRIES = 1000; |
| |
| public static final String RM_ZK_RETRY_INTERVAL_MS = |
| RM_ZK_PREFIX + "retry-interval-ms"; |
| public static final long DEFAULT_RM_ZK_RETRY_INTERVAL_MS = 1000; |
| |
| public static final String RM_ZK_TIMEOUT_MS = RM_ZK_PREFIX + "timeout-ms"; |
| public static final int DEFAULT_RM_ZK_TIMEOUT_MS = 10000; |
| |
| public static final String RM_ZK_ACL = RM_ZK_PREFIX + "acl"; |
| public static final String DEFAULT_RM_ZK_ACL = "world:anyone:rwcda"; |
| |
| public static final String RM_ZK_AUTH = RM_ZK_PREFIX + "auth"; |
| |
| public static final String ZK_STATE_STORE_PREFIX = |
| RM_PREFIX + "zk-state-store."; |
| |
| /** Parent znode path under which ZKRMStateStore will create znodes */ |
| public static final String ZK_RM_STATE_STORE_PARENT_PATH = |
| ZK_STATE_STORE_PREFIX + "parent-path"; |
| public static final String DEFAULT_ZK_RM_STATE_STORE_PARENT_PATH = "/rmstore"; |
| |
| /** Root node ACLs for fencing */ |
| public static final String ZK_RM_STATE_STORE_ROOT_NODE_ACL = |
| ZK_STATE_STORE_PREFIX + "root-node.acl"; |
| |
| /** HA related configs */ |
| public static final String RM_HA_PREFIX = RM_PREFIX + "ha."; |
| public static final String RM_HA_ENABLED = RM_HA_PREFIX + "enabled"; |
| public static final boolean DEFAULT_RM_HA_ENABLED = false; |
| |
| public static final String RM_HA_IDS = RM_HA_PREFIX + "rm-ids"; |
| public static final String RM_HA_ID = RM_HA_PREFIX + "id"; |
| |
| /** Store the related configuration files in File System */ |
| public static final String FS_BASED_RM_CONF_STORE = RM_PREFIX |
| + "configuration.file-system-based-store"; |
| public static final String DEFAULT_FS_BASED_RM_CONF_STORE = "/yarn/conf"; |
| |
| public static final String RM_CONFIGURATION_PROVIDER_CLASS = RM_PREFIX |
| + "configuration.provider-class"; |
| public static final String DEFAULT_RM_CONFIGURATION_PROVIDER_CLASS = |
| "org.apache.hadoop.yarn.LocalConfigurationProvider"; |
| |
| private static final List<String> RM_SERVICES_ADDRESS_CONF_KEYS_HTTP = |
| Collections.unmodifiableList(Arrays.asList( |
| RM_ADDRESS, |
| RM_SCHEDULER_ADDRESS, |
| RM_ADMIN_ADDRESS, |
| RM_RESOURCE_TRACKER_ADDRESS, |
| RM_WEBAPP_ADDRESS)); |
| |
| private static final List<String> RM_SERVICES_ADDRESS_CONF_KEYS_HTTPS = |
| Collections.unmodifiableList(Arrays.asList( |
| RM_ADDRESS, |
| RM_SCHEDULER_ADDRESS, |
| RM_ADMIN_ADDRESS, |
| RM_RESOURCE_TRACKER_ADDRESS, |
| RM_WEBAPP_HTTPS_ADDRESS)); |
| |
| public static final String AUTO_FAILOVER_PREFIX = |
| RM_HA_PREFIX + "automatic-failover."; |
| |
| public static final String AUTO_FAILOVER_ENABLED = |
| AUTO_FAILOVER_PREFIX + "enabled"; |
| public static final boolean DEFAULT_AUTO_FAILOVER_ENABLED = true; |
| |
| public static final String AUTO_FAILOVER_EMBEDDED = |
| AUTO_FAILOVER_PREFIX + "embedded"; |
| public static final boolean DEFAULT_AUTO_FAILOVER_EMBEDDED = true; |
| |
| public static final String AUTO_FAILOVER_ZK_BASE_PATH = |
| AUTO_FAILOVER_PREFIX + "zk-base-path"; |
| public static final String DEFAULT_AUTO_FAILOVER_ZK_BASE_PATH = |
| "/yarn-leader-election"; |
| |
| public static final String CLIENT_FAILOVER_PREFIX = |
| YARN_PREFIX + "client.failover-"; |
| public static final String CLIENT_FAILOVER_PROXY_PROVIDER = |
| CLIENT_FAILOVER_PREFIX + "proxy-provider"; |
| public static final String DEFAULT_CLIENT_FAILOVER_PROXY_PROVIDER = |
| "org.apache.hadoop.yarn.client.ConfiguredRMFailoverProxyProvider"; |
| |
| public static final String CLIENT_FAILOVER_MAX_ATTEMPTS = |
| CLIENT_FAILOVER_PREFIX + "max-attempts"; |
| |
| public static final String CLIENT_FAILOVER_SLEEPTIME_BASE_MS = |
| CLIENT_FAILOVER_PREFIX + "sleep-base-ms"; |
| |
| public static final String CLIENT_FAILOVER_SLEEPTIME_MAX_MS = |
| CLIENT_FAILOVER_PREFIX + "sleep-max-ms"; |
| |
| public static final String CLIENT_FAILOVER_RETRIES = |
| CLIENT_FAILOVER_PREFIX + "retries"; |
| public static final int DEFAULT_CLIENT_FAILOVER_RETRIES = 0; |
| |
| public static final String CLIENT_FAILOVER_RETRIES_ON_SOCKET_TIMEOUTS = |
| CLIENT_FAILOVER_PREFIX + "retries-on-socket-timeouts"; |
| public static final int |
| DEFAULT_CLIENT_FAILOVER_RETRIES_ON_SOCKET_TIMEOUTS = 0; |
| |
| //////////////////////////////// |
| // RM state store configs |
| //////////////////////////////// |
| /** The class to use as the persistent store.*/ |
| public static final String RM_STORE = RM_PREFIX + "store.class"; |
| |
| /** URI for FileSystemRMStateStore */ |
| public static final String FS_RM_STATE_STORE_URI = RM_PREFIX |
| + "fs.state-store.uri"; |
| public static final String FS_RM_STATE_STORE_RETRY_POLICY_SPEC = RM_PREFIX |
| + "fs.state-store.retry-policy-spec"; |
| public static final String DEFAULT_FS_RM_STATE_STORE_RETRY_POLICY_SPEC = |
| "2000, 500"; |
| |
| /** The maximum number of completed applications RM keeps. */ |
| public static final String RM_MAX_COMPLETED_APPLICATIONS = |
| RM_PREFIX + "max-completed-applications"; |
| public static final int DEFAULT_RM_MAX_COMPLETED_APPLICATIONS = 10000; |
| |
| /** |
| * The maximum number of completed applications RM state store keeps, by |
| * default equals to DEFAULT_RM_MAX_COMPLETED_APPLICATIONS |
| */ |
| public static final String RM_STATE_STORE_MAX_COMPLETED_APPLICATIONS = |
| RM_PREFIX + "state-store.max-completed-applications"; |
| public static final int DEFAULT_RM_STATE_STORE_MAX_COMPLETED_APPLICATIONS = |
| DEFAULT_RM_MAX_COMPLETED_APPLICATIONS; |
| |
| /** Default application name */ |
| public static final String DEFAULT_APPLICATION_NAME = "N/A"; |
| |
| /** Default application type */ |
| public static final String DEFAULT_APPLICATION_TYPE = "YARN"; |
| |
| /** Default application type length */ |
| public static final int APPLICATION_TYPE_LENGTH = 20; |
| |
| /** Default queue name */ |
| public static final String DEFAULT_QUEUE_NAME = "default"; |
| |
| /** |
| * Buckets (in minutes) for the number of apps running in each queue. |
| */ |
| public static final String RM_METRICS_RUNTIME_BUCKETS = |
| RM_PREFIX + "metrics.runtime.buckets"; |
| |
| /** |
| * Default sizes of the runtime metric buckets in minutes. |
| */ |
| public static final String DEFAULT_RM_METRICS_RUNTIME_BUCKETS = |
| "60,300,1440"; |
| |
| public static final String RM_AMRM_TOKEN_MASTER_KEY_ROLLING_INTERVAL_SECS = RM_PREFIX |
| + "am-rm-tokens.master-key-rolling-interval-secs"; |
| |
| public static final long DEFAULT_RM_AMRM_TOKEN_MASTER_KEY_ROLLING_INTERVAL_SECS = |
| 24 * 60 * 60; |
| |
| public static final String RM_CONTAINER_TOKEN_MASTER_KEY_ROLLING_INTERVAL_SECS = |
| RM_PREFIX + "container-tokens.master-key-rolling-interval-secs"; |
| |
| public static final long DEFAULT_RM_CONTAINER_TOKEN_MASTER_KEY_ROLLING_INTERVAL_SECS = |
| 24 * 60 * 60; |
| |
| public static final String RM_NMTOKEN_MASTER_KEY_ROLLING_INTERVAL_SECS = |
| RM_PREFIX + "nm-tokens.master-key-rolling-interval-secs"; |
| |
| public static final long DEFAULT_RM_NMTOKEN_MASTER_KEY_ROLLING_INTERVAL_SECS = |
| 24 * 60 * 60; |
| |
| public static final String RM_NODEMANAGER_MINIMUM_VERSION = |
| RM_PREFIX + "nodemanager.minimum.version"; |
| |
| public static final String DEFAULT_RM_NODEMANAGER_MINIMUM_VERSION = |
| "NONE"; |
| |
| //////////////////////////////// |
| // Node Manager Configs |
| //////////////////////////////// |
| |
| /** Prefix for all node manager configs.*/ |
| public static final String NM_PREFIX = "yarn.nodemanager."; |
| |
| /** Environment variables that will be sent to containers.*/ |
| public static final String NM_ADMIN_USER_ENV = NM_PREFIX + "admin-env"; |
| public static final String DEFAULT_NM_ADMIN_USER_ENV = "MALLOC_ARENA_MAX=$MALLOC_ARENA_MAX"; |
| |
| /** Environment variables that containers may override rather than use NodeManager's default.*/ |
| public static final String NM_ENV_WHITELIST = NM_PREFIX + "env-whitelist"; |
| public static final String DEFAULT_NM_ENV_WHITELIST = StringUtils.join(",", |
| Arrays.asList(ApplicationConstants.Environment.JAVA_HOME.key(), |
| ApplicationConstants.Environment.HADOOP_COMMON_HOME.key(), |
| ApplicationConstants.Environment.HADOOP_HDFS_HOME.key(), |
| ApplicationConstants.Environment.HADOOP_CONF_DIR.key(), |
| ApplicationConstants.Environment.HADOOP_YARN_HOME.key())); |
| |
| /** address of node manager IPC.*/ |
| public static final String NM_ADDRESS = NM_PREFIX + "address"; |
| public static final int DEFAULT_NM_PORT = 0; |
| public static final String DEFAULT_NM_ADDRESS = "0.0.0.0:" |
| + DEFAULT_NM_PORT; |
| |
| /** The actual bind address or the NM.*/ |
| public static final String NM_BIND_HOST = |
| NM_PREFIX + "bind-host"; |
| |
| /** who will execute(launch) the containers.*/ |
| public static final String NM_CONTAINER_EXECUTOR = |
| NM_PREFIX + "container-executor.class"; |
| |
| /** |
| * Adjustment to make to the container os scheduling priority. |
| * The valid values for this could vary depending on the platform. |
| * On Linux, higher values mean run the containers at a less |
| * favorable priority than the NM. |
| * The value specified is an int. |
| */ |
| public static final String NM_CONTAINER_EXECUTOR_SCHED_PRIORITY = |
| NM_PREFIX + "container-executor.os.sched.priority.adjustment"; |
| public static final int DEFAULT_NM_CONTAINER_EXECUTOR_SCHED_PRIORITY = 0; |
| |
| /** Number of threads container manager uses.*/ |
| public static final String NM_CONTAINER_MGR_THREAD_COUNT = |
| NM_PREFIX + "container-manager.thread-count"; |
| public static final int DEFAULT_NM_CONTAINER_MGR_THREAD_COUNT = 20; |
| |
| /** Number of threads used in cleanup.*/ |
| public static final String NM_DELETE_THREAD_COUNT = |
| NM_PREFIX + "delete.thread-count"; |
| public static final int DEFAULT_NM_DELETE_THREAD_COUNT = 4; |
| |
| /** Keytab for NM.*/ |
| public static final String NM_KEYTAB = NM_PREFIX + "keytab"; |
| |
| /**List of directories to store localized files in.*/ |
| public static final String NM_LOCAL_DIRS = NM_PREFIX + "local-dirs"; |
| public static final String DEFAULT_NM_LOCAL_DIRS = "/tmp/nm-local-dir"; |
| |
| /** |
| * Number of files in each localized directories |
| * Avoid tuning this too low. |
| */ |
| public static final String NM_LOCAL_CACHE_MAX_FILES_PER_DIRECTORY = |
| NM_PREFIX + "local-cache.max-files-per-directory"; |
| public static final int DEFAULT_NM_LOCAL_CACHE_MAX_FILES_PER_DIRECTORY = 8192; |
| |
| /** Address where the localizer IPC is.*/ |
| public static final String NM_LOCALIZER_ADDRESS = |
| NM_PREFIX + "localizer.address"; |
| public static final int DEFAULT_NM_LOCALIZER_PORT = 8040; |
| public static final String DEFAULT_NM_LOCALIZER_ADDRESS = "0.0.0.0:" + |
| DEFAULT_NM_LOCALIZER_PORT; |
| |
| /** Interval in between cache cleanups.*/ |
| public static final String NM_LOCALIZER_CACHE_CLEANUP_INTERVAL_MS = |
| NM_PREFIX + "localizer.cache.cleanup.interval-ms"; |
| public static final long DEFAULT_NM_LOCALIZER_CACHE_CLEANUP_INTERVAL_MS = |
| 10 * 60 * 1000; |
| |
| /** |
| * Target size of localizer cache in MB, per nodemanager. It is a target |
| * retention size that only includes resources with PUBLIC and PRIVATE |
| * visibility and excludes resources with APPLICATION visibility |
| */ |
| public static final String NM_LOCALIZER_CACHE_TARGET_SIZE_MB = |
| NM_PREFIX + "localizer.cache.target-size-mb"; |
| public static final long DEFAULT_NM_LOCALIZER_CACHE_TARGET_SIZE_MB = 10 * 1024; |
| |
| /** Number of threads to handle localization requests.*/ |
| public static final String NM_LOCALIZER_CLIENT_THREAD_COUNT = |
| NM_PREFIX + "localizer.client.thread-count"; |
| public static final int DEFAULT_NM_LOCALIZER_CLIENT_THREAD_COUNT = 5; |
| |
| /** Number of threads to use for localization fetching.*/ |
| public static final String NM_LOCALIZER_FETCH_THREAD_COUNT = |
| NM_PREFIX + "localizer.fetch.thread-count"; |
| public static final int DEFAULT_NM_LOCALIZER_FETCH_THREAD_COUNT = 4; |
| |
| /** Where to store container logs.*/ |
| public static final String NM_LOG_DIRS = NM_PREFIX + "log-dirs"; |
| public static final String DEFAULT_NM_LOG_DIRS = "/tmp/logs"; |
| |
| public static final String NM_RESOURCEMANAGER_MINIMUM_VERSION = |
| NM_PREFIX + "resourcemanager.minimum.version"; |
| public static final String DEFAULT_NM_RESOURCEMANAGER_MINIMUM_VERSION = "NONE"; |
| |
| /** Interval at which the delayed token removal thread runs */ |
| public static final String RM_DELAYED_DELEGATION_TOKEN_REMOVAL_INTERVAL_MS = |
| RM_PREFIX + "delayed.delegation-token.removal-interval-ms"; |
| public static final long DEFAULT_RM_DELAYED_DELEGATION_TOKEN_REMOVAL_INTERVAL_MS = |
| 30000l; |
| |
| /** Delegation Token renewer thread count */ |
| public static final String RM_DELEGATION_TOKEN_RENEWER_THREAD_COUNT = |
| RM_PREFIX + "delegation-token-renewer.thread-count"; |
| public static final int DEFAULT_RM_DELEGATION_TOKEN_RENEWER_THREAD_COUNT = 50; |
| |
| /** Whether to enable log aggregation */ |
| public static final String LOG_AGGREGATION_ENABLED = YARN_PREFIX |
| + "log-aggregation-enable"; |
| public static final boolean DEFAULT_LOG_AGGREGATION_ENABLED = false; |
| |
| /** |
| * How long to wait before deleting aggregated logs, -1 disables. |
| * Be careful set this too small and you will spam the name node. |
| */ |
| public static final String LOG_AGGREGATION_RETAIN_SECONDS = YARN_PREFIX |
| + "log-aggregation.retain-seconds"; |
| public static final long DEFAULT_LOG_AGGREGATION_RETAIN_SECONDS = -1; |
| |
| /** |
| * How long to wait between aggregated log retention checks. If set to |
| * a value <= 0 then the value is computed as one-tenth of the log retention |
| * setting. Be careful set this too small and you will spam the name node. |
| */ |
| public static final String LOG_AGGREGATION_RETAIN_CHECK_INTERVAL_SECONDS = |
| YARN_PREFIX + "log-aggregation.retain-check-interval-seconds"; |
| public static final long DEFAULT_LOG_AGGREGATION_RETAIN_CHECK_INTERVAL_SECONDS = -1; |
| |
| /** |
| * Number of seconds to retain logs on the NodeManager. Only applicable if Log |
| * aggregation is disabled |
| */ |
| public static final String NM_LOG_RETAIN_SECONDS = NM_PREFIX |
| + "log.retain-seconds"; |
| public static final long DEFAULT_NM_LOG_RETAIN_SECONDS = 3 * 60 * 60; |
| |
| /** |
| * Number of threads used in log cleanup. Only applicable if Log aggregation |
| * is disabled |
| */ |
| public static final String NM_LOG_DELETION_THREADS_COUNT = |
| NM_PREFIX + "log.deletion-threads-count"; |
| public static final int DEFAULT_NM_LOG_DELETE_THREAD_COUNT = 4; |
| |
| /** Where to aggregate logs to.*/ |
| public static final String NM_REMOTE_APP_LOG_DIR = |
| NM_PREFIX + "remote-app-log-dir"; |
| public static final String DEFAULT_NM_REMOTE_APP_LOG_DIR = "/tmp/logs"; |
| |
| /** |
| * The remote log dir will be created at |
| * NM_REMOTE_APP_LOG_DIR/${user}/NM_REMOTE_APP_LOG_DIR_SUFFIX/${appId} |
| */ |
| public static final String NM_REMOTE_APP_LOG_DIR_SUFFIX = |
| NM_PREFIX + "remote-app-log-dir-suffix"; |
| public static final String DEFAULT_NM_REMOTE_APP_LOG_DIR_SUFFIX="logs"; |
| |
| public static final String YARN_LOG_SERVER_URL = |
| YARN_PREFIX + "log.server.url"; |
| |
| public static final String YARN_TRACKING_URL_GENERATOR = |
| YARN_PREFIX + "tracking.url.generator"; |
| |
| /** Amount of memory in GB that can be allocated for containers.*/ |
| public static final String NM_PMEM_MB = NM_PREFIX + "resource.memory-mb"; |
| public static final int DEFAULT_NM_PMEM_MB = 8 * 1024; |
| |
| /** Specifies whether physical memory check is enabled. */ |
| public static final String NM_PMEM_CHECK_ENABLED = NM_PREFIX |
| + "pmem-check-enabled"; |
| public static final boolean DEFAULT_NM_PMEM_CHECK_ENABLED = true; |
| |
| /** Specifies whether physical memory check is enabled. */ |
| public static final String NM_VMEM_CHECK_ENABLED = NM_PREFIX |
| + "vmem-check-enabled"; |
| public static final boolean DEFAULT_NM_VMEM_CHECK_ENABLED = true; |
| |
| /** Conversion ratio for physical memory to virtual memory. */ |
| public static final String NM_VMEM_PMEM_RATIO = |
| NM_PREFIX + "vmem-pmem-ratio"; |
| public static final float DEFAULT_NM_VMEM_PMEM_RATIO = 2.1f; |
| |
| /** Number of Virtual CPU Cores which can be allocated for containers.*/ |
| public static final String NM_VCORES = NM_PREFIX + "resource.cpu-vcores"; |
| public static final int DEFAULT_NM_VCORES = 8; |
| |
| /** NM Webapp address.**/ |
| public static final String NM_WEBAPP_ADDRESS = NM_PREFIX + "webapp.address"; |
| public static final int DEFAULT_NM_WEBAPP_PORT = 8042; |
| public static final String DEFAULT_NM_WEBAPP_ADDRESS = "0.0.0.0:" + |
| DEFAULT_NM_WEBAPP_PORT; |
| |
| /** NM Webapp https address.**/ |
| public static final String NM_WEBAPP_HTTPS_ADDRESS = NM_PREFIX |
| + "webapp.https.address"; |
| public static final int DEFAULT_NM_WEBAPP_HTTPS_PORT = 8044; |
| public static final String DEFAULT_NM_WEBAPP_HTTPS_ADDRESS = "0.0.0.0:" |
| + DEFAULT_NM_WEBAPP_HTTPS_PORT; |
| |
| /** How often to monitor containers.*/ |
| public final static String NM_CONTAINER_MON_INTERVAL_MS = |
| NM_PREFIX + "container-monitor.interval-ms"; |
| public final static int DEFAULT_NM_CONTAINER_MON_INTERVAL_MS = 3000; |
| |
| /** Class that calculates containers current resource utilization.*/ |
| public static final String NM_CONTAINER_MON_RESOURCE_CALCULATOR = |
| NM_PREFIX + "container-monitor.resource-calculator.class"; |
| /** Class that calculates process tree resource utilization.*/ |
| public static final String NM_CONTAINER_MON_PROCESS_TREE = |
| NM_PREFIX + "container-monitor.process-tree.class"; |
| public static final String PROCFS_USE_SMAPS_BASED_RSS_ENABLED = NM_PREFIX + |
| ".container-monitor.procfs-tree.smaps-based-rss.enabled"; |
| public static final boolean DEFAULT_PROCFS_USE_SMAPS_BASED_RSS_ENABLED = |
| false; |
| |
| /** Prefix for all node manager disk health checker configs. */ |
| private static final String NM_DISK_HEALTH_CHECK_PREFIX = |
| "yarn.nodemanager.disk-health-checker."; |
| /** |
| * Enable/Disable disks' health checker. Default is true. An expert level |
| * configuration property. |
| */ |
| public static final String NM_DISK_HEALTH_CHECK_ENABLE = |
| NM_DISK_HEALTH_CHECK_PREFIX + "enable"; |
| /** Frequency of running disks' health checker. */ |
| public static final String NM_DISK_HEALTH_CHECK_INTERVAL_MS = |
| NM_DISK_HEALTH_CHECK_PREFIX + "interval-ms"; |
| /** By default, disks' health is checked every 2 minutes. */ |
| public static final long DEFAULT_NM_DISK_HEALTH_CHECK_INTERVAL_MS = |
| 2 * 60 * 1000; |
| |
| /** |
| * The minimum fraction of number of disks to be healthy for the nodemanager |
| * to launch new containers. This applies to nm-local-dirs and nm-log-dirs. |
| */ |
| public static final String NM_MIN_HEALTHY_DISKS_FRACTION = |
| NM_DISK_HEALTH_CHECK_PREFIX + "min-healthy-disks"; |
| /** |
| * By default, at least 25% of disks are to be healthy to say that the node is |
| * healthy in terms of disks. |
| */ |
| public static final float DEFAULT_NM_MIN_HEALTHY_DISKS_FRACTION = 0.25F; |
| |
| /** |
| * The maximum percentage of disk space that can be used after which a disk is |
| * marked as offline. Values can range from 0.0 to 100.0. If the value is |
| * greater than or equal to 100, NM will check for full disk. This applies to |
| * nm-local-dirs and nm-log-dirs. |
| */ |
| public static final String NM_MAX_PER_DISK_UTILIZATION_PERCENTAGE = |
| NM_DISK_HEALTH_CHECK_PREFIX + "max-disk-utilization-per-disk-percentage"; |
| /** |
| * By default, 100% of the disk can be used before it is marked as offline. |
| */ |
| public static final float DEFAULT_NM_MAX_PER_DISK_UTILIZATION_PERCENTAGE = |
| 100.0F; |
| |
| /** |
| * The minimum space that must be available on a local dir for it to be used. |
| * This applies to nm-local-dirs and nm-log-dirs. |
| */ |
| public static final String NM_MIN_PER_DISK_FREE_SPACE_MB = |
| NM_DISK_HEALTH_CHECK_PREFIX + "min-free-space-per-disk-mb"; |
| /** |
| * By default, all of the disk can be used before it is marked as offline. |
| */ |
| public static final long DEFAULT_NM_MIN_PER_DISK_FREE_SPACE_MB = 0; |
| |
| /** Frequency of running node health script.*/ |
| public static final String NM_HEALTH_CHECK_INTERVAL_MS = |
| NM_PREFIX + "health-checker.interval-ms"; |
| public static final long DEFAULT_NM_HEALTH_CHECK_INTERVAL_MS = 10 * 60 * 1000; |
| |
| /** Health check script time out period.*/ |
| public static final String NM_HEALTH_CHECK_SCRIPT_TIMEOUT_MS = |
| NM_PREFIX + "health-checker.script.timeout-ms"; |
| public static final long DEFAULT_NM_HEALTH_CHECK_SCRIPT_TIMEOUT_MS = |
| 2 * DEFAULT_NM_HEALTH_CHECK_INTERVAL_MS; |
| |
| /** The health check script to run.*/ |
| public static final String NM_HEALTH_CHECK_SCRIPT_PATH = |
| NM_PREFIX + "health-checker.script.path"; |
| |
| /** The arguments to pass to the health check script.*/ |
| public static final String NM_HEALTH_CHECK_SCRIPT_OPTS = |
| NM_PREFIX + "health-checker.script.opts"; |
| |
| /** The path to the Linux container executor.*/ |
| public static final String NM_LINUX_CONTAINER_EXECUTOR_PATH = |
| NM_PREFIX + "linux-container-executor.path"; |
| |
| /** |
| * The UNIX group that the linux-container-executor should run as. |
| * This is intended to be set as part of container-executor.cfg. |
| */ |
| public static final String NM_LINUX_CONTAINER_GROUP = |
| NM_PREFIX + "linux-container-executor.group"; |
| |
| /** |
| * True if linux-container-executor should limit itself to one user |
| * when running in non-secure mode. |
| */ |
| public static final String NM_NONSECURE_MODE_LIMIT_USERS = NM_PREFIX + |
| "linux-container-executor.nonsecure-mode.limit-users"; |
| |
| public static final boolean DEFAULT_NM_NONSECURE_MODE_LIMIT_USERS = true; |
| |
| /** |
| * The UNIX user that containers will run as when Linux-container-executor |
| * is used in nonsecure mode (a use case for this is using cgroups). |
| */ |
| public static final String NM_NONSECURE_MODE_LOCAL_USER_KEY = NM_PREFIX + |
| "linux-container-executor.nonsecure-mode.local-user"; |
| |
| public static final String DEFAULT_NM_NONSECURE_MODE_LOCAL_USER = "nobody"; |
| |
| /** |
| * The allowed pattern for UNIX user names enforced by |
| * Linux-container-executor when used in nonsecure mode (use case for this |
| * is using cgroups). The default value is taken from /usr/sbin/adduser |
| */ |
| public static final String NM_NONSECURE_MODE_USER_PATTERN_KEY = NM_PREFIX + |
| "linux-container-executor.nonsecure-mode.user-pattern"; |
| |
| public static final String DEFAULT_NM_NONSECURE_MODE_USER_PATTERN = |
| "^[_.A-Za-z0-9][-@_.A-Za-z0-9]{0,255}?[$]?$"; |
| |
| /** The type of resource enforcement to use with the |
| * linux container executor. |
| */ |
| public static final String NM_LINUX_CONTAINER_RESOURCES_HANDLER = |
| NM_PREFIX + "linux-container-executor.resources-handler.class"; |
| |
| /** The path the linux container executor should use for cgroups */ |
| public static final String NM_LINUX_CONTAINER_CGROUPS_HIERARCHY = |
| NM_PREFIX + "linux-container-executor.cgroups.hierarchy"; |
| |
| /** Whether the linux container executor should mount cgroups if not found */ |
| public static final String NM_LINUX_CONTAINER_CGROUPS_MOUNT = |
| NM_PREFIX + "linux-container-executor.cgroups.mount"; |
| |
| /** Where the linux container executor should mount cgroups if not found */ |
| public static final String NM_LINUX_CONTAINER_CGROUPS_MOUNT_PATH = |
| NM_PREFIX + "linux-container-executor.cgroups.mount-path"; |
| |
| |
| /** |
| * Interval of time the linux container executor should try cleaning up |
| * cgroups entry when cleaning up a container. This is required due to what |
| * it seems a race condition because the SIGTERM/SIGKILL is asynch. |
| */ |
| public static final String NM_LINUX_CONTAINER_CGROUPS_DELETE_TIMEOUT = |
| NM_PREFIX + "linux-container-executor.cgroups.delete-timeout-ms"; |
| |
| public static final long DEFAULT_NM_LINUX_CONTAINER_CGROUPS_DELETE_TIMEOUT = |
| 1000; |
| |
| /** T-file compression types used to compress aggregated logs.*/ |
| public static final String NM_LOG_AGG_COMPRESSION_TYPE = |
| NM_PREFIX + "log-aggregation.compression-type"; |
| public static final String DEFAULT_NM_LOG_AGG_COMPRESSION_TYPE = "none"; |
| |
| /** The kerberos principal for the node manager.*/ |
| public static final String NM_PRINCIPAL = |
| NM_PREFIX + "principal"; |
| |
| public static final String NM_AUX_SERVICES = |
| NM_PREFIX + "aux-services"; |
| |
| public static final String NM_AUX_SERVICE_FMT = |
| NM_PREFIX + "aux-services.%s.class"; |
| |
| public static final String NM_USER_HOME_DIR = |
| NM_PREFIX + "user-home-dir"; |
| |
| /**The kerberos principal to be used for spnego filter for NM.*/ |
| public static final String NM_WEBAPP_SPNEGO_USER_NAME_KEY = |
| NM_PREFIX + "webapp.spnego-principal"; |
| |
| /**The kerberos keytab to be used for spnego filter for NM.*/ |
| public static final String NM_WEBAPP_SPNEGO_KEYTAB_FILE_KEY = |
| NM_PREFIX + "webapp.spnego-keytab-file"; |
| |
| public static final String DEFAULT_NM_USER_HOME_DIR= "/home/"; |
| |
| public static final String NM_RECOVERY_PREFIX = NM_PREFIX + "recovery."; |
| public static final String NM_RECOVERY_ENABLED = |
| NM_RECOVERY_PREFIX + "enabled"; |
| public static final boolean DEFAULT_NM_RECOVERY_ENABLED = false; |
| |
| public static final String NM_RECOVERY_DIR = NM_RECOVERY_PREFIX + "dir"; |
| |
| //////////////////////////////// |
| // Web Proxy Configs |
| //////////////////////////////// |
| public static final String PROXY_PREFIX = "yarn.web-proxy."; |
| |
| /** The kerberos principal for the proxy.*/ |
| public static final String PROXY_PRINCIPAL = |
| PROXY_PREFIX + "principal"; |
| |
| /** Keytab for Proxy.*/ |
| public static final String PROXY_KEYTAB = PROXY_PREFIX + "keytab"; |
| |
| /** The address for the web proxy.*/ |
| public static final String PROXY_ADDRESS = |
| PROXY_PREFIX + "address"; |
| public static final int DEFAULT_PROXY_PORT = 9099; |
| public static final String DEFAULT_PROXY_ADDRESS = |
| "0.0.0.0:" + DEFAULT_PROXY_PORT; |
| |
| /** |
| * YARN Service Level Authorization |
| */ |
| public static final String |
| YARN_SECURITY_SERVICE_AUTHORIZATION_RESOURCETRACKER_PROTOCOL = |
| "security.resourcetracker.protocol.acl"; |
| public static final String |
| YARN_SECURITY_SERVICE_AUTHORIZATION_APPLICATIONCLIENT_PROTOCOL = |
| "security.applicationclient.protocol.acl"; |
| public static final String |
| YARN_SECURITY_SERVICE_AUTHORIZATION_RESOURCEMANAGER_ADMINISTRATION_PROTOCOL = |
| "security.resourcemanager-administration.protocol.acl"; |
| public static final String |
| YARN_SECURITY_SERVICE_AUTHORIZATION_APPLICATIONMASTER_PROTOCOL = |
| "security.applicationmaster.protocol.acl"; |
| |
| public static final String |
| YARN_SECURITY_SERVICE_AUTHORIZATION_CONTAINER_MANAGEMENT_PROTOCOL = |
| "security.containermanagement.protocol.acl"; |
| public static final String |
| YARN_SECURITY_SERVICE_AUTHORIZATION_RESOURCE_LOCALIZER = |
| "security.resourcelocalizer.protocol.acl"; |
| |
| /** No. of milliseconds to wait between sending a SIGTERM and SIGKILL |
| * to a running container */ |
| public static final String NM_SLEEP_DELAY_BEFORE_SIGKILL_MS = |
| NM_PREFIX + "sleep-delay-before-sigkill.ms"; |
| public static final long DEFAULT_NM_SLEEP_DELAY_BEFORE_SIGKILL_MS = |
| 250; |
| |
| /** Max time to wait for a process to come up when trying to cleanup |
| * container resources */ |
| public static final String NM_PROCESS_KILL_WAIT_MS = |
| NM_PREFIX + "process-kill-wait.ms"; |
| public static final long DEFAULT_NM_PROCESS_KILL_WAIT_MS = |
| 2000; |
| |
| /** Max time to wait to establish a connection to RM */ |
| public static final String RESOURCEMANAGER_CONNECT_MAX_WAIT_MS = |
| RM_PREFIX + "connect.max-wait.ms"; |
| public static final int DEFAULT_RESOURCEMANAGER_CONNECT_MAX_WAIT_MS = |
| 15 * 60 * 1000; |
| |
| /** Time interval between each attempt to connect to RM */ |
| public static final String RESOURCEMANAGER_CONNECT_RETRY_INTERVAL_MS = |
| RM_PREFIX + "connect.retry-interval.ms"; |
| public static final long DEFAULT_RESOURCEMANAGER_CONNECT_RETRY_INTERVAL_MS |
| = 30 * 1000; |
| |
| /** |
| * CLASSPATH for YARN applications. A comma-separated list of CLASSPATH |
| * entries |
| */ |
| public static final String YARN_APPLICATION_CLASSPATH = YARN_PREFIX |
| + "application.classpath"; |
| |
| /** |
| * Default platform-agnostic CLASSPATH for YARN applications. A |
| * comma-separated list of CLASSPATH entries. The parameter expansion marker |
| * will be replaced with real parameter expansion marker ('%' for Windows and |
| * '$' for Linux) by NodeManager on container launch. For example: {{VAR}} |
| * will be replaced as $VAR on Linux, and %VAR% on Windows. |
| */ |
| @Public |
| @Unstable |
| public static final String[] DEFAULT_YARN_CROSS_PLATFORM_APPLICATION_CLASSPATH= { |
| ApplicationConstants.Environment.HADOOP_CONF_DIR.$$(), |
| ApplicationConstants.Environment.HADOOP_COMMON_HOME.$$() |
| + "/share/hadoop/common/*", |
| ApplicationConstants.Environment.HADOOP_COMMON_HOME.$$() |
| + "/share/hadoop/common/lib/*", |
| ApplicationConstants.Environment.HADOOP_HDFS_HOME.$$() |
| + "/share/hadoop/hdfs/*", |
| ApplicationConstants.Environment.HADOOP_HDFS_HOME.$$() |
| + "/share/hadoop/hdfs/lib/*", |
| ApplicationConstants.Environment.HADOOP_YARN_HOME.$$() |
| + "/share/hadoop/yarn/*", |
| ApplicationConstants.Environment.HADOOP_YARN_HOME.$$() |
| + "/share/hadoop/yarn/lib/*" }; |
| /** |
| * <p> |
| * Default platform-specific CLASSPATH for YARN applications. A |
| * comma-separated list of CLASSPATH entries constructed based on the client |
| * OS environment expansion syntax. |
| * </p> |
| * <p> |
| * Note: Use {@link DEFAULT_YARN_CROSS_PLATFORM_APPLICATION_CLASSPATH} for |
| * cross-platform practice i.e. submit an application from a Windows client to |
| * a Linux/Unix server or vice versa. |
| * </p> |
| */ |
| public static final String[] DEFAULT_YARN_APPLICATION_CLASSPATH = { |
| ApplicationConstants.Environment.HADOOP_CONF_DIR.$(), |
| ApplicationConstants.Environment.HADOOP_COMMON_HOME.$() |
| + "/share/hadoop/common/*", |
| ApplicationConstants.Environment.HADOOP_COMMON_HOME.$() |
| + "/share/hadoop/common/lib/*", |
| ApplicationConstants.Environment.HADOOP_HDFS_HOME.$() |
| + "/share/hadoop/hdfs/*", |
| ApplicationConstants.Environment.HADOOP_HDFS_HOME.$() |
| + "/share/hadoop/hdfs/lib/*", |
| ApplicationConstants.Environment.HADOOP_YARN_HOME.$() |
| + "/share/hadoop/yarn/*", |
| ApplicationConstants.Environment.HADOOP_YARN_HOME.$() |
| + "/share/hadoop/yarn/lib/*" }; |
| |
| /** Container temp directory */ |
| public static final String DEFAULT_CONTAINER_TEMP_DIR = "./tmp"; |
| |
| public static final String IS_MINI_YARN_CLUSTER = YARN_PREFIX |
| + "is.minicluster"; |
| |
| public static final String YARN_MC_PREFIX = YARN_PREFIX + "minicluster."; |
| |
| /** Whether to use fixed ports with the minicluster. */ |
| public static final String YARN_MINICLUSTER_FIXED_PORTS = |
| YARN_MC_PREFIX + "fixed.ports"; |
| |
| /** |
| * Default is false to be able to run tests concurrently without port |
| * conflicts. |
| */ |
| public static final boolean DEFAULT_YARN_MINICLUSTER_FIXED_PORTS = false; |
| |
| /** |
| * Whether the NM should use RPC to connect to the RM. Default is false. |
| * Can be set to true only when using fixed ports. |
| */ |
| public static final String YARN_MINICLUSTER_USE_RPC = YARN_MC_PREFIX + "use-rpc"; |
| public static final boolean DEFAULT_YARN_MINICLUSTER_USE_RPC = false; |
| |
| /** |
| * Whether users are explicitly trying to control resource monitoring |
| * configuration for the MiniYARNCluster. Disabled by default. |
| */ |
| public static final String YARN_MINICLUSTER_CONTROL_RESOURCE_MONITORING = |
| YARN_MC_PREFIX + "control-resource-monitoring"; |
| public static final boolean |
| DEFAULT_YARN_MINICLUSTER_CONTROL_RESOURCE_MONITORING = false; |
| |
| /** The log directory for the containers */ |
| public static final String YARN_APP_CONTAINER_LOG_DIR = |
| YARN_PREFIX + "app.container.log.dir"; |
| |
| public static final String YARN_APP_CONTAINER_LOG_SIZE = |
| YARN_PREFIX + "app.container.log.filesize"; |
| |
| public static final String YARN_APP_CONTAINER_LOG_BACKUPS = |
| YARN_PREFIX + "app.container.log.backups"; |
| |
| //////////////////////////////// |
| // Timeline Service Configs |
| //////////////////////////////// |
| |
| public static final String TIMELINE_SERVICE_PREFIX = |
| YARN_PREFIX + "timeline-service."; |
| |
| |
| // mark app-history related configs @Private as application history is going |
| // to be integrated into the timeline service |
| @Private |
| public static final String APPLICATION_HISTORY_PREFIX = |
| TIMELINE_SERVICE_PREFIX + "generic-application-history."; |
| |
| /** |
| * The setting that controls whether application history service is |
| * enabled or not. |
| */ |
| @Private |
| public static final String APPLICATION_HISTORY_ENABLED = |
| APPLICATION_HISTORY_PREFIX + "enabled"; |
| @Private |
| public static final boolean DEFAULT_APPLICATION_HISTORY_ENABLED = false; |
| |
| /** Application history store class */ |
| @Private |
| public static final String APPLICATION_HISTORY_STORE = |
| APPLICATION_HISTORY_PREFIX + "store-class"; |
| |
| /** URI for FileSystemApplicationHistoryStore */ |
| @Private |
| public static final String FS_APPLICATION_HISTORY_STORE_URI = |
| APPLICATION_HISTORY_PREFIX + "fs-history-store.uri"; |
| |
| /** T-file compression types used to compress history data.*/ |
| @Private |
| public static final String FS_APPLICATION_HISTORY_STORE_COMPRESSION_TYPE = |
| APPLICATION_HISTORY_PREFIX + "fs-history-store.compression-type"; |
| @Private |
| public static final String DEFAULT_FS_APPLICATION_HISTORY_STORE_COMPRESSION_TYPE = |
| "none"; |
| |
| /** The setting that controls whether timeline service is enabled or not. */ |
| public static final String TIMELINE_SERVICE_ENABLED = |
| TIMELINE_SERVICE_PREFIX + "enabled"; |
| public static final boolean DEFAULT_TIMELINE_SERVICE_ENABLED = false; |
| |
| /** host:port address for timeline service RPC APIs. */ |
| public static final String TIMELINE_SERVICE_ADDRESS = |
| TIMELINE_SERVICE_PREFIX + "address"; |
| public static final int DEFAULT_TIMELINE_SERVICE_PORT = 10200; |
| public static final String DEFAULT_TIMELINE_SERVICE_ADDRESS = "0.0.0.0:" |
| + DEFAULT_TIMELINE_SERVICE_PORT; |
| |
| /** The listening endpoint for the timeline service application.*/ |
| public static final String TIMELINE_SERVICE_BIND_HOST = |
| TIMELINE_SERVICE_PREFIX + "bind-host"; |
| |
| /** The number of threads to handle client RPC API requests. */ |
| public static final String TIMELINE_SERVICE_HANDLER_THREAD_COUNT = |
| TIMELINE_SERVICE_PREFIX + "handler-thread-count"; |
| public static final int DEFAULT_TIMELINE_SERVICE_CLIENT_THREAD_COUNT = 10; |
| |
| |
| /** The address of the timeline service web application.*/ |
| public static final String TIMELINE_SERVICE_WEBAPP_ADDRESS = |
| TIMELINE_SERVICE_PREFIX + "webapp.address"; |
| |
| public static final int DEFAULT_TIMELINE_SERVICE_WEBAPP_PORT = 8188; |
| public static final String DEFAULT_TIMELINE_SERVICE_WEBAPP_ADDRESS = |
| "0.0.0.0:" + DEFAULT_TIMELINE_SERVICE_WEBAPP_PORT; |
| |
| /** The https address of the timeline service web application.*/ |
| public static final String TIMELINE_SERVICE_WEBAPP_HTTPS_ADDRESS = |
| TIMELINE_SERVICE_PREFIX + "webapp.https.address"; |
| |
| public static final int DEFAULT_TIMELINE_SERVICE_WEBAPP_HTTPS_PORT = 8190; |
| public static final String DEFAULT_TIMELINE_SERVICE_WEBAPP_HTTPS_ADDRESS = |
| "0.0.0.0:" + DEFAULT_TIMELINE_SERVICE_WEBAPP_HTTPS_PORT; |
| |
| /** Timeline service store class */ |
| public static final String TIMELINE_SERVICE_STORE = |
| TIMELINE_SERVICE_PREFIX + "store-class"; |
| |
| /** Timeline service enable data age off */ |
| public static final String TIMELINE_SERVICE_TTL_ENABLE = |
| TIMELINE_SERVICE_PREFIX + "ttl-enable"; |
| |
| /** Timeline service length of time to retain data */ |
| public static final String TIMELINE_SERVICE_TTL_MS = |
| TIMELINE_SERVICE_PREFIX + "ttl-ms"; |
| |
| public static final long DEFAULT_TIMELINE_SERVICE_TTL_MS = |
| 1000 * 60 * 60 * 24 * 7; |
| |
| public static final String TIMELINE_SERVICE_LEVELDB_PREFIX = |
| TIMELINE_SERVICE_PREFIX + "leveldb-timeline-store."; |
| |
| /** Timeline service leveldb path */ |
| public static final String TIMELINE_SERVICE_LEVELDB_PATH = |
| TIMELINE_SERVICE_LEVELDB_PREFIX + "path"; |
| |
| /** Timeline service leveldb read cache (uncompressed blocks) */ |
| public static final String TIMELINE_SERVICE_LEVELDB_READ_CACHE_SIZE = |
| TIMELINE_SERVICE_LEVELDB_PREFIX + "read-cache-size"; |
| |
| public static final long DEFAULT_TIMELINE_SERVICE_LEVELDB_READ_CACHE_SIZE = |
| 100 * 1024 * 1024; |
| |
| /** Timeline service leveldb start time read cache (number of entities) */ |
| public static final String |
| TIMELINE_SERVICE_LEVELDB_START_TIME_READ_CACHE_SIZE = |
| TIMELINE_SERVICE_LEVELDB_PREFIX + "start-time-read-cache-size"; |
| |
| public static final int |
| DEFAULT_TIMELINE_SERVICE_LEVELDB_START_TIME_READ_CACHE_SIZE = 10000; |
| |
| /** Timeline service leveldb start time write cache (number of entities) */ |
| public static final String |
| TIMELINE_SERVICE_LEVELDB_START_TIME_WRITE_CACHE_SIZE = |
| TIMELINE_SERVICE_LEVELDB_PREFIX + "start-time-write-cache-size"; |
| |
| public static final int |
| DEFAULT_TIMELINE_SERVICE_LEVELDB_START_TIME_WRITE_CACHE_SIZE = 10000; |
| |
| /** Timeline service leveldb interval to wait between deletion rounds */ |
| public static final String TIMELINE_SERVICE_LEVELDB_TTL_INTERVAL_MS = |
| TIMELINE_SERVICE_LEVELDB_PREFIX + "ttl-interval-ms"; |
| |
| public static final long DEFAULT_TIMELINE_SERVICE_LEVELDB_TTL_INTERVAL_MS = |
| 1000 * 60 * 5; |
| |
| /** The Kerberos principal for the timeline server.*/ |
| public static final String TIMELINE_SERVICE_PRINCIPAL = |
| TIMELINE_SERVICE_PREFIX + "principal"; |
| |
| /** The Kerberos keytab for the timeline server.*/ |
| public static final String TIMELINE_SERVICE_KEYTAB = |
| TIMELINE_SERVICE_PREFIX + "keytab"; |
| |
| //////////////////////////////// |
| // Other Configs |
| //////////////////////////////// |
| |
| /** |
| * Use YARN_CLIENT_APPLICATION_CLIENT_PROTOCOL_POLL_INTERVAL_MS instead. |
| * The interval of the yarn client's querying application state after |
| * application submission. The unit is millisecond. |
| */ |
| @Deprecated |
| public static final String YARN_CLIENT_APP_SUBMISSION_POLL_INTERVAL_MS = |
| YARN_PREFIX + "client.app-submission.poll-interval"; |
| |
| /** |
| * The interval that the yarn client library uses to poll the completion |
| * status of the asynchronous API of application client protocol. |
| */ |
| public static final String YARN_CLIENT_APPLICATION_CLIENT_PROTOCOL_POLL_INTERVAL_MS = |
| YARN_PREFIX + "client.application-client-protocol.poll-interval-ms"; |
| public static final long DEFAULT_YARN_CLIENT_APPLICATION_CLIENT_PROTOCOL_POLL_INTERVAL_MS = |
| 200; |
| |
| /** |
| * The duration that the yarn client library waits, cumulatively across polls, |
| * for an expected state change to occur. Defaults to -1, which indicates no |
| * limit. |
| */ |
| public static final String YARN_CLIENT_APPLICATION_CLIENT_PROTOCOL_POLL_TIMEOUT_MS = |
| YARN_PREFIX + "client.application-client-protocol.poll-timeout-ms"; |
| public static final long DEFAULT_YARN_CLIENT_APPLICATION_CLIENT_PROTOCOL_POLL_TIMEOUT_MS = |
| -1; |
| |
| /** |
| * Max number of threads in NMClientAsync to process container management |
| * events |
| */ |
| public static final String NM_CLIENT_ASYNC_THREAD_POOL_MAX_SIZE = |
| YARN_PREFIX + "client.nodemanager-client-async.thread-pool-max-size"; |
| public static final int DEFAULT_NM_CLIENT_ASYNC_THREAD_POOL_MAX_SIZE = 500; |
| |
| /** |
| * Maximum number of proxy connections for node manager. It should always be |
| * more than 1. NMClient and MRAppMaster will use this to cache connection |
| * with node manager. There will be at max one connection per node manager. |
| * Ex. configuring it to a value of 5 will make sure that client will at |
| * max have 5 connections cached with 5 different node managers. These |
| * connections will be timed out if idle for more than system wide idle |
| * timeout period. The token if used for authentication then it will be used |
| * only at connection creation time. If new token is received then earlier |
| * connection should be closed in order to use newer token. |
| * Note: {@link YarnConfiguration#NM_CLIENT_ASYNC_THREAD_POOL_MAX_SIZE} |
| * are related to each other. |
| */ |
| public static final String NM_CLIENT_MAX_NM_PROXIES = |
| YARN_PREFIX + "client.max-nodemanagers-proxies"; |
| public static final int DEFAULT_NM_CLIENT_MAX_NM_PROXIES = 500; |
| |
| public static final String YARN_HTTP_POLICY_KEY = YARN_PREFIX + "http.policy"; |
| public static final String YARN_HTTP_POLICY_DEFAULT = HttpConfig.Policy.HTTP_ONLY |
| .name(); |
| |
| public YarnConfiguration() { |
| super(); |
| } |
| |
| public YarnConfiguration(Configuration conf) { |
| super(conf); |
| if (! (conf instanceof YarnConfiguration)) { |
| this.reloadConfiguration(); |
| } |
| } |
| |
| @Private |
| public static List<String> getServiceAddressConfKeys(Configuration conf) { |
| return useHttps(conf) ? RM_SERVICES_ADDRESS_CONF_KEYS_HTTPS |
| : RM_SERVICES_ADDRESS_CONF_KEYS_HTTP; |
| } |
| |
| /** |
| * Get the socket address for <code>name</code> property as a |
| * <code>InetSocketAddress</code>. On a HA cluster, |
| * this fetches the address corresponding to the RM identified by |
| * {@link #RM_HA_ID}. |
| * @param name property name. |
| * @param defaultAddress the default value |
| * @param defaultPort the default port |
| * @return InetSocketAddress |
| */ |
| @Override |
| public InetSocketAddress getSocketAddr( |
| String name, String defaultAddress, int defaultPort) { |
| String address; |
| if (HAUtil.isHAEnabled(this) && getServiceAddressConfKeys(this).contains(name)) { |
| address = HAUtil.getConfValueForRMInstance(name, defaultAddress, this); |
| } else { |
| address = get(name, defaultAddress); |
| } |
| return NetUtils.createSocketAddr(address, defaultPort, name); |
| } |
| |
| @Override |
| public InetSocketAddress updateConnectAddr(String name, |
| InetSocketAddress addr) { |
| String prefix = name; |
| if (HAUtil.isHAEnabled(this)) { |
| prefix = HAUtil.addSuffix(prefix, HAUtil.getRMHAId(this)); |
| } |
| return super.updateConnectAddr(prefix, addr); |
| } |
| |
| @Private |
| public static int getRMDefaultPortNumber(String addressPrefix, |
| Configuration conf) { |
| if (addressPrefix.equals(YarnConfiguration.RM_ADDRESS)) { |
| return YarnConfiguration.DEFAULT_RM_PORT; |
| } else if (addressPrefix.equals(YarnConfiguration.RM_SCHEDULER_ADDRESS)) { |
| return YarnConfiguration.DEFAULT_RM_SCHEDULER_PORT; |
| } else if (addressPrefix.equals(YarnConfiguration.RM_WEBAPP_ADDRESS)) { |
| return YarnConfiguration.DEFAULT_RM_WEBAPP_PORT; |
| } else if (addressPrefix.equals(YarnConfiguration.RM_WEBAPP_HTTPS_ADDRESS)) { |
| return YarnConfiguration.DEFAULT_RM_WEBAPP_HTTPS_PORT; |
| } else if (addressPrefix |
| .equals(YarnConfiguration.RM_RESOURCE_TRACKER_ADDRESS)) { |
| return YarnConfiguration.DEFAULT_RM_RESOURCE_TRACKER_PORT; |
| } else if (addressPrefix.equals(YarnConfiguration.RM_ADMIN_ADDRESS)) { |
| return YarnConfiguration.DEFAULT_RM_ADMIN_PORT; |
| } else { |
| throw new HadoopIllegalArgumentException( |
| "Invalid RM RPC address Prefix: " + addressPrefix |
| + ". The valid value should be one of " |
| + getServiceAddressConfKeys(conf)); |
| } |
| } |
| |
| public static boolean useHttps(Configuration conf) { |
| return HttpConfig.Policy.HTTPS_ONLY == HttpConfig.Policy.fromString(conf |
| .get(YARN_HTTP_POLICY_KEY, |
| YARN_HTTP_POLICY_DEFAULT)); |
| } |
| |
| @Private |
| public static String getClusterId(Configuration conf) { |
| String clusterId = conf.get(YarnConfiguration.RM_CLUSTER_ID); |
| if (clusterId == null) { |
| throw new HadoopIllegalArgumentException("Configuration doesn't specify " + |
| YarnConfiguration.RM_CLUSTER_ID); |
| } |
| return clusterId; |
| } |
| } |