HDFS-7649. Multihoming docs should emphasize using hostnames in configurations. (Contributed by Brahma Reddy Battula)

hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt

@@ -783,6 +783,9 @@ Release 2.8.0 - UNRELEASED
     HDFS-8622. Implement GETCONTENTSUMMARY operation for WebImageViewer.
     (Jagadesh Kiran N via aajisaka)
 
+    HDFS-7649. Multihoming docs should emphasize using hostnames in
+    configurations. (Brahma Reddy Battula via Arpit Agarwal)
+
   OPTIMIZATIONS
 
     HDFS-8026. Trace FSOutputSummer#writeChecksumChunks rather than

hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/HdfsMultihoming.md

@@ -54,6 +54,8 @@ By default `HDFS` endpoints are specified as either hostnames or IP addresses. I
 
 The solution is to have separate setting for server endpoints to force binding the wildcard IP address `INADDR_ANY` i.e. `0.0.0.0`. Do NOT supply a port number with any of these settings.
 
+**NOTE:** Prefer using hostnames over IP addresses in master/slave configuration files.
+
     <property>
       <name>dfs.namenode.rpc-bind-host</name>
       <value>0.0.0.0</value>