You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@impala.apache.org by jr...@apache.org on 2018/01/04 07:37:42 UTC
impala git commit: IMPALA-4978 / IMPALA-5631: [DOCS] Add FQDN known
issue
Repository: impala
Updated Branches:
refs/heads/master 4f4912c53 -> b4a73a68f
IMPALA-4978 / IMPALA-5631: [DOCS] Add FQDN known issue
Because there was no obvious subcategory of known issues to
put this one in, I made a new subcategory 'startup issues'.
Change-Id: Ib039d0102878f1c05470371f581cb258287b9bc0
Reviewed-on: http://gerrit.cloudera.org:8080/7388
Reviewed-by: Sailesh Mukil <sa...@cloudera.com>
Tested-by: Impala Public Jenkins
Project: http://git-wip-us.apache.org/repos/asf/impala/repo
Commit: http://git-wip-us.apache.org/repos/asf/impala/commit/b4a73a68
Tree: http://git-wip-us.apache.org/repos/asf/impala/tree/b4a73a68
Diff: http://git-wip-us.apache.org/repos/asf/impala/diff/b4a73a68
Branch: refs/heads/master
Commit: b4a73a68fb2c5b9d428a6a6d15ddf1ba2795088e
Parents: 4f4912c
Author: John Russell <jr...@cloudera.com>
Authored: Mon Jul 10 11:07:23 2017 -0700
Committer: Impala Public Jenkins <im...@gerrit.cloudera.org>
Committed: Thu Jan 4 07:27:32 2018 +0000
----------------------------------------------------------------------
docs/topics/impala_known_issues.xml | 49 +++++++++++++++++++++++++++++++-
1 file changed, 48 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/impala/blob/b4a73a68/docs/topics/impala_known_issues.xml
----------------------------------------------------------------------
diff --git a/docs/topics/impala_known_issues.xml b/docs/topics/impala_known_issues.xml
index a40aaff..39fed3b 100644
--- a/docs/topics/impala_known_issues.xml
+++ b/docs/topics/impala_known_issues.xml
@@ -129,6 +129,53 @@ https://issues.apache.org/jira/browse/IMPALA-2144 - Don't have
-->
+ <concept id="known_issues_startup">
+
+ <title>Impala Known Issues: Startup</title>
+
+ <conbody>
+
+ <p>
+ These issues can prevent one or more Impala-related daemons
+ from starting properly.
+ </p>
+
+ </conbody>
+
+ <concept id="IMPALA-4978">
+ <title id="IMPALA-5253">Problem retrieving FQDN causes startup problem on kerberized clusters</title>
+ <conbody>
+ <p>
+ The method Impala uses to retrieve the host name while constructing the Kerberos
+ principal is the <codeph>gethostname()</codeph> system call. This function might
+ not always return the fully qualified domain name, depending on the network
+ configuration. If the daemons cannot determine the FQDN, Impala does not start
+ on a kerberized cluster.
+ </p>
+ <p>
+ This problem might occur immediately after an upgrade of a CDH cluster, due to changes
+ in Cloudera Manager that supplies the <codeph>--hostname</codeph> flag automatically to
+ the Impala-related daemons. (See the issue <q>hostname parameter is not passed to Impala catalog role</q>
+ at <xref href="https://www.cloudera.com/documentation/enterprise/release-notes/topics/cm_rn_known_issues.html" scope="external" format="html">the Cloudera Manager Known Issues page</xref>.)
+ </p>
+ <p><b>Bugs:</b> <xref keyref="IMPALA-4978">IMPALA-4978</xref>, <xref keyref="IMPALA-5253">IMPALA-5253</xref></p>
+ <p><b>Severity:</b> High</p>
+ <p><b>Resolution:</b> The issue is expected to occur less frequently on systems
+ with fixes for <xref keyref="IMPALA-4978">IMPALA-4978</xref>, <xref keyref="IMPALA-5253">IMPALA-5253</xref>,
+ or both. Even on systems with fixes for both of these issues, the workaround might still
+ be required in some cases.
+ </p>
+ <p><b>Workaround:</b> Test if a host is affected by checking whether the output of the
+ <cmdname>hostname</cmdname> command includes the FQDN. On hosts where <cmdname>hostname</cmdname>
+ only returns the short name, pass the command-line flag
+ <codeph>--hostname=<varname>fully_qualified_domain_name</varname></codeph>
+ in the startup options of all Impala-related daemons.
+ </p>
+ </conbody>
+ </concept>
+
+ </concept>
+
<concept id="known_issues_crash">
<title>Impala Known Issues: Crashes and Hangs</title>
@@ -182,6 +229,7 @@ https://issues.apache.org/jira/browse/IMPALA-2144 - Don't have
</p>
</conbody>
+ </concept>
<concept id="IMPALA-4595">
<title>Linking IR UDF module to main module crashes Impala</title>
@@ -2084,4 +2132,3 @@ ALTER TABLE table_name SET TBLPROPERTIES('EXTERNAL'='TRUE');
</concept>
</concept>
-</concept>