Bug 1175453 - [Doc] wrong reference to HDP documentation
Summary: [Doc] wrong reference to HDP documentation
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Administration_Guide
Version: rhgs-3.0
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: ---
: RHGS 3.0.4
Assignee: Divya
QA Contact: Martin Bukatovic
URL:
Whiteboard:
Depends On:
Blocks: 1182947
TreeView+ depends on / blocked
 
Reported: 2014-12-17 18:49 UTC by Martin Bukatovic
Modified: 2015-05-13 17:53 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-04-07 10:31:32 UTC
Embargoed:


Attachments (Terms of Use)

Description Martin Bukatovic 2014-12-17 18:49:36 UTC
Document URL
============

https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3/html-single/Administration_Guide/index.html

Section Number and Name
=======================

21.3. Managing Users of the System

Describe the issue
==================

The text refers to the "Installing Hadoop using Apache Ambari" guide which is 
not the best source because we now support HDP 2.1 with Ambari 1.6.1.

While guide called "Installing Hadoop using Apache Ambari" can be still found
here (at least via google):

http://docs.hortonworks.com/HDPDocuments/HDP2/HDP-2.0.6.0/bk_using_Ambari_book/bk_using_Ambari_book-20131022.pdf

There are 2 problems with it:

 * It's HDP 2.0.6 with Ambari 1.4 specific
 * It's no longer linked from HDP docs pages:
    - http://docs.hortonworks.com/HDPDocuments/HDP2/HDP-2.1-latest/index.html
    - http://docs.hortonworks.com/HDPDocuments/Ambari-1.6.1.0/index.html

See affected paragraphs:

> For information on setting up LDAP or Active Directory authentication, see
> Chapter 3. Optional: Set Up LDAP or Active Directory Authentication in
> Installing Hadoop using Apache Ambari guide on Hortonworks Data Platform
> website. 

> For information on Setting Up Kerberos authentication, see Chapter 19.1
> Setting Up Kerberos for Hadoop 2.x in Installing Hadoop using Apachi Ambari
> guide on Hortonworks Data Platform website. 

Suggestions for improvement
===========================

For kerberos setup, it seems that the documentation is now available in the
Ambari Security Guide here:

http://docs.hortonworks.com/HDPDocuments/Ambari-1.6.1.0/bk_ambari_security/content/index.html

For LDAP, I haven't searched for current docs yet.

Comment 1 Divya 2015-03-23 10:02:35 UTC
Updated the cross-references to correct version of the Ambari documentation.

Link to latest documentation: http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Storage/3/html/Administration_Guide/Managing_Users_of_the_System.html

Comment 2 Divya 2015-03-23 10:06:34 UTC
There was an error in the update and I have fixed it now. Link to docbuilder: http://docbuilder.usersys.redhat.com/22522/#Managing_Users_of_the_System

Comment 3 Martin Bukatovic 2015-03-23 13:28:44 UTC
Changes of references to HDP docs looks good.

One minor issue I noticed: the text contains the following (2 times):

> ... in "Ambari Security Guide" guide ...

Wouldn't be better to remove word *quide* here? It looks redundant to me.

Comment 4 Divya 2015-03-24 10:27:42 UTC
I have removed the redundant word. I've updated the guide and is available at: http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Storage/3/html/Administration_Guide/Managing_Users_of_the_System.html

Comment 5 Martin Bukatovic 2015-03-24 11:43:03 UTC
Text on documentation-devel looks good.


Note You need to log in before you can comment on or make changes to this bug.