All Products
Search
Document Center

E-MapReduce:Create a cluster

Last Updated:Jun 26, 2026

Alibaba Cloud E-MapReduce (EMR) allows you to build and run open-source big data frameworks such as Hadoop, Spark, Hive, and Presto for large-scale data processing and analysis. This topic describes the steps and configuration options for creating an EMR on ECS cluster to help you quickly set up and manage your big data clusters.

Note

If you are creating an EMR cluster for the first time after 17:00 (UTC+8) on December 19, 2022, you cannot select the Hadoop, Data Science, Presto, or ZooKeeper cluster types.

Prerequisites

You have completed RAM authorization. For more information, see Authorize roles for an Alibaba Cloud account.

Usage notes

For DataLake, DataFlow, DataServing, and Custom clusters of EMR V5.12.1, EMR V3.46.1, or later, if the selected services do not require Core nodes, you can click Remove Node Group in the Actions column of the Node Group section.

Steps

  1. Log on to the E-MapReduce console.

  2. In the top navigation bar, select a region and resource group based on your requirements.

    • Region: The cluster is created in the selected region. You cannot change the region after the cluster is created.

    • Resource Group: By default, all resources in your account are displayed.

  3. Click Create Cluster.

  4. Configure the cluster based on the on-screen instructions.

    When you create a cluster, you must configure its software, hardware, and basic settings, and then confirm the order.

    Note

    After a cluster is created, you cannot change its configuration settings, except for the cluster name. Carefully review all settings before you create the cluster.

  5. After you verify that all settings are correct, click Confirm.

    Important
    • Pay-as-you-go cluster: Creation starts immediately. After the cluster is created, its status changes to Running.

    • Subscription cluster: An order is generated first. The cluster is created after you complete the payment.

Parameters

Software configuration

Parameter

Description

Region

A region is the geographical area where a data center is located. Selecting a region closer to your location can reduce network latency. You cannot change the region after the cluster is created.

Business Scenario

Select a scenario based on your business needs:

  • Data Lake (DataLake): Provides a flexible, reliable, and efficient managed cluster for running big data computing engines and performing data analytics.

    • Supports building a data lake architecture and uses JindoFS to accelerate data lake operations.

    • Supports OSS-HDFS (fully managed HDFS) for storage, reducing your O&M costs with a usage-based billing model.

    For more information, see DataLake cluster.

  • Data Analytics (OLAP): Imports massive datasets into an OLAP analytics engine, such as ClickHouse or StarRocks, using methods such as data import or external tables. It provides efficient, real-time, and flexible data analytics for business scenarios such as user profiling, audience segmentation, BI reporting, and business analysis.

  • Real-time Data Streaming (DataFlow): An all-in-one real-time computing solution on the EMR platform. It features two main components: Kafka, a distributed, high-throughput, and highly scalable messaging system, and the Flink commercial kernel from Ververica (based on Apache Flink). This solution focuses on addressing end-to-end real-time computing challenges and is widely used for real-time data ETL and log collection and analysis. You can also use either component individually.

  • Data Service (DataServing):

    • Provides flexible, reliable, and efficient data service clusters.

    • Provides semi-managed HBase clusters and decouples compute clusters from data storage by using OSS-HDFS (the JindoFS service).

    • Supports JindoData local caching to further improve the read and write performance of the data service cluster.

    For more information, see DataServing cluster.

  • Custom Cluster (Custom): Provides a rich selection of services. You can choose the services you need based on your requirements.

    Note

    In a production environment, we recommend that you avoid deploying multiple storage services on the same node group.

Product Version

The release version of the EMR product. For more information, see Release versions.

High Service Availability

This feature is disabled by default. When you enable high availability, EMR creates multiple Master nodes to support high availability for ResourceManager and NameNode. These nodes are distributed across different underlying hardware to reduce the risk of failure.

Optional Services (Select One At Least)

Select other services based on your business requirements. The selected services automatically start their related processes.

Important
  • Adding more services increases hardware requirements. In subsequent steps, select instance specifications appropriate for your chosen services to ensure sufficient resources.

  • Installed services cannot be uninstalled.

  • The required parameters vary depending on the product version and selected services.

Collect Service Operational Logs

This setting, enabled by default, controls log collection for all services. These logs are used only for cluster diagnostics.

After the cluster is created, you can go to the Basic Information page to change the Collection Status of Service Operational Logs.

Important

If you disable log collection, EMR health checks and technical support will be limited, but other features will continue to function normally. For details on how to disable this feature and its impact, see How do I stop collecting service logs?.

Metadata

The following methods are supported for storing and managing metadata:

  • DLF Unified Metadata (Recommended): Stores metadata in Data Lake Formation (DLF).

    After activating DLF, the system selects a default DLF Catalog for you (typically your UID). To use different catalogs for different clusters, create a new one:

    1. Click Create Catalog. In the dialog box that appears, enter a catalog ID and click OK.

    2. From the DLF Catalog drop-down list, select the catalog that you created.

  • Self-managed RDS: Uses your own or an Alibaba Cloud RDS instance as metadata storage.

    If you select this method, you must configure RDS-related parameters. For more information, see Configure a self-managed RDS database.

  • Built-in MySQL (Not Recommended): Stores metadata in a MySQL database on the cluster's Master node.

    Note
    • For testing scenarios: We recommend using DLF Unified Metadata.

    • For production scenarios: You can use DLF Unified Metadata or Self-managed RDS.

Root Storage Directory of Cluster

This parameter is required only when you select the OSS-HDFS service. It is not needed if you select the HDFS service.

Important

Buckets created by clicking the Create OSS-HDFS Bucket button in the EMR console support read and write operations only through EMR. Operations from the console or an API are not supported.

When you use the OSS-HDFS service for the first time, your Alibaba Cloud account (main account) must click here and follow the prompts to complete the authorization. If you are a RAM user, your Alibaba Cloud account must authorize you to activate the service and grant the AliyunEMRDlsFullAccess policy and the AliyunOSSDlsDefaultRole and AliyunEMRDlsDefaultRole roles. For more information, see Grant permissions to a RAM user. Select a bucket in the same region where the OSS-HDFS service is already enabled, or click Create OSS-HDFS Bucket to create a new OSS-HDFS instance as the root storage path for the cluster.

Note
  • Before you use the OSS-HDFS service, make sure it is available in your selected region. If not, you can switch to a different region or use the HDFS service instead. For information about regions that support the OSS-HDFS service, see Enable OSS-HDFS and grant access permissions.

  • The OSS-HDFS service is supported for DataLake, DataFlow, DataServing, and Custom clusters of EMR V5.12.1, EMR V3.46.1, or later.

Service and version parameters

The following parameters are related to the selected product version and services.

  • The following parameters are required only for EMR V5.12.0 and earlier, or EMR V3.46.0 and earlier, when the Hive service is selected.

    Parameter

    Description

    Hive Storage Mode

    Specifies whether to use OSS-HDFS or OSS as the storage directory for the data warehouse. If you do not select this option, the cluster's local HDFS is used.

    When this is selected by default, you must also configure the Hive Data Warehouse Path. We recommend that you select a bucket with the HDFS service enabled.

    Note

    Make sure you have the necessary permissions to access the OSS or OSS-HDFS bucket.

  • The following parameters are required only for EMR V5.12.0 and earlier, or EMR V3.46.0 and earlier, when the HBase service is selected.

    Parameter

    Description

    HBase Storage Mode

    Specifies the storage mode for HBase data files. The following modes are supported: OSS-HDFS and OSS.

    If you select the OSS-HDFS mode, you must also configure the HBase Storage Path. We recommend that you select a bucket for which the HDFS service is enabled.

  • The following parameters are required only for EMR V5.12.1 and later, or EMR V3.46.1 and later, after you select the OSS-HDFS and HBase services. After the cluster is created, an HBase-HDFS service is generated. For more information, see HBASE-HDFS.

    Parameter

    Description

    HBase Log Storage

    This is selected by default, which means HBase stores HLog files in HDFS.

More scenarios

Important

If you are creating an EMR cluster for the first time after 17:00 (UTC+8) on December 19, 2022, you cannot select the following cluster types.

  • Machine Learning (Data Science): Primarily for Big Data + AI scenarios.

    • Provides a distributed deep learning framework.

    • Provides over 200 classic machine learning algorithm packages.

    • Provides AutoML capabilities and more than 10 deep learning algorithms covering scenarios such as recommendation and advertising.

  • Old Data Lake: Used to build large-scale data processing frameworks and pipelines, suitable for big data analytics. It supports open-source frameworks such as Apache Hive, Spark, and Presto. The following cluster types are supported:

    • Hadoop:

      • Provides the most extensive list of open-source components, fully compatible with the Hadoop ecosystem.

      • Can be used for various scenarios such as big data offline processing, real-time processing, and interactive queries.

      • Supports building a data lake architecture and uses JindoFS for data lake acceleration.

    • ZooKeeper: Provides an independent, distributed coordination service for large-scale Hadoop, HBase, and Kafka clusters.

    • Presto: An in-memory, distributed SQL engine for interactive queries. It supports multiple data sources and is suitable for complex analysis of petabyte-scale data and cross-data-source queries.

Advanced settings (optional)

Parameter

Description

Kerberos Authentication

This feature is disabled by default. Kerberos is a network authentication protocol based on symmetric-key cryptography that provides authentication for other services. For more information, see Kerberos.

Important
  • Knox: Kerberos authentication is not supported.

  • Kudu: Even if Kerberos is enabled, the Kudu service requires additional configuration to support and enable Kerberos authentication. For more information, see the Apache Kudu documentation on Authentication.

Custom Software Configuration

You can specify a JSON file to configure the basic software in the cluster, such as Hadoop, Spark, and Hive. This feature is disabled by default. For more information, see Configure custom software.

Note

For information about how to set the concurrency level for Hive jobs, see FAQ.

Hardware configuration

Parameter

Description

Billing Method

Subscription is selected by default. The following billing methods are supported:

  • Pay-as-you-go: A post-paid model where you are billed hourly for actual usage. This method is suitable for short-term testing or flexible, dynamic tasks.

  • Subscription: A pre-paid model where you pay before use.

    Note
    • We recommend using the Pay-as-you-go method for testing scenarios. After testing is successful, create a Subscription cluster for production use.

    • For subscription instances, you must also select a Subscription Duration and decide whether to enable Auto-renewal. The default renewal period is six months, with auto-renewal enabled. When auto-renewal is enabled, the instance is automatically renewed seven days before it expires. For more information, see Renewal.

Zone

An availability zone is a distinct physical location within a region, interconnected by a low-latency private network. You can typically use the default availability zone.

VPC

A VPC is a logically isolated network environment on Alibaba Cloud that gives you full control over your network configuration.

Select an existing VPC, or click Create VPC to create one instantly in the VPC console. For more information, see Create and manage a VPC.

Note

You cannot change the private IP address after a cluster is created because the private IP address is bound to the Virtual Private Cloud (VPC).

vSwitch

A vSwitch is a basic network subdivision of a VPC used to connect different cloud resources.

Select an existing vSwitch, or click . Create vSwitch to create one instantly in the VPC console. For more information, see Create and manage a vSwitch.

The CIDR block size of the vSwitch determines the number of available IPv4 addresses. For example, a /24 CIDR block provides about 250 available IP addresses, a /20 block provides about 4,090, and a /17 block provides about 32,764. If your cluster requires a large number of nodes, select a vSwitch with a larger CIDR block to ensure enough IP addresses can be allocated to all cluster nodes.

You cannot change the CIDR block of a vSwitch after it is created. If you need a larger IP address range, you must create a new vSwitch with a larger CIDR block and then create a new cluster based on that vSwitch. When you create a vSwitch, the console displays the number of available IP addresses for the selected CIDR block, which helps you assess whether it meets your cluster size requirements.

Default Security Group

A security group is a virtual firewall that controls inbound and outbound traffic for instances within the group. For more information, see Security group overview.

Select an existing security group, or click create a new security group. to create one in the ECS console. For more information, see Create a security group.

Important

Do not use enterprise security groups created on ECS.

Node Group

You can select instance types based on your requirements. For more information, see Instance families.

  • Master: Runs control plane services such as ResourceManager and NameNode.

  • Core: Stores data in the cluster's distributed file system (HDFS). You can also scale out Core nodes on demand after the cluster is created.

  • Task: Provides additional compute capacity and does not store data. This node group is optional and can be added to scale computing resources.

    Important

    Task node groups support pay-as-you-go, preemptible instance, and subscription billing methods.

  • Add to Deployment Set: When high availability is enabled, Master nodes are added to a deployment set by default. A deployment set is a policy that controls the distribution of instances. For more information, see Deployment sets.

  • System Disk: Select a standard SSD, enhanced SSD (ESSD), or ultra disk as needed. Adjust the system disk size as required.

  • Data Disk: Select a standard SSD, enhanced SSD (ESSD), or ultra disk as needed. Adjust the data disk size as required.

    Note

    When you select an enhanced SSD (ESSD), you can set different performance levels (PLs) based on the disk capacity to meet various cluster performance needs. The default performance level is PL1. Depending on the disk capacity, system disks support PL0, PL1, and PL2, while data disks support PL0, PL1, PL2, and PL3. For more information about cloud disks, see Cloud disk overview.

  • Instances: The Master node group has one instance by default. If high availability is enabled, you can have multiple Master instances.

    The Core node group has two instances by default. You can adjust this number as needed.

  • Additional Security Group: Additional security groups allow flexible access control between different external resources or applications. You can associate up to two additional security groups with this node group.

  • Assign Public Network IP: Specifies whether to assign an Elastic IP (EIP) address to the cluster. This is disabled by default. Only DataLake clusters support assigning public IPs at the node group level.

    Note

    If you do not enable this feature but want to use a public IP address to access the cluster after it is created, you must apply for one on the ECS console. For more information, see Apply for an EIP.

Cluster Scaling

You can select an auto scaling rule as needed:

  • Do Not Use Auto Scaling Rules (Default).

  • Custom Auto Scaling Rule: You can define custom rules for time-based or load-based auto scaling. For more information, see Create a custom auto scaling rule.

  • Managed Auto Scaling Rule: When you start the cluster, EMR pre-provisions the number of Task nodes based on the managed scaling rule. For more information, see Create a managed auto scaling rule.

Note
  • You can configure auto scaling rules only when the billing method for the Task node group is pay-as-you-go or preemptible instance.

  • If a cluster contains Trino, Presto, StarRocks, Impala, or ClickHouse components, you cannot switch to a managed auto scaling rule.

Basic configuration

Parameter

Description

Cluster Name

The name of the cluster. The name must be 1 to 64 characters long and can contain only Chinese characters, letters, digits, hyphens (-), and underscores (_).

Identity Credentials

Identity Credentials provide secure access to the cluster's Master node. For logon instructions, see Log on to a cluster. The following credential types are supported:

  • Key Pair (Default): Select an existing key pair or click Create Key Pair to create one instantly.

    A key pair, which consists of a public key and a private key, is a secure and convenient authentication method for logging on to Linux instances. For more information about using key pairs, see SSH key pairs.

  • Password: Set a logon password for the Master node and confirm it. The default username is root.

    • Password requirements: 8 to 30 characters in length and must contain uppercase letters, lowercase letters, digits, and special characters.

    • Supported special characters include: exclamation mark (!), at sign (@), hash sign (#), dollar sign ($), percent sign (%), caret (^), ampersand (&), and asterisk (*).

Advanced settings (optional)

Parameter

Description

ECS Application Role

When your program runs on an EMR compute node, you do not need to specify an Alibaba Cloud AccessKey to access related cloud services such as OSS. EMR automatically obtains a temporary AccessKey for the access, and the permissions of this key are controlled by an ECS Application Role.

Bootstrap Actions

Scripts that run on cluster nodes before services start. Use them to install software or customize the environment. For more information, see Run scripts by using bootstrap actions.

Release Protection

This feature prevents accidental deletion of pay-as-you-go clusters. If enabled, you must disable it before you can release the cluster. For more information, see Enable and disable release protection.

Tags

You can add tags when creating a cluster or after it is created. Tags help you identify and manage your cluster resources. For more information, see Manage tags.

Resource Group

Resource groups allow you to group your cloud resources by purpose, permissions, or ownership. For more information, see Use resource groups.

Data Disk Encryption

This feature can be enabled only when you create a cluster. When enabled, data at rest on the data disk is encrypted. For more information, see Enable data disk encryption.

System Disk Encryption

This feature can be enabled only when you create a cluster. When enabled, the operating system, program files, and other data at rest on the system disk are encrypted. For more information, see Enable system disk encryption.

Remarks

Used to record important information about the cluster. You can add or modify remarks on the Basic Information page after the cluster is created.

Confirm order

(Optional) Save as Cluster Template: If you select Key Pair for logon credentials, you can click Save as Cluster Template to save the current cluster configuration as a cluster template.

  1. In the Save as Cluster Template dialog box, enter a Cluster Template Name and select a Cluster Template Resource Group.

    Parameter

    Description

    Cluster Template Name

    Enter a name for the cluster template to facilitate management. The name must be 1 to 64 characters long and can contain only Chinese characters, letters, digits, hyphens (-), and underscores (_).

    Cluster Template Resource Group

    Select an existing resource group to organize your templates.

    If you need to create a new resource group, you can click Create Resource Group. below. For more information, see Create a resource group.

  2. Click OK.

    A new cluster template is added to the Manage Cluster Templates panel. For more information about cluster templates, see Create a cluster template.

FAQ

EntityNotExist.Role error

  • Cause: The current account does not have the necessary permissions to create a cluster.

  • Solution:

    Choose the appropriate solution based on whether you are using an Alibaba Cloud account or a RAM user.

    • Alibaba Cloud account: When creating a cluster, your account must have permission to access other Alibaba Cloud resources and perform related operations. You can click RAM Quick Authorization to authorize your account. After authorization is successful, you can create the cluster. For more information on role authorization, see Authorize roles for an Alibaba Cloud account.

    • RAM user: Your account does not have the permissions to create an EMR cluster. We recommend that you use an Alibaba Cloud account to grant the AliyunEMRFullAccess policy to the RAM user. For more information, see Grant permissions to a RAM user.

Related documentation