Bug 1233715

Summary:	[QE] Example paths to EAP home directory needs to be unified
Product:	[JBoss] JBoss Enterprise Application Platform 6	Reporter:	Ondrej Lukas <olukas>
Component:	Documentation	Assignee:	Zach Rhoads <zrhoads>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Ondrej Kotek <okotek>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	6.4.0	CC:	dmichael, eap-docs, olukas, sgilda
Target Milestone:	post-GA	Keywords:	Documentation, Triaged
Target Release:	EAP 6.4.3
Hardware:	Unspecified
OS:	Unspecified
URL:	https://access.stage.redhat.com/beta/documentation/en/red-hat-jboss-enterprise-application-platform-64-how-to-configure-server-security
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-10-20 12:49:51 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:	1233490

Description Ondrej Lukas 2015-06-19 12:34:14 UTC

Book: How to Configure Server Security
Revision: n_1415843_how-to-configure-server-security_version_6.4_edition_1.0_release_0-revision_1
Section:

Issue description:
There is for example "-keystore EAP_HOME/standalone/configuration/identity.jks" parameter of a keytool command. In other examples, "path-to/jboss-eap/" is used as a substitution for path to EAP home directory. This inconsistence is confusing.

Suggestions for improvement:
All example paths to EAP home directory should use "path-to/jboss-eap/". Or, all example paths to EAP home directory should use "EAP_HOME" or "$EAP_HOME", but explained at the beginning of the document. "EAP_HOME" looks like a variable with "$" missing. "$EAP_HOME" is user friendly, because it makes copy and paste usage easier.

Comment 6 sgilda 2015-08-04 10:12:51 UTC

Ondra, I am unclear where this bug stands. Should the fix be reverted so it matches the rest of the guides?

Comment 8 sgilda 2015-08-04 10:54:01 UTC

Thanks Ondra. Moving this back to assigned for rework
.