Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1366001

Summary:	Installation Guide: Clarify definition of the /host parameter
Product:	[JBoss] JBoss Enterprise Application Platform 6	Reporter:	David Mulford <dmulford>
Component:	Documentation	Assignee:	Lucas Costi <lcosti>
Status:	CLOSED CURRENTRELEASE	QA Contact:
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	6.3.0	CC:	eap-docs, sgilda, sjay, tfonteyn
Target Milestone:	post-GA	Keywords:	Documentation
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:	Build Name: 22818, Installation Guide-6.3-1 Build Date: 18-11-2014 15:56:10 Topic ID: 3757-633793 [Latest]
Last Closed:	2016-10-20 19:14:14 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 David Mulford 2016-08-10 17:35:57 UTC

Title: Configure JBoss EAP 6 as a Service in Microsoft Windows Server (Zip, Installer)

Describe the issue:
Wording of the /host parameter confused a user attempting to setup domain mode, using a Windows host as a slave node.

The user thought that the /host parameter was meant only for specifying the master node. What happened was that shutting down the slave node then became impossible.

Once the slave node's name was specified for /host, everything worked as intended.

Suggestions for improvement:
I would add some text like the following: "If starting in domain mode on a slave node, the slave node's name should instead be specified."

Comment 2 Lucas Costi 2016-09-12 01:13:19 UTC

Thanks for reporting this, David.

However, I've reviewed the case and the service script, and I'm not sure there is an error in the documentation. The docs are based on the help info in the service script, and docs accurately reflect what is there. This might be an error/bug in the script (or the script help) itself.

I've added Tom Fonteyne (IIRC, he wrote the script) for a needinfo.

Tom: is the optional argument for /host parameter meant to specify the EAP domain controller, or the name of the host being started by the service?

The script help defines the former, but this customer's experience seems to indicate the latter.

Comment 4 Tom Fonteyne 2016-09-12 08:32:37 UTC

I guess the help text should read:

/host [^<host^>]      : Indicates that domain mode is to be used with an
                        optional domain/host controller name.


Tom: is the optional argument for /host parameter meant to specify the EAP domain controller, or the name of the host being started by the service?

=> the name of the host being started/stopped by the service

Comment 5 Lucas Costi 2016-09-13 06:26:35 UTC

Thanks, Tom. I'll do the doc change for EAP 6.4 and 7.x.

I'll also open bugs issues for engineering to get the help text fixed, too.

Comment 7 sgilda 2016-09-16 14:18:18 UTC

Peer review complete.

Comment 9 sgilda 2016-10-20 18:43:01 UTC

Verified here:

https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/6.4/html-single/Installation_Guide/index.html#Install_JBoss_Enterprise_Application_Platform_6_Microsoft_Windows_Service

Revision 6.4.0-43	Thursday September 22 2016