Bug 778939 - early draft of the SOA 5.0 ESB Administrators Guide needs proof reading
Summary: early draft of the SOA 5.0 ESB Administrators Guide needs proof reading
Keywords:
Status: CLOSED DUPLICATE of bug 2040112
Alias: None
Product: JBoss Enterprise SOA Platform 5
Classification: JBoss
Component: Documentation
Version: unspecified
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: ---
Assignee: Len DiMaggio
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2009-06-17 08:17 UTC by Dana Mison
Modified: 2012-07-13 04:15 UTC (History)
0 users

Fixed In Version:
Clone Of: SOA-1374
Environment:
Last Closed: 2009-10-29 05:42:08 UTC
Type: Task
Embargoed:


Attachments (Terms of Use)
ESB_Administration_Guide.pdf (854.54 KB, application/pdf)
2009-06-18 01:01 UTC, Dana Mison
no flags Details
ESB_Administration_Guide.pdf (727.22 KB, application/pdf)
2009-10-08 22:39 UTC, David Le Sage
no flags Details


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker SOA-1374 0 None None None Never

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


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