Bug 778939

Summary: early draft of the SOA 5.0 ESB Administrators Guide needs proof reading
Product: [JBoss] JBoss Enterprise SOA Platform 5 Reporter: Dana Mison <dmison>
Component: DocumentationAssignee: Len DiMaggio <ldimaggi>
Status: CLOSED DUPLICATE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: unspecified   
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-1374
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: SOA-1374 Environment:
Last Closed: 2009-10-29 05:42:08 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:
Embargoed:
Attachments:
Description Flags
ESB_Administration_Guide.pdf
none
ESB_Administration_Guide.pdf none

Description Dana Mison 2009-06-17 08:17:51 UTC
++ This bug is a clone of bug 778938 ++

Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2009-06-17 07:24:24
project_key: SOA

pdf attached.

Please enter any comments against this JIRA

Comment 1 Len DiMaggio 2009-06-17 11:24:24 UTC
You forgot to attach the file.   ;-)



Comment 2 Dana Mison 2009-06-18 01:01:06 UTC
missing pdf found ;-)

Comment 3 Dana Mison 2009-06-18 01:01:06 UTC
Attachment: Added: ESB_Administration_Guide.pdf


Comment 4 Len DiMaggio 2009-07-13 18:17:28 UTC
Initial comments:

Section 1.2 JBossESB JMS Providers

Update references to supported JMS providers to be in synch with this page: https://docspace.corp.redhat.com/clearspace/docs/DOC-21829

Change "it's" to "its" in: Each JMSListener and JMSGateway can be configured to use it's own..."

Section 1.2.3 IBM Websphere MQ Series 

Update references to supported IBM MQ releases to be in synch with this page: https://docspace.corp.redhat.com/clearspace/docs/DOC-21829  (we've never tested with MQ 5.3)

1.2.5 Tibco Enterprise Message Services

Update references to supported Tibco releases to be in synch with this page: https://docspace.corp.redhat.com/clearspace/docs/DOC-21829  

1.3 Database Configuration and 1.4 Switching Databases

Manual steps should be replaced with a reference to the schema tool (jboss-as/tools/schema)

Section 1.181 Installing and Configuring OpenSSO in Tomcat

Examples 1.1 and 1.2 (Adding max size to JAVA_OPTS) are duplicates of each other. Also, these examples don't belong in this section. They should be removed.

We should also add a note indicating that RHEL customers can install the tomcat package instead of downloading tomcat.

Section 6.1.1 Alternative Database Use

Manual steps should be replaced with a reference to the schema tool (jboss-as/tools/schema)

Section/Chapter 6

We'll need a whole new chapter - the jbossesb console is being replaced by a new console built on JOPR

Section 6.3

This section will also need changes - need to synch it up with JON and ESB plugin changes. One new feature will be for JON alert is setup to fire if an individual message's processing time exceeds N seconds.  In SOA-P 4.3, JON only looks at message averages. I don't know yet if new metrics will also be collected.




Comment 5 David Le Sage 2009-10-08 04:56:39 UTC
Section 1.2 JBossESB JMS Providers

Update references to supported JMS providers to be in synch with this page: https://docspace.corp.redhat.com/clearspace/docs/DOC-21829 


DONE.

Comment 6 David Le Sage 2009-10-08 04:57:06 UTC
Update references to supported JMS providers to be in synch with this page: https://docspace.corp.redhat.com/clearspace/docs/DOC-21829

Change "it's" to "its" in: Each JMSListener and JMSGateway can be configured to use it's own..." 



DONE.

Comment 7 David Le Sage 2009-10-08 05:00:26 UTC
Section 1.2.3 IBM Websphere MQ Series

Update references to supported IBM MQ releases to be in synch with this page: https://docspace.corp.redhat.com/clearspace/docs/DOC-21829 (we've never tested with MQ 5.3) 


DONE.

Comment 8 David Le Sage 2009-10-08 05:01:52 UTC
1.2.5 Tibco Enterprise Message Services

Update references to supported Tibco releases to be in synch with this page: https://docspace.corp.redhat.com/clearspace/docs/DOC-21829 


DONE.

Comment 9 David Le Sage 2009-10-08 05:06:20 UTC
1.3 Database Configuration and 1.4 Switching Databases

Manual steps should be replaced with a reference to the schema tool (jboss-as/tools/schema) 



I WILL CREATE A NEW JIRA FOR THIS AS WE NEED INFORMATION FROM SUBJECT MATTER EXPERTS.

Comment 10 David Le Sage 2009-10-08 05:15:38 UTC
Section 1.181 Installing and Configuring OpenSSO in Tomcat

Examples 1.1 and 1.2 (Adding max size to JAVA_OPTS) are duplicates of each other. Also, these examples don't belong in this section. They should be removed.

We should also add a note indicating that RHEL customers can install the tomcat package instead of downloading tomcat. 



DONE.

Comment 11 David Le Sage 2009-10-08 05:19:53 UTC
Section/Chapter 6

We'll need a whole new chapter - the jbossesb console is being replaced by a new console built on JOPR 


I WILL OPEN A NEW JIRA FOR THIS SINCE WE WILL NEED INFORMATION FROM SUBJECT MATTER EXPERTS UPSTREAM.

Comment 12 David Le Sage 2009-10-08 05:22:41 UTC
Section 6.3

This section will also need changes - need to synch it up with JON and ESB plugin changes. One new feature will be for JON alert is setup to fire if an individual message's processing time exceeds N seconds. In SOA-P 4.3, JON only looks at message averages. I don't know yet if new metrics will also be collected. 




I WILL OPEN A NEW JIRA FOR THIS SINCE WE WILL NEED INFORMATION FROM SUBJECT MATTER EXPERTS UPSTREAM. 

Comment 13 David Le Sage 2009-10-08 22:37:43 UTC
1.3 Database Configuration and 1.4 Switching Databases

Manual steps should be replaced with a reference to the schema tool (jboss-as/tools/schema) 


BY FOLDING IN THE CHANGES DARRIN ADDED TO THE 4.3 CP02 DOC, THIS INFORMATION SHOULD NOW BE ACCURATE.

Comment 14 David Le Sage 2009-10-08 22:39:35 UTC
Latest version of 5.0 Administration Guide is now attached. Made changes requested by Len, as per the above, folded in changes from 4.3 CP02 and lots of grammar corrections throughout.

Comment 15 David Le Sage 2009-10-08 22:39:35 UTC
Attachment: Added: ESB_Administration_Guide.pdf


Comment 16 David Le Sage 2009-10-08 22:40:47 UTC
Please check latest version.  See comments above for the changes I have made based upon your feedback.

Comment 17 Dana Mison 2009-10-29 05:42:08 UTC
Closed.  Further feedback should go to SOA-1531