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: | Documentation | Assignee: | Nidhi <nsriniva> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Radim Hatlapatka <rhatlapa> |
| Severity: | urgent | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | 6.3.0 | CC: | jstefl, mvelas, nchaudha, nsriniva, smumford, twells |
| Target Milestone: | ER8 | Keywords: | 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
Added new connector option for redirect-binding to topic #4759. Changes will be visible in the next build. Fix is available here: http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Administration_and_Configuration_Guide/index.html#Overview_of_HTTP_Connectors 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. Updated the redirect-binding example command. Changes can be verified here after the next build: http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Administration_and_Configuration_Guide/index.html#Configure_the_Web_Subsystem1 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. 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) 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. Verified in Revision 6.3.0-32 - PASSED |