All Products
Search
Document Center

E-MapReduce:Manage configuration items

Last Updated:Mar 26, 2026

Use the Configure tab in the EMR on ACK console to modify existing configuration items or add new ones. Changes require a two-phase workflow — Save, then Deploy — before they take effect on the cluster.

Prerequisites

Before you begin, ensure that you have:

  • An E-MapReduce (EMR) on ACK cluster created in the EMR console. See Getting started

Behavior by cluster type

Configuration changes behave differently depending on the cluster type:

Cluster typeWhen changes take effect
SparkChanges apply as default values for newly submitted jobs only. Already-submitted jobs are not affected. If you submit a Spark job using a custom resource definition (CRD), the YAML file settings take precedence over these defaults.
Shuffle ServiceChanges do not take effect until you restart the cluster components. See Restart components of a cluster.
Warning

For Shuffle Service clusters, restart the components after deploying a configuration change, or the new settings will not take effect.

Modify a configuration item

  1. Log on to the EMR on ACK console.

  2. On the EMR on ACK page, find the cluster you want to manage and click Configure in the Actions column.

  3. On the Configure tab, search for the configuration item you want to modify and change its value.

  4. Save the configuration:

    1. Click Save.

    2. In the dialog box that appears, set the Execution Reason parameter and click Save.

  5. Deploy the configuration:

    1. At the bottom of the Configure tab, click Deploy Client Configuration.

    2. In the dialog box that appears, set the Execution Reason parameter and click OK.

    3. In the Confirm dialog box, click OK.

Add configuration items

You can add multiple configuration items at a time.

  1. Log on to the EMR on ACK console.

  2. On the EMR on ACK page, find the cluster you want to manage and click Configure in the Actions column.

  3. On the Configure tab, click the tab for the component where you want to add the configuration item.

  4. Click Add Configuration Item.

  5. In the Add Configuration Item dialog box, fill in the configuration items and click OK.

    ParameterDescription
    KeyThe name of the configuration item
    ValueThe value of the configuration item
    DescriptionThe description of the configuration item
    ActionsClick the Delete icon in the Actions column to delete the configuration item
  6. In the dialog box that appears, set the Execution Reason parameter and click Save.

  7. Deploy the configuration:

    1. At the bottom of the Configure tab, click Deploy Client Configuration.

    2. In the dialog box that appears, set the Execution Reason parameter and click OK.

    3. In the Confirm dialog box, click OK.