Bug 778631 (SOA-1107)

Summary: confusing jUDDI documentation in Services Guide
Product: [JBoss] JBoss Enterprise SOA Platform 4 Reporter: Dana Mison <dmison>
Component: DocumentationAssignee: Len DiMaggio <ldimaggi>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: 4.3 GA, 4.2 CP02   
Target Milestone: ---   
Target Release: 4.3 CP02   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-1107
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-09-21 17:40:12 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:
Bug Depends On: 777826    
Bug Blocks:    

Description Dana Mison 2009-01-05 06:57:06 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2009-03-09 13:13:35
project_key: SOA

From chapter 3 - Registry Configuration Examples, needs some clarification as it is a bit vague & confusing.

1 - it refers to a "jUDDI-registry directory" which cannot be found
2 - "An example file is supplied for MySQL." cannot be found
3 - juddi.war exists in at least 2 places & is uncertain as too which is being referred to.

jbossesb.sar allows RMI access only.

"juddi.war in jUDDI-registry directory"..."when deployed this brings up the regular webservices but also an RMI service"

"The juddi.war provides a RMI Service if enabled by the following setting in the web.xml" this can't be the same as the previous one unless the previous description is missing details.  It also has to be the exploded one in server/production/juddi-service.sar since it is the one with the commented out config shown.

Conclusion:
1  - deploying the juddi.war from jbossesb.sar provides webservice & RMI access (in addition to the RMI access from jbossesb.sar)
2 - deploying the juddi.war from juddi-service.sar provides webservice only (and RMI if enabled in web.xml)

Correct ?

Comment 1 tcunning 2009-03-09 17:13:35 UTC
From the first part, juddi.war is included in the ESB server and is included within jbossesb.sar, and the datasource is preconfigured.      I think we can remove that paragraph.

Ultimately, we have a conflict between the juddi provided by juddi-service.sar and jbossesb, so we need to do something about it (https://jira.jboss.org/jira/browse/SOA-353)

Comment 2 Dana Mison 2009-07-06 02:33:16 UTC
updated jUDDI-registry directory to point to jbossesb.sar/

removed reference to MySQL example

rewrote slightly to make it clearer.

note: juddi-server.sar is no longer included.

Comment 3 Dana Mison 2009-07-07 08:50:08 UTC
Link: Added: This issue is related to SOA-1398


Comment 4 Jiri Pechanec 2009-08-28 14:24:59 UTC
The text is still unclear

The jbossesb.sar registers a RMI service for jUDDI.

By default juddi.war only
provides webservice access but can be configured to also provide a RMI Service with the following
settings in the web.xml.

So I do not understand what will happen if both jbossesb.sar and juddi.war is present and RMI service is enabled in war. Is it allowed? Will be there two services? Are those RMI services same?


Comment 5 Dana Mison 2009-09-04 02:23:26 UTC
A developer needs to clarify what the intent of this content is

Comment 6 Len DiMaggio 2009-09-15 18:20:46 UTC
Link: Added: This issue depends SOA-353


Comment 7 Len DiMaggio 2009-09-15 18:50:59 UTC
Is the RMI service registered by jbossesb.sar not really a service, but the MBean that which stops and starts the registry?

So - there really is only one RMI service - that being the service in juddi.war that accepts requests?

Comment 8 Len DiMaggio 2009-09-15 20:32:40 UTC
From Tom:

My suggestion is to remove the section on providing RMI through the
WAR.        As Jiri says, RMI services are provided through
jbossesb.sar, so while it is technically possible to configure RMI for
juddi through the WAR, there's really no reason why you would want to
running in SOA-P.       As long as the services are registered with the
same name, I think they'd be the same, but I think showing users this
will be unnecessarily confusing and there's no real reason why a user
would want to do this in SOA-P.

Comment 9 Len DiMaggio 2009-09-15 20:34:14 UTC
Assigning back to Darrin to edit the doc - Darrin - can you edit the doc in time for CP02?


Comment 10 Dana Mison 2009-09-16 04:23:48 UTC
no promises but its on the list after the JON item

Comment 11 Dana Mison 2009-09-18 09:46:10 UTC
I've updated this in section, the pdf has been checked in & you can also look it at at:
http://downtown.englab.bne.redhat.com/docs/en-US/JBoss_SOA_Platform/4.3.CP02/html-single/Services_Guide/index.html#sect-SOA_ESB_Services_Guide-Configuring_Examples-RMI_using_the_juddi.war_or_jbossesb.sar

I noticed that once this was removed the only remaining reference to juddi.war was in Chapter 4. UDDI Browser.  
I don't know if that is a problem, we probably should have some content detailing what it is for, how to configure it etc.

*need to fix the page anchor names too, they are way too long & in this case, confusing

Comment 12 Len DiMaggio 2009-09-21 17:40:12 UTC
Closing as verified in CR4

1) juddi-service.sar was removed from the distribution in CR3 (SOA-353)

2) The confusing text was removed from the Services Guide

3) I think that we are all set with the references to the uddi browser and juddi.war - with CR4 installed, I was able to download the browser and just run it.