From d4477ba8da60290d21afd58ce0901d12c85de3a9 Mon Sep 17 00:00:00 2001
From: Shanker Balan <mail@shankerbalan.net>
Date: Mon, 11 Mar 2013 18:46:33 +0530
Subject: [PATCH] CLOUDSTACK-1623: Update documentation to check hosts entry
 for correct loopback interface setup to fix cloud-setup-databases issues
 during setup

---
 docs/en-US/management-server-install-db-local.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/en-US/management-server-install-db-local.xml b/docs/en-US/management-server-install-db-local.xml
index 918cdc0a265..310327fcc75 100644
--- a/docs/en-US/management-server-install-db-local.xml
+++ b/docs/en-US/management-server-install-db-local.xml
@@ -143,6 +143,14 @@ binlog-format = 'ROW'</programlisting>
 -i &lt;management_server_ip&gt;</programlisting>
       <para>When this script is finished, you should see a message like “Successfully initialized
         the database.”</para>
+      <note>
+	<para>If the script is unable to connect to the MySQL database, check
+          the "localhost" loopback address in <filename>/etc/hosts</filename>. It should
+          be pointing to the IPv4 loopback address "127.0.0.1" and not the IPv6 loopback
+          address ::1. Alternatively, reconfigure MySQL to bind to the IPv6 loopback
+          interface.
+        </para>
+      </note>
     </listitem>
     <listitem>
       <para>If you are running the KVM hypervisor on the same machine with the Management Server,