You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hbase.apache.org by ap...@apache.org on 2012/05/24 02:33:10 UTC
svn commit: r1342107 - in /hbase/branches/0.92: CHANGES.txt
src/docbkx/troubleshooting.xml
Author: apurtell
Date: Thu May 24 00:33:09 2012
New Revision: 1342107
URL: http://svn.apache.org/viewvc?rev=1342107&view=rev
Log:
HBASE-6077. Document the most common secure RPC troubleshooting resolutions
Modified:
hbase/branches/0.92/CHANGES.txt
hbase/branches/0.92/src/docbkx/troubleshooting.xml
Modified: hbase/branches/0.92/CHANGES.txt
URL: http://svn.apache.org/viewvc/hbase/branches/0.92/CHANGES.txt?rev=1342107&r1=1342106&r2=1342107&view=diff
==============================================================================
--- hbase/branches/0.92/CHANGES.txt (original)
+++ hbase/branches/0.92/CHANGES.txt Thu May 24 00:33:09 2012
@@ -88,6 +88,7 @@ Release 0.92.2 - Unreleased
HBASE-6034 Upgrade Hadoop dependencies
HBASE-6023 Normalize security audit logging level with Hadoop
HBASE-6013 Polish sharp edges from CopyTable
+ HBASE-6077 Document the most common secure RPC troubleshooting resolutions
NEW FEATURE
HBASE-5128 [uber hbck] Online automated repair of table integrity and region consistency problems
Modified: hbase/branches/0.92/src/docbkx/troubleshooting.xml
URL: http://svn.apache.org/viewvc/hbase/branches/0.92/src/docbkx/troubleshooting.xml?rev=1342107&r1=1342106&r2=1342107&view=diff
==============================================================================
--- hbase/branches/0.92/src/docbkx/troubleshooting.xml (original)
+++ hbase/branches/0.92/src/docbkx/troubleshooting.xml Thu May 24 00:33:09 2012
@@ -524,6 +524,28 @@ hadoop 17789 155 35.2 9067824 8604364
</section>
+ <section xml:id="trouble.client.security.rpc">
+ <title>Secure Client Cannot Connect ([Caused by GSSException: No valid credentials provided (Mechanism level: Failed to find any Kerberos tgt)])</title>
+ <para>
+There can be several causes that produce this symptom.
+ </para>
+ <para>
+First, check that you have a valid Kerberos ticket. One is required in order to set up communication with a secure HBase cluster. Examine the ticket currently in the credential cache, if any, by running the <tt>klist</tt> command line utility. If no ticket is listed, you must obtain a ticket by running the <tt>kinit</tt> command with either a keytab specified, or by interactively entering a password for the desired principal.
+ </para>
+ <para>
+Then, consult the <a href="http://docs.oracle.com/javase/1.5.0/docs/guide/security/jgss/tutorials/Troubleshooting.html">Java Security Guide troubleshooting section</a>. The most common problem addressed there is resolved by setting <tt>javax.security.auth.useSubjectCredsOnly</tt> system property value to <tt>false</tt>.
+ </para>
+ <para>
+Because of a change in the format in which MIT Kerberos writes its credentials cache, there is a bug in the Oracle JDK 6 Update 26 and earlier that causes Java to be unable to read the Kerberos credentials cache created by versions of MIT Kerberos 1.8.1 or higher. If you have this problematic combination of components in your environment, to work around this problem, first log in with <tt>kinit</tt> and then immediately refresh the credential cache with <tt>kinit -R</tt>. The refresh will rewrite the credential cache without the problematic formatting.
+ </para>
+ <para>
+Finally, depending on your Kerberos configuration, you may need to install the <a href="http://docs.oracle.com/javase/1.4.2/docs/guide/security/jce/JCERefGuide.html">Java Cryptography Extension</a>, or JCE. Insure the JCE jars are on the classpath on both server and client systems.
+ </para>
+ <para>
+You may also need to download the <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-6-download-429243.html">unlimited strength JCE policy files</a>. Uncompress and extract the downloaded file, and install the policy jars into <tt><java-home>/lib/security</tt>.
+ </para>
+ </section>
+
</section>
<section xml:id="trouble.namenode">
<title>NameNode</title>