Bug 1324797

Summary: Update 'Configuring the Agent to Discover EAP 6 Instances' chapter to correctly differentiate EAP versions
Product: [JBoss] JBoss Operations Network Reporter: Filip Brychta <fbrychta>
Component: DocumentationAssignee: Scott Mumford <smumford>
Status: CLOSED CURRENTRELEASE QA Contact: Mike Foley <mfoley>
Severity: medium Docs Contact:
Priority: unspecified    
Version: JON 3.3.5   
Target Milestone: GA   
Target Release: JON 3.3.6   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-06-22 03:16:07 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:
Bug Depends On:    
Bug Blocks: 1315797    

Description Filip Brychta 2016-04-07 10:40:29 UTC
Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.3/html/Users_Guide/special-discovery.html
Section Number and Name: 
5.3.1. Configuring the Agent to Discover EAP 6 Instances
Describe the issue: 
This chapter is valid for both EAP6 and EAP7 so both versions should be mentioned.

Comment 1 Filip Brychta 2016-04-07 10:44:59 UTC
From Scott:
Edited topic 43725 "Configuring the Agent to Discover EAP 6 Instances" [1] so it no longer refers to EAP 6 specifically (under the assumption that the content is as valid for the EAP 7 plugin as it is for version 6)

1: http://docbuilder.usersys.redhat.com/23086/#special-discovery

Comment 3 Filip Brychta 2016-04-28 08:17:29 UTC
Turned out that original description is incorrect.
run.jar file is available only on EAP5 and earlier.

Whole chapter could look like this:
-------
Configuring the Agent to Discover EAP Instances
As covered in Chapter 4, Interactions with System Users for Agents and Resources, the system user as which the agent runs has a direct effect on how the agent can manage certain resource types. For EAP instances, the agent's system user must have the appropriate permissions to be able to manage EAP resources:

    For EAP5 and earlier the agent must have read permissions to the run.jar file, plus execute and search permissions for every directory in the path to the run.jar file.
    For EAP6/EAP7 the agent must have read permissions to the EAP6/7 configuration files.
    When a JBoss EAP instance is installed from an RPM, the agent user must belong to the same system group which runs the EAP instance. This is jboss, by default.
-------


Also referenced Table 4.1. Cheat Sheet for Agent and Resource Users should be updated accordingly as well.