From b57cf89945a716d621874f9500ecf1f20a2512ec Mon Sep 17 00:00:00 2001 From: Sam Betts Date: Mon, 28 Sep 2015 13:31:41 +0100 Subject: [PATCH] Add troubleshooting section for Ubuntu DNS issues This patch adds a section to troubleshooting in the README, covering a problem caused by local DNS caching in Ubuntu. Change-Id: I8c06b6fb378fcb22b929c25577b96760a7c85046 --- README.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.rst b/README.rst index 1aeccb3c3..a2d82b0ec 100644 --- a/README.rst +++ b/README.rst @@ -639,3 +639,12 @@ Connect to the remote console as described in `Troubleshooting PXE boot`_ to see what is going on with the ramdisk. The ramdisk drops into emergency shell on failure, which you can use to look around. There should be file called ``logs`` with the current ramdisk logs. + +Troubleshooting DNS issues on Ubuntu +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Ubuntu uses local DNS caching, so tries localhost for DNS results first +before calling out to an external DNS server. When DNSmasq is installed and +configured for use with ironic-inspector, it can cause problems by interfering +with the local DNS cache. To fix this issue ensure that ``/etc/resolve.conf`` +points to your external DNS servers and not to ``127.0.0.1``.