Bug 1175453

Summary:	[Doc] wrong reference to HDP documentation
Product:	[Red Hat Storage] Red Hat Gluster Storage	Reporter:	Martin Bukatovic <mbukatov>
Component:	doc-Administration_Guide	Assignee:	Divya <divya>
doc-Administration_Guide sub component:	HDP	QA Contact:	Martin Bukatovic <mbukatov>
Status:	CLOSED CURRENTRELEASE	Docs Contact:
Severity:	medium
Priority:	high	CC:	asriram, rcyriac
Version:	rhgs-3.0	Keywords:	ZStream
Target Milestone:	---
Target Release:	RHGS 3.0.4
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-04-07 10:31:32 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1182947

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.