Amazon EMR release 5.31.0 - Amazon EMR
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon EMR release 5.31.0

5.31.0 application versions

The following applications are supported in this release: Flink, Ganglia, HBase, HCatalog, Hadoop, Hive, Hudi, Hue, JupyterHub, Livy, MXNet, Mahout, Oozie, Phoenix, Pig, Presto, Spark, Sqoop, TensorFlow, Tez, Zeppelin, and ZooKeeper.

The table below lists the application versions available in this release of Amazon EMR and the application versions in the preceding three Amazon EMR releases (when applicable).

For a comprehensive history of application versions for each release of Amazon EMR, see the following topics:

Application version information
emr-5.31.0 emr-5.30.2 emr-5.30.1 emr-5.30.0
Amazon SDK for Java 1.11.8521.11.7591.11.7591.11.759
Python 2.7, 3.72.7, 3.72.7, 3.72.7, 3.7
AmazonCloudWatchAgent - - - -
Delta - - - -
Iceberg - - - -
JupyterEnterpriseGateway - - - -
Trino (PrestoSQL) - - - -

5.31.0 release notes

The following release notes include information for Amazon EMR release 5.31.0. Changes are relative to 5.30.1.

Initial release date: Oct 9, 2020

Last updated date: Oct 15, 2020

  • Upgraded Amazon Glue connector to version 1.13.0

  • Upgraded Amazon SageMaker Spark SDK to version 1.4.0

  • Upgraded Amazon Kinesis connector to version 3.5.9

  • Upgraded Amazon SDK for Java to version 1.11.852

  • Upgraded Bigtop-tomcat to version 8.5.56

  • Upgraded EMR FS to version 2.43.0

  • Upgraded EMR MetricsAndEventsApiGateway Client to version 1.4.0

  • Upgraded EMR S3 Dist CP to version 2.15.0

  • Upgraded EMR S3 Select to version 1.6.0

  • Upgraded Flink to version 1.11.0

  • Upgraded Hadoop to version 2.10.0

  • Upgraded Hive to version 2.3.7

  • Upgraded Hudi to version 0.6.0

  • Upgraded Hue to version 4.7.1

  • Upgraded JupyterHub to version 1.1.0

  • Upgraded Mxnet to version 1.6.0

  • Upgraded OpenCV to version 4.3.0

  • Upgraded Presto to version 0.238.3

  • Upgraded TensorFlow to version 2.1.0

Changes, enhancements, and resolved issues
  • This is a release to fix issues with Amazon EMR Scaling when it fails to scale up/scale down a cluster successfully or causes application failures.

  • Fixed an issue where scaling requests failed for a large, highly utilized cluster when Amazon EMR on-cluster daemons were running health checking activities, such as gathering YARN node state and HDFS node state. This was happening because on-cluster daemons were not able to communicate the health status data of a node to internal Amazon EMR components.

  • Improved EMR on-cluster daemons to correctly track the node states when IP addresses are reused to improve reliability during scaling operations.

  • SPARK-29683. Fixed an issue where job failures occurred during cluster scale-down as Spark was assuming all available nodes were deny-listed.

  • YARN-9011. Fixed an issue where job failures occurred due to a race condition in YARN decommissioning when cluster tried to scale up or down.

  • Fixed issue with step or job failures during cluster scaling by ensuring that the node states are always consistent between the Amazon EMR on-cluster daemons and YARN/HDFS.

  • Fixed an issue where cluster operations such as scale down and step submission failed for Amazon EMR clusters enabled with Kerberos authentication. This was because the Amazon EMR on-cluster daemon did not renew the Kerberos ticket, which is required to securely communicate with HDFS/YARN running on the primary node.

  • Newer Amazon EMR releases fix the issue with a lower "Max open files" limit on older AL2 in Amazon EMR. Amazon EMR releases 5.30.1, 5.30.2, 5.31.1, 5.32.1, 6.0.1, 6.1.1, 6.2.1, 5.33.0, 6.3.0 and later now include a permanent fix with a higher "Max open files" setting.

  • Hive column statistics are supported for Amazon EMR versions 5.31.0 and later.

  • Upgraded component versions.

  • EMRFS S3EC V2 Support in Amazon EMR 5.31.0. In S3 Java SDK releases 1.11.837 and later, encryption client Version 2 (S3EC V2) has been introduced with various security enhancements. For more information, see the following:

    Encryption Client V1 is still available in the SDK for backward compatibility.

New features
  • Lower "Max open files" limit on older AL2 [fixed in newer releases]. Amazon EMR releases: emr-5.30.x, emr-5.31.0, emr-5.32.0, emr-6.0.0, emr-6.1.0, and emr-6.2.0 are based on older versions ofAmazon Linux 2 (AL2), which have a lower ulimit setting for "Max open files" when Amazon EMR clusters are created with the default AMI. Amazon EMR releases 5.30.1, 5.30.2, 5.31.1, 5.32.1, 6.0.1, 6.1.1, 6.2.1, 5.33.0, 6.3.0 and later include a permanent fix with a higher "Max open files" setting. Releases with the lower open file limit causes a "Too many open files" error when submitting Spark job. In the impacted releases, the Amazon EMR default AMI has a default ulimit setting of 4096 for "Max open files," which is lower than the 65536 file limit in the latestAmazon Linux 2 AMI. The lower ulimit setting for "Max open files" causes Spark job failure when the Spark driver and executor try to open more than 4096 files. To fix the issue, Amazon EMR has a bootstrap action (BA) script that adjusts the ulimit setting at cluster creation.

    If you are using an older Amazon EMR version that doesn't have the permanent fix for this issue, the following workaround lets you to explicitly set the instance-controller ulimit to a maximum of 65536 files.

    Explicitly set a ulimit from the command line
    1. Edit /etc/systemd/system/instance-controller.service to add the following parameters to Service section.



    2. Restart InstanceController

      $ sudo systemctl daemon-reload

      $ sudo systemctl restart instance-controller

    Set a ulimit using bootstrap action (BA)

    You can also use a bootstrap action (BA) script to configure the instance-controller ulimit to 65536 files at cluster creation.

    #!/bin/bash for user in hadoop spark hive; do sudo tee /etc/security/limits.d/$user.conf << EOF $user - nofile 65536 $user - nproc 65536 EOF done for proc in instancecontroller logpusher; do sudo mkdir -p /etc/systemd/system/$proc.service.d/ sudo tee /etc/systemd/system/$proc.service.d/override.conf << EOF [Service] LimitNOFILE=65536 LimitNPROC=65536 EOF pid=$(pgrep -f aws157.$proc.Main) sudo prlimit --pid $pid --nofile=65535:65535 --nproc=65535:65535 done sudo systemctl daemon-reload
  • With Amazon EMR 5.31.0, you can launch a cluster that integrates with Lake Formation. This integration provides fine-grained, column-level data filtering to databases and tables in the Amazon Glue Data Catalog. It also enables federated single sign-on to EMR Notebooks or Apache Zeppelin from an enterprise identity system. For more information, see Integrating Amazon EMR with Amazon Lake Formation in the Amazon EMR Management Guide.

    Amazon EMR with Lake Formation is currently available in 16 Amazon Regions: US East (Ohio and N. Virginia), US West (N. California and Oregon), Asia Pacific (Mumbai, Seoul, Singapore, Sydney, and Tokyo), Canada (Central), Europe (Frankfurt, Ireland, London, Paris, and Stockholm), South America (São Paulo).

Known issues
  • Known issue in clusters with multiple primary nodes and Kerberos authentication

    If you run clusters with multiple primary nodes and Kerberos authentication in Amazon EMR releases 5.20.0 and later, you may encounter problems with cluster operations such as scale down or step submission, after the cluster has been running for some time. The time period depends on the Kerberos ticket validity period that you defined. The scale-down problem impacts both automatic scale-down and explicit scale down requests that you submitted. Additional cluster operations can also be impacted.


    • SSH as hadoop user to the lead primary node of the EMR cluster with multiple primary nodes.

    • Run the following command to renew Kerberos ticket for hadoop user.

      kinit -kt <keytab_file> <principal>

      Typically, the keytab file is located at /etc/hadoop.keytab and the principal is in the form of hadoop/<hostname>@<REALM>.


    This workaround will be effective for the time period the Kerberos ticket is valid. This duration is 10 hours by default, but can configured by your Kerberos settings. You must re-run the above command once the Kerberos ticket expires.

  • When AtRestEncryption or HDFS encryption is enabled on a cluster that uses Amazon EMR 5.31.0 or 5.32.0, Hive queries result in the following runtime exception.

    TaskAttempt 3 failed, info=[Error: Error while running task ( failure ) : attempt_1604112648850_0001_1_01_000000_3:java.lang.RuntimeException: java.lang.RuntimeException: Hive Runtime Error while closing operators: java.util.ServiceConfigurationError: Provider not found
  • When you use Spark with Hive partition location formatting to read data in Amazon S3, and you run Spark on Amazon EMR releases 5.30.0 to 5.36.0, and 6.2.0 to 6.9.0, you might encounter an issue that prevents your cluster from reading data correctly. This can happen if your partitions have all of the following characteristics:

    • Two or more partitions are scanned from the same table.

    • At least one partition directory path is a prefix of at least one other partition directory path, for example, s3://bucket/table/p=a is a prefix of s3://bucket/table/p=a b.

    • The first character that follows the prefix in the other partition directory has a UTF-8 value that’s less than than the / character (U+002F). For example, the space character (U+0020) that occurs between a and b in s3://bucket/table/p=a b falls into this category. Note that there are 14 other non-control characters: !"#$%&‘()*+,-. For more information, see UTF-8 encoding table and Unicode characters.

    As a workaround to this issue, set the spark.sql.sources.fastS3PartitionDiscovery.enabled configuration to false in the spark-defaults classification.

5.31.0 component versions

The components that Amazon EMR installs with this release are listed below. Some are installed as part of big-data application packages. Others are unique to Amazon EMR and installed for system processes and features. These typically start with emr or aws. Big-data application packages in the most recent Amazon EMR release are usually the latest version found in the community. We make community releases available in Amazon EMR as quickly as possible.

Some components in Amazon EMR differ from community versions. These components have a version label in the form CommunityVersion-amzn-EmrVersion. The EmrVersion starts at 0. For example, if open source community component named myapp-component with version 2.2 has been modified three times for inclusion in different Amazon EMR releases, its release version is listed as 2.2-amzn-2.

Component Version Description
aws-sagemaker-spark-sdk1.4.0Amazon SageMaker Spark SDK
emr-ddb4.15.0Amazon DynamoDB connector for Hadoop ecosystem applications.
emr-goodies2.13.0Extra convenience libraries for the Hadoop ecosystem.
emr-kinesis3.5.0Amazon Kinesis connector for Hadoop ecosystem applications.
emr-s3-dist-cp2.15.0Distributed copy application optimized for Amazon S3.
emr-s3-select1.6.0EMR S3Select Connector
emrfs2.43.0Amazon S3 connector for Hadoop ecosystem applications.
flink-client1.11.0Apache Flink command line client scripts and applications.
flink-jobmanager-config1.11.0Managing resources on EMR nodes for Apache Flink JobManager.
ganglia-monitor3.7.2Embedded Ganglia agent for Hadoop ecosystem applications along with the Ganglia monitoring agent.
ganglia-metadata-collector3.7.2Ganglia metadata collector for aggregating metrics from Ganglia monitoring agents.
ganglia-web3.7.1Web application for viewing metrics collected by the Ganglia metadata collector.
hadoop-client2.10.0-amzn-0Hadoop command-line clients such as 'hdfs', 'hadoop', or 'yarn'.
hadoop-hdfs-datanode2.10.0-amzn-0HDFS node-level service for storing blocks.
hadoop-hdfs-library2.10.0-amzn-0HDFS command-line client and library
hadoop-hdfs-namenode2.10.0-amzn-0HDFS service for tracking file names and block locations.
hadoop-hdfs-journalnode2.10.0-amzn-0HDFS service for managing the Hadoop filesystem journal on HA clusters.
hadoop-httpfs-server2.10.0-amzn-0HTTP endpoint for HDFS operations.
hadoop-kms-server2.10.0-amzn-0Cryptographic key management server based on Hadoop's KeyProvider API.
hadoop-mapred2.10.0-amzn-0MapReduce execution engine libraries for running a MapReduce application.
hadoop-yarn-nodemanager2.10.0-amzn-0YARN service for managing containers on an individual node.
hadoop-yarn-resourcemanager2.10.0-amzn-0YARN service for allocating and managing cluster resources and distributed applications.
hadoop-yarn-timeline-server2.10.0-amzn-0Service for retrieving current and historical information for YARN applications.
hbase-hmaster1.4.13Service for an HBase cluster responsible for coordination of Regions and execution of administrative commands.
hbase-region-server1.4.13Service for serving one or more HBase regions.
hbase-client1.4.13HBase command-line client.
hbase-rest-server1.4.13Service providing a RESTful HTTP endpoint for HBase.
hbase-thrift-server1.4.13Service providing a Thrift endpoint to HBase.
hcatalog-client2.3.7-amzn-1The 'hcat' command line client for manipulating hcatalog-server.
hcatalog-server2.3.7-amzn-1Service providing HCatalog, a table and storage management layer for distributed applications.
hcatalog-webhcat-server2.3.7-amzn-1HTTP endpoint providing a REST interface to HCatalog.
hive-client2.3.7-amzn-1Hive command line client.
hive-hbase2.3.7-amzn-1Hive-hbase client.
hive-metastore-server2.3.7-amzn-1Service for accessing the Hive metastore, a semantic repository storing metadata for SQL on Hadoop operations.
hive-server22.3.7-amzn-1Service for accepting Hive queries as web requests.
hudi0.6.0-amzn-0Incremental processing framework to power data pipline at low latency and high efficiency.
hudi-spark0.6.0-amzn-0Bundle library for running Spark with Hudi.
hudi-presto0.6.0-amzn-0Bundle library for running Presto with Hudi.
hue-server4.7.1Web application for analyzing data using Hadoop ecosystem applications
jupyterhub1.1.0Multi-user server for Jupyter notebooks
livy-server0.7.0-incubatingREST interface for interacting with Apache Spark
nginx1.12.1nginx [engine x] is an HTTP and reverse proxy server
mahout-client0.13.0Library for machine learning.
mxnet1.6.0A flexible, scalable, and efficient library for deep learning.
mariadb-server5.5.64MySQL database server.
nvidia-cuda9.2.88Nvidia drivers and Cuda toolkit
oozie-client5.2.0Oozie command-line client.
oozie-server5.2.0Service for accepting Oozie workflow requests.
opencv4.3.0Open Source Computer Vision Library.
phoenix-library4.14.3-HBase-1.4The phoenix libraries for server and client
phoenix-query-server4.14.3-HBase-1.4A light weight server providing JDBC access as well as Protocol Buffers and JSON format access to the Avatica API
presto-coordinator0.238.3-amzn-0Service for accepting queries and managing query execution among presto-workers.
presto-worker0.238.3-amzn-0Service for executing pieces of a query.
presto-client0.238.3-amzn-0Presto command-line client which is installed on an HA cluster's stand-by masters where Presto server is not started.
pig-client0.17.0Pig command-line client.
r3.4.3The R Project for Statistical Computing
ranger-kms-server1.2.0Apache Ranger Key Management System
spark-client2.4.6-amzn-0Spark command-line clients.
spark-history-server2.4.6-amzn-0Web UI for viewing logged events for the lifetime of a completed Spark application.
spark-on-yarn2.4.6-amzn-0In-memory execution engine for YARN.
spark-yarn-slave2.4.6-amzn-0Apache Spark libraries needed by YARN slaves.
sqoop-client1.4.7Apache Sqoop command-line client.
tensorflow2.1.0TensorFlow open source software library for high performance numerical computation.
tez-on-yarn0.9.2The tez YARN application and libraries.
webserver2.4.25+Apache HTTP server.
zeppelin-server0.8.2Web-based notebook that enables interactive data analytics.
zookeeper-server3.4.14Centralized service for maintaining configuration information, naming, providing distributed synchronization, and providing group services.
zookeeper-client3.4.14ZooKeeper command line client.

5.31.0 configuration classifications

Configuration classifications allow you to customize applications. These often correspond to a configuration XML file for the application, such as hive-site.xml. For more information, see Configure applications.

emr-5.31.0 classifications
Classifications Description


Change values in Hadoop's capacity-scheduler.xml file.


Change values in Hadoop YARN's file.


Change values in Hadoop's core-site.xml file.


Change EMRFS settings.


Change flink-conf.yaml settings.


Change Flink settings.


Change Flink settings.


Change Flink settings.


Change values in the Hadoop environment for all Hadoop components.


Change values in Hadoop's file.


Change hadoop ssl server configuration


Change hadoop ssl client configuration


Amazon EMR-curated settings for Apache HBase.


Change values in HBase's environment.


Change values in HBase's file.


Change values in HBase's file.


Change values in HBase's hbase-policy.xml file.


Change values in HBase's hbase-site.xml file.


Configure HDFS encryption zones.


Change values in HDFS's hdfs-site.xml.


Change values in HCatalog's environment.


Change values in HCatalog's


Change values in HCatalog's proto-hive-site.xml.


Change values in HCatalog WebHCat's environment.


Change values in HCatalog WebHCat's


Change values in HCatalog WebHCat's webhcat-site.xml file.


Change values in Hive's file.


Change values in Hive's file.


Change values in the Hive environment.


Change values in Hive's file.


Change values in Hive's file.


Change values in Hive's file.


Change values in Hive's hive-site.xml file


Change values in Hive Server2's hiveserver2-site.xml file


Change values in Hue's ini file


Change values in the HTTPFS environment.


Change values in Hadoop's httpfs-site.xml file.


Change values in Hadoop's kms-acls.xml file.


Change values in the Hadoop KMS environment.


Change values in Hadoop's file.


Change values in Hadoop's kms-site.xml file.


Change values in the Hudi environment.


Change values in Jupyter Notebook's file.


Change values in JupyterHubs's file.


Configure Jupyter Notebook S3 persistence.


Change values in Sparkmagic's config.json file.


Change values in Livy's livy.conf file.


Change values in the Livy environment.


Change Livy settings.


Change values in the MapReduce application's environment.


Change values in the MapReduce application's mapred-site.xml file.


Change values in Oozie's environment.


Change values in Oozie's file.


Change values in Oozie's oozie-site.xml file.


Change values in Phoenix's file.


Change values in Phoenix's hbase-site.xml file.


Change values in Phoenix's file.


Change values in Phoenix's file.


Change values in the Pig environment.


Change values in Pig's file.


Change values in Pig's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in Presto's file.


Change values in dbks-site.xml file of Ranger KMS.


Change values in ranger-kms-site.xml file of Ranger KMS.


Change values in the Ranger KMS environment.


Change values in file of Ranger KMS.


Change values for CA file on S3 for MySQL SSL connection with Ranger KMS.


Change values in the EMR RecordServer environment.


Change values in EMR RecordServer's file.


Change values in EMR RecordServer's file.


Amazon EMR-curated settings for Apache Spark.


Change values in Spark's spark-defaults.conf file.


Change values in the Spark environment.


Change values in Spark's hive-site.xml file


Change values in Spark's file.


Change values in Spark's file.


Change values in Sqoop's environment.


Change values in Sqoop OraOop's oraoop-site.xml file.


Change values in Sqoop's sqoop-site.xml file.


Change values in Tez's tez-site.xml file.


Change values in the YARN environment.


Change values in YARN's yarn-site.xml file.


Change values in the Zeppelin environment.


Change values in ZooKeeper's zoo.cfg file.


Change values in ZooKeeper's file.