Bug 1089361

Summary: [Doc Feature] Missing documentation for redirect-port and redirect-binding attributes
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: Radim Hatlapatka <rhatlapa>
Component: DocumentationAssignee: Nidhi <nsriniva>
Status: CLOSED CURRENTRELEASE QA Contact: Radim Hatlapatka <rhatlapa>
Severity: urgent Docs Contact:
Priority: unspecified    
Version: 6.3.0CC: jstefl, mvelas, nchaudha, nsriniva, smumford, twells
Target Milestone: ER8Keywords: Documentation, FutureFeature
Target Release: EAP 6.3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Build Name: 22508, Administration and Configuration Guide-6.3-1 Build Date: 11-04-2014 10:15:39 Topic ID: 4759-619719 [Latest]
Last Closed: 2014-08-06 14:39:22 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 Radim Hatlapatka 2014-04-18 13:55:23 UTC
Title: Configure the Web Subsystem

Describe the issue:
In EAP 6.3 is added new functionality allowing to set socket binding instead of port number for port redirection. This was done as part of BZ#900786 and needs to be documented.

Comment 1 Nidhi 2014-06-03 18:15:58 UTC
Added new connector option for redirect-binding to topic #4759.

Changes will be visible in the next build.

Comment 3 Martin Velas 2014-06-17 08:37:18 UTC
The description of redirect-binding feature (table 16.2) explains the redirection of the http soctet connector to the https. But the example shows how to redirect ajp connector to itself - this is inconsistent and also doesn't make much sense.

Please replace the command with something like:
/profile=full-ha/subsystem=web/connector=http:write-attribute(name=redirect-binding,value=https)

Also the link above points to the incorrect chapter 18 but the description of the redirect-binding feature is contained in the chapter 16.1.

Comment 5 Radim Hatlapatka 2014-06-23 07:16:14 UTC
documentation for redirect-port is still missing.

redirect-port and redirect-binding are two different connector configuration options the behavior is almost the same, just redirect-port requires number to specify port, redirect-binding requires socket-binding.

Both options needs to be documented.

Comment 7 Radim Hatlapatka 2014-06-24 09:12:12 UTC
The CLI command is incorrect for redirect-port
the value needs to be a valid port number (e.g. 8443 which is default https port number)
=>
/profile=full-ha/subsystem=web/connector=http:write-attribute(name=redirect-port,value=8443)


Next description of redirect-port is not fully correct
- yes the most common case is redirection to secure connector
- but note that it can be also used by redirection to ajp, see https://issues.jboss.org/browse/WFLY-1070 (mainly first three comments)


Additional note:
Small other suggestion for improvement.
- what about having description of redirect-binding to just point that the behavior is the same as for redirect-port just the value is name of socket-binding (plus you can leave there the benefits of using socket-binding)

Comment 10 Martin Velas 2014-06-26 13:59:23 UTC
Formuation that the redirect-binding "acts as a connector on the http socket" is quite confusing and possibly incorrect depending on implementation details.

 - redirect-binding is not limited on http -> https redirection
 - the point of whole redirect-binding is the fact that you can use already defined socket-binding (of https, ajp, ...) to the specific port for redirection. This enables higher flexibility of configuration. Besides this the result is the same as for the redirect-port option.

Comment 13 Jan Stefl 2014-07-04 15:03:28 UTC
Verified in Revision 6.3.0-32 - PASSED