Bug 779066 (SOA-1470)

Summary: Document HttpRouter configuration parameter
Product: [JBoss] JBoss Enterprise SOA Platform 4 Reporter: Martin Vecera <mvecera>
Component: DocumentationAssignee: David Le Sage <dlesage>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: unspecified   
Target Milestone: ---   
Target Release: 4.3 CP04 ER1   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-1470
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
SOA-P 4.3.CP02 CR2
Last Closed: 2010-03-26 18:23:39 UTC Type: Task
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Martin Vecera 2009-08-31 07:19:19 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2009-09-03 23:40:47
project_key: SOA

Please document SOA-1466. There is a new parameter to configure the underlying HTTPClient that has a great performance impact (which I suggest to stress in the docs).  The feature has been merged from newer version - JBESB-2804

Comment 1 Martin Vecera 2009-08-31 07:30:37 UTC
Link: Added: This issue is related to SOA-1466


Comment 2 Martin Vecera 2009-08-31 07:30:37 UTC
Link: Added: This issue is related to JBESB-2548


Comment 3 Martin Vecera 2009-08-31 07:30:37 UTC
Link: Added: This issue is related to JBESB-2804


Comment 4 Dana Mison 2009-09-04 03:40:47 UTC
It is not obvious where this should be documented.  Has this been added to any of the upstream ESB docs ?

new "max-total-connections" property, default value 2

Should this be added to the properties for Apache Commons HttpRouter at 
http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/4.3.CP01/html-single/Programmers_Guide/index.html#section-HttpRouter

and added to the properties for SOAPClient at 
http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/4.3.CP01/html-single/Programmers_Guide/index.html#OOTB-Actions_webservices-soap



Comment 5 Len DiMaggio 2009-09-14 20:14:52 UTC
Martin is out until Sept 21 - assigning to me to find the answer for CP02

Comment 6 Len DiMaggio 2009-09-15 16:43:57 UTC
This is currently documented in the JBoss ESB 4.6 javadocs:

jbossesb-4.6-src/product/build/jbossesb-server-4.6/javadocs/org/jboss/soa/esb/http/configurators/Connection.html

HTTP Connection configurator.

This Configurator is always applied to HttpClient instances created by the HttpClientFactory. Of course, if you wish to make the connection configurations in a different way, you can always create a custom Configurator that creates and attches a different HttpConnectionManager instance that has differnt configurations.

Properties:

    * max-total-connections: Maximum total number of connection for the HttpClient instance.
    * max-connections-per-host: Maximum connection per target host for the HttpClient instance. Note that the default value for this configuration is 2. So, configuring the "max-total-connections" property without also configuring this property will have little effect on performance for a single host because it will only ever open a max of 2 connections (as per the default).

============================

We should make the update to the upstream ESB docs and get the changes into the SOA-P docs from the project. I'll log a JBESB feature request JIRA to add this to the programmers' guide section on Apache Commons HttpRouter. 

For SOA-P - we should also add the information to the SOAPClient as listed above. 






Comment 7 Len DiMaggio 2009-09-15 16:46:59 UTC
Link: Added: This issue related JBESB-2841


Comment 8 Len DiMaggio 2009-09-16 12:48:49 UTC
Assigning to Darrin - we need to get this into the open bug list in the release notes - and get it fixed in CP03.

Comment 9 David Le Sage 2010-02-23 00:39:48 UTC
This information has now been added to the relevant two sections of the Programmers' Guide (as described above) for release 4.3.CP03.

Comment 10 Jiri Pechanec 2010-03-25 09:29:32 UTC
http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP03/Programmers_Guide/html/ch11s07s03.html

The paramters described relates to SOAPCLient so I suggest to move the chapter and make it  section 11.7.3.1 under current section 11.7.4 SOAPClient

Comment 11 David Le Sage 2010-03-26 04:12:54 UTC
Jiri, thanks for the feedback.  I have moved it to 11.7.3.1.