From 424887242daa106ae5f814ef71ee6cadc5b65677 Mon Sep 17 00:00:00 2001 From: Dmitriy Rabotyagov Date: Mon, 21 Feb 2022 15:09:46 +0100 Subject: [PATCH] [doc] Add note regarding 127.0.1.1 removal Related-Bug: #1960587 Change-Id: I61a27049313044ed211483a7273308afcb2d861f --- deploy-guide/source/targethosts-prepare.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/deploy-guide/source/targethosts-prepare.rst b/deploy-guide/source/targethosts-prepare.rst index 78ef3240ee..f79977f154 100644 --- a/deploy-guide/source/targethosts-prepare.rst +++ b/deploy-guide/source/targethosts-prepare.rst @@ -18,6 +18,12 @@ target host: Configure at least one network interface to access the Internet or suitable local repositories. +Some distributions add an extraneous entry in the ``/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. **Do not remove the 127.0.0.1 entry.** +This step is especially important for `metal` deployments. + We recommend adding the Secure Shell (SSH) server packages to the installation on target hosts that do not have local (console) access.