Bug 779784 (SOA-2145) - Documentation on how to use ServiceInvoker remotely needs to be reworked
Summary: Documentation on how to use ServiceInvoker remotely needs to be reworked
Keywords:
Status: CLOSED NEXTRELEASE
Alias: SOA-2145
Product: JBoss Enterprise SOA Platform 5
Classification: JBoss
Component: Documentation
Version: 5.0.0 GA
Hardware: Unspecified
OS: Unspecified
urgent
urgent
Target Milestone: ---
: 5.1.0 GA
Assignee: David Le Sage
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-07-09 10:15 UTC by Martin Weiler
Modified: 2011-02-17 11:23 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-01-31 06:32:18 UTC
Type: Task


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 780425 0 urgent CLOSED CLONE - Documentation on how to use ServiceInvoker remotely needs to be reworked 2021-02-22 00:41:40 UTC
Red Hat Issue Tracker SOA-2145 0 None None None Never

Internal Links: 780425

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



Note You need to log in before you can comment on or make changes to this bug.