Bug 779784 (SOA-2145)

Summary: Documentation on how to use ServiceInvoker remotely needs to be reworked
Product: [JBoss] JBoss Enterprise SOA Platform 5 Reporter: Martin Weiler <mweiler>
Component: DocumentationAssignee: David Le Sage <dlesage>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: urgent Docs Contact:
Priority: urgent    
Version: 5.0.0 GA   
Target Milestone: ---   
Target Release: 5.1.0 GA   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-2145
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-01-31 06:32:18 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 Weiler 2010-07-09 10:15:43 UTC 
Affects: Documentation (Ref Guide, User Guide, etc.), Release Notes
Complexity: High
Help Desk Ticket Reference: https://access.redhat.com/issue-tracker/1106943
project_key: SOA

Chapter 6.1.5 lists the jars and config files to use the ServiceInvoker in a remote client:

http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/5.0.1/html/Programmers_Guide/chap-SOA_ESB_Programmers_Guide-Example.html#sect-SOA_ESB_Programmers_Guide-Configuration_for_a_Remote_Service_Invoker

However, these instructions could be improved as they are
1. incorrect - some jar files have different version numbers, others are missing
2. unclear - where are the jars/configs? what should be in the xml files?

For #1, the following listed jars have a wrong version number in SOA-P 5.0.1:
juddi-core-3.0.0.aop.jar => juddi-core-3.0.1.jar
juddi-ws-3.0.0.jar  => missing in SOA-P 5.0.1
stax-api-1.0.1.jar => stax-api-1.0.2.jar
scout-1.2.aop.jar => scout-1.2.1.jar
wstx-asl-3.2.0.jar => wstx.jar
jboss-aop-jdk50.jar => missing in SOA-P 5.0.1

For #2, it would be nice to group them according to where they could be found:
- $SOA_HOME/jboss-as/client/
- $SOA_HOME/jboss-as/common/lib/
- $SOA_HOME/jboss-as/server/$SOA_CONF/deployers/esb.deployer/lib/
- etc.

In addition, a note should be added that the listed *.xml files could be taken from the quickstarts directory.
Comment 1 Anne-Louise Tangring 2010-09-22 12:20:37 UTC 
Candidate for SOA 5.1.0
Comment 2 Anne-Louise Tangring 2010-12-06 16:24:18 UTC 
Usability and customer sat is important, thus this is made a blocker for SOA 5.1.
Comment 3 Dana Mison 2010-12-17 01:54:36 UTC 
Labels: Added: ESB_Programmers_Guide
Complexity: Added: High
Affects: Added: [Documentation (Ref Guide, User Guide, etc.), Release Notes]
Comment 5 Dana Mison 2011-01-05 00:12:14 UTC 
Writer: Added: Darrin
Comment 6 Dana Mison 2011-01-26 23:30:28 UTC 
can you make sure the version numbers of the JAR files are up to date ?  

Then clone this JIRA with the remaining items & set the FixVersion to FUTURE 

Thanks.
Comment 7 David Le Sage 2011-01-31 06:30:08 UTC 
Link: Added: This issue Cloned to SOA-2857
Comment 8 David Le Sage 2011-01-31 06:32:18 UTC 
Release Notes Text: Added: Version numbers updated.  Will merge into project doc.
Comment 9 Dana Mison 2011-02-03 08:30:21 UTC 
Release Notes Text: Removed: Version numbers updated.  Will merge into project doc.
Comment 10 Dana Mison 2011-02-17 11:23:18 UTC 
Release Notes Docs Status: Added: Not Required