Use custom software configuration to override or add service configuration items—such as YARN and Hive settings—at cluster creation time, before any workloads run.
Configure during cluster creation
-
Log on to the EMR console. In the left-side navigation pane, click EMR on ECS.
-
In the top menu bar, select a region and resource group.
-
On the EMR on ECS page, click Create Cluster.
-
In the Software Configuration step, go to the Advanced Settings section and turn on the Custom Software Configuration switch.

-
Enter a JSON array that specifies the configuration items to override or add. Each object in the array targets one configuration item. The following example sets a YARN CPU vcore count and adds a custom key-value pair:
[ { "ApplicationName": "YARN", "ConfigFileName": "yarn-site.xml", "ConfigItemKey": "yarn.nodemanager.resource.cpu-vcores", "ConfigItemValue": "8" }, { "ApplicationName": "YARN", "ConfigFileName": "yarn-site.xml", "ConfigItemKey": "aaa", "ConfigItemValue": "bbb" } ]The following table describes each parameter.
Parameter Description ApplicationNameThe service name. Must be all uppercase letters—for example, YARN.ConfigFileNameThe service configuration file that contains the setting—for example, yarn-site.xmlmaps to YARN's site configuration. See Supported configuration files for the full list. The file name format depends on your cluster type—see the note below.ConfigItemKeyThe name of the configuration item to set. ConfigItemValueThe value to assign to the configuration item. The
ConfigFileNameformat depends on your cluster type: - DataLake, DataFlow, OLAP, DataServing, or Custom clusters: Include the file extension. Example:yarn-site.xml. - Legacy data lake (Hadoop) clusters: Omit the file extension. Example:yarn-site. -
Continue with the remaining cluster creation steps. For details, see Create a cluster.
Configure when adding a node group
When you scale out a running cluster by adding a new node group, you can also adjust service configuration items at that time. For details, see Manage node groups.
Supported configuration files
The following tables list the configuration files available for each service.
YARN
| Configuration file |
|---|
core-site.xml |
log4j.properties |
hdfs-site.xml |
mapred-site.xml |
yarn-site.xml |
httpsfs-site.xml |
capacity-scheduler.xml |
hadoop-env.sh |
httpfs-env.sh |
mapred-env.sh |
yarn-env.sh |
Hive
| Configuration file |
|---|
hive-env.sh |
hive-site.xml |
hive-exec-log4j.properties |
hive-log4j.properties |
What's next
After a cluster is created, you can adjust configuration items directly on the service configuration page. See Manage configuration items.