openstack/openstack-manuals
Code Issues Proposed changes

Elaborate on warning message

Browse Source 
The warning about removing 127.0.1.1 is potentially confusing
(at least it confused me) because 127.0.0.1 is well known
as the loopback address and it may not be apparent that the
warning is actually about a different IP, 127.0.1.1 which
is not as well known. This patch elaborates on the fact
that 127.0.1.1, not 127.0.0.1 must be removed from
/etc/hosts.

Change-Id: Ie358dde24fc07c98948075d97c981985f5c2694b
Closes-Bug: 1459825
This commit is contained in:
Paul Carver 2015-05-28 20:04:32 +00:00 committed by Matthew Kassawara
parent a004eba789
commit 3c70e7a6c1
2 changed files with 30 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/install-guide/section_basics-networking-neutron.xml
View File

@ -111,9 +111,12 @@
# compute1
10.0.0.31 compute1</programlisting>
<warning os="ubuntu;debian">
<para>You must remove or comment the line beginning with
<literal>127.0.1.1</literal>.</para>
<warning>
<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>
</warning>
</step>
</procedure>
@ -191,9 +194,12 @@ BOOTPROTO='static'</programlisting>
# compute1
10.0.0.31 compute1</programlisting>
<warning os="ubuntu;debian">
<para>You must remove or comment the line beginning with
<literal>127.0.1.1</literal>.</para>
<warning>
<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>
</warning>
</step>
</procedure>
@ -242,9 +248,12 @@ BOOTPROTO='static'</programlisting>
# network
10.0.0.21 network</programlisting>
<warning os="ubuntu;debian">
<para>You must remove or comment the line beginning with
<literal>127.0.1.1</literal>.</para>
<warning>
<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>
</warning>
</step>
</procedure>

18
doc/install-guide/section_basics-networking-nova.xml
View File

@ -96,9 +96,12 @@
# compute1
10.0.0.31 compute1</programlisting>
<warning os="ubuntu;debian">
<para>You must remove or comment the line beginning with
<literal>127.0.1.1</literal>.</para>
<warning>
<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>
</warning>
</step>
</procedure>
@ -171,9 +174,12 @@ BOOTPROTO='static'</programlisting>
# controller
10.0.0.11 controller</programlisting>
<warning os="ubuntu;debian">
<para>You must remove or comment the line beginning with
<literal>127.0.1.1</literal>.</para>
<warning>
<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>
</warning>
</step>
</procedure>