Bug 1318454

Summary: Clarification on running EAP as system service in domain mode on single machine
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: Lyle Wang <lywang>
Component: DocumentationAssignee: Andrea Hoffer <ahoffer>
Status: CLOSED CURRENTRELEASE QA Contact: sgilda
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.4.5CC: ahoffer, chuffman, eap-docs, sfolkwil, sgilda
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-12-04 21:22:19 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:

Description Lyle Wang 2016-03-17 00:06:54 UTC 
Document URL: 

Installation Guide:
https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/6.4/html/Installation_Guide/sect-Service_Configuration.html

Admin and Config Guide:
https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/6.4/html/Administration_and_Configuration_Guide/sect-Start_and_Stop_JBoss_EAP_6.html#Create_Managed_Domain_on_a_Single_Machine


Section Number and Name: 
2.10. SERVICE CONFIGURATION (in Installation Guide)

2.2.7. Create Managed Domain on a Single Machine (in Admin Guide)


Describe the issue: 

Need to clarify that when running a managed domain (with diff. host controllers using diff. "jboss.domain.base.dir" values) on single machine, it's not supported to configure multiple EAP instances as system service


Suggestions for improvement: 

Add "Important" box in the doc page and highlight that in both installation guide and admin guide.
For example :
"It is not a supported use case to configure multiple EAP instances (for example, multiple host controllers in a domain) on a single machine as system service".

Or:
"When multiple host controllers are configured on single machine, it is not a supported scenario to run them as system service."


Additional information: 
Running multiple host controllers on single machine depends on setting the property "-Djboss.domain.base.dir" for diff. EAP instances.
Comment 2 sgilda 2017-11-13 20:43:59 UTC 
This looks good to me. Marking it verified.
Comment 3 Christian Huffman 2017-12-04 21:22:19 UTC 
Information on supporting only a single instance of JBoss EAP as a system service has been included, and is live on the Customer Portal at the following links:

* https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/6.4/html-single/installation_guide/#Configure_JBoss_Enterprise_Application_Platform_as_a_Service_in_Red_Hat_Enterprise_Linux_RPM_Method
* https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/6.4/html-single/administration_and_configuration_guide/#Create_Managed_Domain_on_a_Single_Machine