Bug 1164940 – Installation guide section Setting up the JRE for the JBoss ON Agent incorrectly refers to JAVA_HOME which includes /bin/java/

Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.

Bug 1164940 - Installation guide section Setting up the JRE for the JBoss ON Agent incorrectly refers to JAVA_HOME which includes /bin/java/

Summary:	Installation guide section Setting up the JRE for the JBoss ON Agent incorrec...

Status:	CLOSED CURRENTRELEASE

Aliases:	None

Product:	JBoss Operations Network
Classification:	JBoss
Component:	Documentation (Show other bugs)
Sub Component:
Version:	JON 3.2
Hardware:	Unspecified Unspecified

Priority	unspecified Severity medium
Target Milestone:	GA
Target Release:	JON 3.3.1
Assigned To:	Jared MORGAN
QA Contact:	Mike Foley
Docs Contact:

URL:
Whiteboard:
Keywords:	Documentation, EasyFix

Depends On:
Blocks:
	Show dependency tree / graph

Reported:	2014-11-17 17:16 EST by Larry O'Leary
Modified:	2015-08-09 21:24 EDT (History)
CC List:	2 users (show)

See Also:	1164943
Fixed In Version:
Doc Type:	Bug Fix
Doc Text:
Story Points:	---
Clone Of:
Environment:	[Install Guide] Ready for release.
Last Closed:	2015-03-03 04:55:52 EST
Type:	Bug
Regression:	---
Mount Type:	---
Documentation:	---
CRM:
Verified Versions:
Category:	---
oVirt Team:	---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---

Attachments	(Terms of Use)
Add an attachment (proposed patch, testcase, etc.)

External Trackers
Tracker	ID	Priority	Status	Summary	Last Updated
Red Hat Knowledge Base (Solution)	1269633	None	None	None	Never

Groups: None (edit)

Description Larry O'Leary 2014-11-17 17:16:28 EST

Document URL: https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.2/html/Installation_Guide/Agent_Installation.html#jre-agent

Section Number and Name: ⁠4.1.1. Setting up the JRE for the JBoss ON Agent

Describe the issue: The reference to java home path seems to include /bin/java/ at the end:

>    2. Add a line to set the RHQ_JAVA_HOME environment variable to the specific JRE directory. For example:
>    
>        export RHQ_JAVA_HOME=/usr/lib/jvm/jre-1.6.0-openjdk/bin/java/

Suggestions for improvement: 
Example path should not include "/bin/java/":

        export RHQ_JAVA_HOME=/usr/lib/jvm/jre-1.6.0-openjdk

Comment 1 Jared MORGAN 2015-02-04 20:05:05 EST

svn commit en-US/Installing.xml -m "https://bugzilla.redhat.com/show_bug.cgi?id=1164940 - fixed up path by removing the trailling /bin/java/"
Sending        en-US/Installing.xml
Transmitting file data .
Committed revision 98769.

I removed the trailing /bin/java from the identified path and the alternatives path as well.

Comment 3 Filip Brychta 2015-02-25 08:14:49 EST

Looking at http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.3/html/Installation_Guide/Agent_Installation.html#jre-agent

export RHQ_JAVA_HOME=/usr/lib/jvm/jre-1.6.0-openjdk/

is correct now but path to java in alternatives section is not.
Path in alternatives section should be /usr/lib/jvm/jre-1.6.0-openjdk/bin/java

JAVA_HOME and path to java executable are different things.

Comment 4 Jared MORGAN 2015-02-25 20:12:14 EST

Fixed and will push up async after resolving the other two issues.

Comment 5 Jared MORGAN 2015-02-25 22:03:01 EST

svn commit -m "https://bugzilla.redhat.com/show_bug.cgi?id=1164940 - corrected alternatives jre path according to comment 3"
Sending        en-US/Agent.xml
Sending        publican.cfg
Transmitting file data ..
Committed revision 98970.

Comment 6 Jared MORGAN 2015-02-25 23:22:46 EST

The link in Comment 3 will show the updated details.

Revision History is 3.3.1-4 in the book I'm currently pushing to docs-devel for review. Once verified, I'll push it to access.redhat.com

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