Bug 778578 (SOA-1050)

Summary: Cleanup ESB jBPM Integration Guide
Product: [JBoss] JBoss Enterprise SOA Platform 4 Reporter: Dana Mison <dmison>
Component: DocumentationAssignee: Martin Vecera <mvecera>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: 4.2 CP02   
Target Milestone: ---   
Target Release: 4.2 CP03   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-1050
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-01-13 03:11:46 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:
Bug Depends On:    
Bug Blocks: 778658    

Description Dana Mison 2008-11-21 03:59:54 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2008-12-08 04:17:51
project_key: SOA

* 28 code samples to update
* 12 images to check

Comment 1 Dana Mison 2008-12-08 02:17:42 UTC
updated content as refered to in JBESB-2222


Comment 2 Dana Mison 2008-12-08 02:18:14 UTC
Link: Added: This issue is related to JBESB-2222


Comment 3 Kevin Conner 2008-12-08 09:17:51 UTC
JBESB-2222 has been rejected by the ESB project as the documentation is still applicable.

Comment 4 Dana Mison 2008-12-09 06:08:28 UTC
content updated

Comment 5 Dana Mison 2008-12-15 04:40:43 UTC
Link: Added: This issue is related to SOA-1067


Comment 6 Len DiMaggio 2008-12-16 16:36:39 UTC
Assigning to QE for review



Comment 7 Martin Vecera 2008-12-17 13:23:04 UTC
* Images resolution is really bad. I don't consider a representative guide.
* quick start -> quickstart
* page 9 - code sample is not up to date
* page 10/11 - deployment.xml sample not up to date
* Page 11: JbossMessaging -> JBossMessaging
* page 11 - second jboss-esb.xml sample not up to date
* page 12 - hibernate.cfg.xml samlpe not ^2date

* pages 18,19 - code samples come from bpm_orchestration4
* Chapter 2. refers to bpm_orchestration4 which is not intentionally present in 4.2.CP03 (bpm_orchestration4 was first introduced in version 4.3)


Comment 8 Dana Mison 2008-12-18 02:44:01 UTC
Link: Added: This issue related SOA-1083


Comment 9 Dana Mison 2008-12-18 02:59:52 UTC
Code sample chapter 1,section 1.2 Integration Configuration updated to match jboss-as/server/production/deploy/jbpm.esb/jbpm-service.xml

Comment 10 Dana Mison 2008-12-18 03:03:00 UTC
Code sample chapter 1, section 1.2 Integration Configuration

<jbossesb-deployment>
  <depends>jboss.esb:deployment=jbossesb.esb</depends>
  <depends>jboss.jca:service=DataSourceBinding,name=JbpmDS</depends>
</jbossesb-deployment>

updated to:
<jbossesb-deployment>
  <depends>jboss.esb:deployment=jbossesb.esb</depends>
  <depends>jboss.jca:service=DataSourceBinding,name=JbpmDS</depends>
  <depends>jboss.esb:service=JBPMDatabaseInitializer</depends>
</jbossesb-deployment>


Comment 11 Dana Mison 2008-12-18 03:14:21 UTC
Code sample chapter 1, section 1.2 Integration Configuration 
last code sample: updated jms-provider to jms-jca-provider as per jboss-as/server/production/deploy/jbpm.esb/META-INF/jboss-esb.xml



Comment 12 Dana Mison 2008-12-18 03:22:54 UTC
Code sample chapter 1, section 1.2 Integration Configuration , hibernate.cfg.xml

Added <property name="jta.UserTransaction">UserTransaction</property>


Comment 13 Dana Mison 2008-12-18 03:23:54 UTC
Corrected quickstart & JBossMessaging typos

Comment 14 Dana Mison 2008-12-18 03:28:31 UTC
Not much I can do about the image quality, combination of having to shrink down images to the page constraints (440px wide) and limitations of the the pdf tool (Apache FOP).  You'll notice that most of the images look better in the html versions

Comment 15 Dana Mison 2008-12-18 03:34:36 UTC
updated pdf checked into SVN.  please confirm fixes are correct

I don't think there is much we can do about the bpm_orchestration4 quickstart references at this point.  Created SOA-1083 for future.

Comment 16 Dana Mison 2009-01-04 23:27:27 UTC
content updated awaiting QE

Comment 17 Martin Vecera 2009-01-08 14:52:35 UTC
Please assign the issue back to QE next time when you are awaiting QE's action.

Comment 18 Martin Vecera 2009-01-08 15:57:29 UTC
Still present:
* quick start -> quickstart

We are fine with these because 4.2.0 CP02 also refers to bpm_orchestration4 and customers were said to download it separately.
* pages 18,19 - code samples come from bpm_orchestration4
* Chapter 2. refers to bpm_orchestration4 which is not intentionally present in 4.2.CP03 (bpm_orchestration4 was first introduced in version 4.3)


Comment 20 Dana Mison 2009-01-09 09:48:12 UTC
FIXED: quick start -> quickstart

waiting on the correct URL that should be used for the download link for the quickstart

Comment 21 Len DiMaggio 2009-01-09 17:06:50 UTC
Assigning to Martin to verify and close.

Comment 22 Dana Mison 2009-01-12 09:37:40 UTC
using 
http://anonsvn.labs.jboss.com/labs/jbossesb/branches/JBESB_4_2_1_GA_CP2/product/samples/quickstarts/bpm_orchestration4/

as the download source for the quickstart

Comment 23 Len DiMaggio 2009-01-13 03:11:46 UTC
Verified from https://svn.corp.jboss.com/repos/soa/branches/4.2.0/build-tools/docs

Comment 24 Dana Mison 2009-01-14 09:53:37 UTC
Link: Added: This issue is a dependency of SOA-1133