Bug 1119667

Summary: Document PicketLink STSClient pool as unsupported feature
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: Hynek Mlnarik <hmlnarik>
Component: DocumentationAssignee: Scott Mumford <smumford>
Status: CLOSED CURRENTRELEASE QA Contact: Hynek Mlnarik <hmlnarik>
Severity: high Docs Contact:
Priority: unspecified    
Version: 6.3.0CC: jcacek, jdoyle, lcosti, nsriniva, pslavice, smumford
Target Milestone: GA   
Target Release: EAP 6.3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-08-06 14:40:10 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 Hynek Mlnarik 2014-07-15 09:09:59 UTC
The PicketLink STSClient pool feature (bug 1069126) will be present in EAP 6.3.0 as an unsupported feature. Please document it accordingly.

This obsoletes bug 1108046 for 6.3.0 release.

Comment 1 Scott Mumford 2014-07-25 03:20:14 UTC
The content created for bug 1108046 (topic 41096) has been incorporated into the Unsupported Features section of the Release Notes.

I did not remove the content from the Security Guide as associate Josh Wulf is the owner of that book.

Comment 2 Scott Mumford 2014-07-25 05:47:53 UTC
A new version of the Release Notes is available for review at:
https://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/6.3.0_Release_Notes/index.html
(ensure you're reviewing version 6.3.0-17)

Brew task:
http://brewweb.devel.redhat.com/brew/taskinfo?taskID=7735113

Comment 3 Josef Cacek 2014-07-25 11:22:17 UTC
Verification failed. There are minor issues in the text.

Description starts with
"The PicketLink subsystem provides ..."
but it should be
"The PicketLink provides ..."

Fix code snippets (indentation is not correct and "fact" must be replaced with "pool"):
 
1)
final STSClientPool pool = STSClientPoolFactory.getPoolInstance();
pool.createPool(20, stsClientConfig);
final STSClient client = pool.getClient(stsClientConfig);

2)
pool.returnClient()

3)
if (! pool.configExists(stsClientConfig) {  
    pool.createPool(stsClientConfig);  
}

4)
pool.destroyPool(stsClientConfig);

Comment 4 Josef Cacek 2014-07-25 11:26:17 UTC
And one more issue. Replace

"When the PicketLink Federation subsystem is enabled, all client pools are destroyed."

with something like

"When the PicketLink Federation subsystem is enabled, all client pools created for a deploymet are destroyed automatically during the undeploy."

Comment 7 Lucas Costi 2014-07-31 04:09:39 UTC
Changes from comments 3 and 4 are now on-stage and ready for review (Revision 6.3.0-18):

https://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/6.3.0_Release_Notes/index.html

Comment 8 Josef Cacek 2014-07-31 08:36:44 UTC
Verified on docs-stage.
Revision 6.3.0-18