http://git-wip-us.apache.org/repos/asf/hadoop/blob/6cf023f9/hadoop-common-project/hadoop-common/src/site/markdown/release/3.1.0/RELEASENOTES.3.1.0.md
--
diff --git
a/hadoop-common-project/hadoop-common/src/site/markdown/release/3.1.0/RELEASENOTES.3.1.0.md
b/hadoop-common-project/hadoop-common/src/site/markdown/release/3.1.0/RELEASENOTES.3.1.0.md
new file mode 100644
index 000..9e3c65d
--- /dev/null
+++
b/hadoop-common-project/hadoop-common/src/site/markdown/release/3.1.0/RELEASENOTES.3.1.0.md
@@ -0,0 +1,199 @@
+
+
+# Apache Hadoop 3.1.0 Release Notes
+
+These release notes cover new developer and user-facing incompatibilities,
important issues, features, and major improvements.
+
+
+---
+
+* [HDFS-11799](https://issues.apache.org/jira/browse/HDFS-11799) | *Major* |
**Introduce a config to allow setting up write pipeline with fewer nodes than
replication factor**
+
+Added new configuration
"dfs.client.block.write.replace-datanode-on-failure.min-replication".
+
+The minimum number of replications that are needed to not to fail
+ the write pipeline if new datanodes can not be found to replace
+ failed datanodes (could be due to network failure) in the write pipeline.
+ If the number of the remaining datanodes in the write pipeline is greater
+ than or equal to this property value, continue writing to the remaining
nodes.
+ Otherwise throw exception.
+
+ If this is set to 0, an exception will be thrown, when a replacement
+ can not be found.
+
+
+---
+
+* [HDFS-12486](https://issues.apache.org/jira/browse/HDFS-12486) | *Major* |
**GetConf to get journalnodeslist**
+
+Adds a getconf command option to list the journal nodes.
+Usage: hdfs getconf -journalnodes
+
+
+---
+
+* [HADOOP-14840](https://issues.apache.org/jira/browse/HADOOP-14840) | *Major*
| **Tool to estimate resource requirements of an application pipeline based on
prior executions**
+
+The first version of Resource Estimator service, a tool that captures the
historical resource usage of an app and predicts its future resource
requirement.
+
+
+---
+
+* [YARN-5079](https://issues.apache.org/jira/browse/YARN-5079) | *Major* |
**[Umbrella] Native YARN framework layer for services and beyond**
+
+A framework is implemented to orchestrate containers on YARN
+
+
+---
+
+* [YARN-4757](https://issues.apache.org/jira/browse/YARN-4757) | *Major* |
**[Umbrella] Simplified discovery of services via DNS mechanisms**
+
+A DNS server backed by yarn service registry is implemented to enable service
discovery on YARN using standard DNS lookup.
+
+
+---
+
+* [YARN-4793](https://issues.apache.org/jira/browse/YARN-4793) | *Major* |
**[Umbrella] Simplified API layer for services and beyond**
+
+A REST API service is implemented to enable users to launch and manage
container based services on YARN via REST API
+
+
+---
+
+* [HADOOP-15008](https://issues.apache.org/jira/browse/HADOOP-15008) | *Minor*
| **Metrics sinks may emit too frequently if multiple sink periods are
configured**
+
+Previously if multiple metrics sinks were configured with different periods,
they may emit more frequently than configured, at a period as low as the GCD of
the configured periods. This change makes all metrics sinks emit at their
configured period.
+
+
+---
+
+* [HDFS-12825](https://issues.apache.org/jira/browse/HDFS-12825) | *Minor* |
**Fsck report shows config key name for min replication issues**
+
+**WARNING: No release note provided for this change.**
+
+
+---
+
+* [HDFS-12883](https://issues.apache.org/jira/browse/HDFS-12883) | *Major* |
**RBF: Document Router and State Store metrics**
+
+This JIRA makes following change:
+Change Router metrics context from 'router' to 'dfs'.
+
+
+---
+
+* [HDFS-12895](https://issues.apache.org/jira/browse/HDFS-12895) | *Major* |
**RBF: Add ACL support for mount table**
+
+Mount tables support ACL, The users won't be able to modify their own entries
(we are assuming these old (no-permissions before) mount table with
owner:superuser, group:supergroup, permission:755 as the default permissions).
The fix way is login as superuser to modify these mount table entries.
+
+
+---
+
+* [YARN-7190](https://issues.apache.org/jira/browse/YARN-7190) | *Major* |
**Ensure only NM classpath in 2.x gets TSv2 related hbase jars, not the user
classpath**
+
+Ensure only NM classpath in 2.x gets TSv2 related hbase jars, not the user
classpath.
+
+
+---
+
+* [HDFS-9806](https://issues.apache.org/jira/browse/HDFS-9806) | *Major* |
**Allow HDFS block replicas to be provided by an external storage system**
+
+Provided storage allows data stored outside HDFS to be mapped to and addressed
from HDFS. It builds on heterogeneous storage by introducing a new storage
type, PROVIDED, to the set of media in a datanode. Clients accessing data in
PROVIDED storages can cache replicas in local media, enforce HDFS invariants
(e.g., secu
