diff --git a/doc/install-guide-rst/source/basics-networking-neutron.rst b/doc/install-guide-rst/source/basics-networking-neutron.rst
index a034e3990c..6c5cf54df4 100644
--- a/doc/install-guide-rst/source/basics-networking-neutron.rst
+++ b/doc/install-guide-rst/source/basics-networking-neutron.rst
@@ -115,8 +115,9 @@ Controller node
 
       Some distributions add an extraneous entry in the :file:`/etc/hosts`
       file that resolves the actual hostname to another loopback IP
-      address such as ``127.0.1.1``. You must comment out or remove this
-      entry to prevent name resolution problems.
+      address such as ``127.0.1.1``. Note it's ``127.0.*1.1*``, do not
+      remove the required ``127.0.0.1`` entry. You must comment out or
+      remove this entry to prevent name resolution problems.
 
 |
 
@@ -211,8 +212,9 @@ Network node
 
       Some distributions add an extraneous entry in the :file:`/etc/hosts`
       file that resolves the actual hostname to another loopback IP
-      address such as ``127.0.1.1``. You must comment out or remove this
-      entry to prevent name resolution problems.
+      address such as ``127.0.1.1``. Note it's ``127.0.*1.1*``, do not
+      remove the required ``127.0.0.1`` entry. You must comment out or
+      remove this entry to prevent name resolution problems.
 
 |
 
diff --git a/doc/install-guide-rst/source/basics-networking-nova.rst b/doc/install-guide-rst/source/basics-networking-nova.rst
index e1af7f5aaf..3adadb89b9 100644
--- a/doc/install-guide-rst/source/basics-networking-nova.rst
+++ b/doc/install-guide-rst/source/basics-networking-nova.rst
@@ -100,8 +100,9 @@ Controller node
 
       Some distributions add an extraneous entry in the :file:`/etc/hosts`
       file that resolves the actual hostname to another loopback IP
-      address such as ``127.0.1.1``. You must comment out or remove this
-      entry to prevent name resolution problems.
+      address such as ``127.0.1.1``. Note it's ``127.0.*1.1*``, do not
+      remove the required ``127.0.0.1`` entry. You must comment out or
+      remove this entry to prevent name resolution problems.
 
 |
 
@@ -191,8 +192,9 @@ Compute node
 
       Some distributions add an extraneous entry in the :file:`/etc/hosts`
       file that resolves the actual hostname to another loopback IP
-      address such as ``127.0.1.1``. You must comment out or remove this
-      entry to prevent name resolution problems.
+      address such as ``127.0.1.1``. Note it's ``127.0.*1.1*``, do not
+      remove the required ``127.0.0.1`` entry. You must comment out or
+      remove this entry to prevent name resolution problems.
 
 |
 
diff --git a/doc/install-guide/section_basics-networking-neutron.xml b/doc/install-guide/section_basics-networking-neutron.xml
index e7a34a1fe7..919268e515 100644
--- a/doc/install-guide/section_basics-networking-neutron.xml
+++ b/doc/install-guide/section_basics-networking-neutron.xml
@@ -115,8 +115,11 @@
           <para>Some distributions add an extraneous entry in the
              <filename>/etc/hosts</filename> file that resolves the actual
              hostname to another loopback IP address such as
-             <literal>127.0.1.1</literal>. You must comment out or remove
-             this entry to prevent name resolution problems.</para>
+             <literal>127.0.1.1</literal>. Note it's
+             <literal>127.0.1.1</literal>, do not remove the required
+             <literal>127.0.0.1</literal> entry. You must comment out
+             or remove this entry to prevent name resolution
+             problems.</para>
         </warning>
       </step>
     </procedure>
@@ -198,8 +201,11 @@ BOOTPROTO='static'</programlisting>
           <para>Some distributions add an extraneous entry in the
              <filename>/etc/hosts</filename> file that resolves the actual
              hostname to another loopback IP address such as
-             <literal>127.0.1.1</literal>. You must comment out or remove
-             this entry to prevent name resolution problems.</para>
+             <literal>127.0.1.1</literal>. Note it's
+             <literal>127.0.1.1</literal>, do not remove the required
+             <literal>127.0.0.1</literal> entry. You must comment out
+             or remove this entry to prevent name resolution
+             problems.</para>
         </warning>
       </step>
     </procedure>
diff --git a/doc/install-guide/section_basics-networking-nova.xml b/doc/install-guide/section_basics-networking-nova.xml
index f7d00ba501..6c15427423 100644
--- a/doc/install-guide/section_basics-networking-nova.xml
+++ b/doc/install-guide/section_basics-networking-nova.xml
@@ -100,8 +100,11 @@
           <para>Some distributions add an extraneous entry in the
              <filename>/etc/hosts</filename> file that resolves the actual
              hostname to another loopback IP address such as
-             <literal>127.0.1.1</literal>. You must comment out or remove
-             this entry to prevent name resolution problems.</para>
+             <literal>127.0.1.1</literal>. Note it's
+             <literal>127.0.1.1</literal>, do not remove the required
+             <literal>127.0.0.1</literal> entry. You must comment out
+             or remove this entry to prevent name resolution
+             problems.</para>
         </warning>
       </step>
     </procedure>
@@ -178,8 +181,11 @@ BOOTPROTO='static'</programlisting>
           <para>Some distributions add an extraneous entry in the
              <filename>/etc/hosts</filename> file that resolves the actual
              hostname to another loopback IP address such as
-             <literal>127.0.1.1</literal>. You must comment out or remove
-             this entry to prevent name resolution problems.</para>
+             <literal>127.0.1.1</literal>. Note it's
+             <literal>127.0.1.1</literal>, do not remove the required
+             <literal>127.0.0.1</literal> entry. You must comment out
+             or remove this entry to prevent name resolution
+             problems.</para>
         </warning>
       </step>
     </procedure>