Bug 779634 (SOA-2004)

Summary: QE Review - Administration Guide
Product: [JBoss] JBoss Enterprise SOA Platform 4 Reporter: David Le Sage <dlesage>
Component: DocumentationAssignee: David Le Sage <dlesage>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: 4.3 CP04 ER1   
Target Milestone: ---   
Target Release: 4.3 CP04 CR1   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-2004
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-05-13 12:14:34 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:
Attachments:
Description Flags
jon_metric_disable_2.png
none
jon_metric_disable_1.png
none
Screenshot.png
none
updated_JON.jpg none

Description David Le Sage 2010-03-22 00:24:28 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2010-03-29 21:12:37
project_key: SOA

Please undertake a QE review of the Administration Guide to ensure that all documentation JIRA tasks have been undertaken correctly.

Comment 2 David Le Sage 2010-03-31 00:37:03 UTC
Len, as per IRC discussion, I have backported parts of the book now from 5.0. Only wording has changed, not factual data but please check!  Cheers and thanks.

Comment 3 Len DiMaggio 2010-03-31 13:00:01 UTC
=====================

We should add this section from the 5.0 Admin Guide: 1.1. Introduction to Basic Concepts to the 4.3 guide.

=====================

Section 1.4. JBoss ESB Java Message Service Providers from the 5.0 admin guide should replace 1.3. JMS Providers in the 4.3 guide

=====================

1.4. Database Configuration

We should remove the references to DB2.

=====================

Section 1.4.10. Switching Databases from the 5.0 admin guide should be added to the 4.3 guide.

=====================

Chapter 2 - The Registry

The warning at the end of the chapter in the 5.0 guide should be added to the 4.3 guide.

Warning
Note that this option should be used with care, because the entire service will be removed, including all end-point references.

=====================

Chapter 4 - Default "ReplyTo" Endpoint References in the 5.0 guide should replace chapter 4 in the 4.3 guide.

=====================

Chapter 5 - The ServiceBinding Manager in the 5.0 guide should replace chapter 5 in the 4.3 guide.

=====================

6.2. Monitoring and Management ESB Console

Screen shots needs updating - JBoss logos have changed.

=====================

6.4.1. Adding your JBoss SOA Platform Server to the JON Inventory

Need to update the screenshot to reflect CP03

=====================

Chapter 7 - Hot Deployment - in the 5.0 guide should replace chapter 7 in the 4.3 guide.

=====================

Chapter 10 - Performance Tuning - in the 5.0 guide should replace chapter 10 in the 4.3 guide.






Comment 4 David Le Sage 2010-04-01 00:46:05 UTC
All done except for:


6.4.1. Adding your JBoss SOA Platform Server to the JON Inventory 

Need to update the screenshot to reflect CP03 



Comment 5 Len DiMaggio 2010-04-05 11:10:21 UTC
Open pending final edits by David.

Comment 6 Len DiMaggio 2010-05-05 15:05:44 UTC
Need to update this section:

http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP03/Administration_Guide/html-single/#id4121223

To indicate that the values listed in red in the enclosed screenshots are disabled by default.

screenshot #1
   Service level message count average

screenshot #2
   Action level message count average
   Action level message failed average
   Action level messages successfully processed average


Comment 7 Len DiMaggio 2010-05-05 15:05:44 UTC
Attachment: Added: jon_metric_disable_2.png
Attachment: Added: jon_metric_disable_1.png


Comment 8 David Le Sage 2010-05-11 03:34:06 UTC
Done.  I have added the screenshots and content here:

http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP04/Administration_Guide/html-single/#JON_for_SOA

Comment 9 Len DiMaggio 2010-05-11 13:40:19 UTC
Sorry to be a pain - but the names of the new figures:

Figure 6.6. Metrics Disabled by Default One
Figure 6.7. Metrics Disabled by Default Two

Really should be changed - the titles that you used are from the screenshots that I attached to the JIRA, but those were just the filenames.   ;-)

How about:

Figure 6.6. Service Metrics Disabled by Default
Figure 6.7. Action Metrics Disabled by Default

Thanks!

Comment 10 Len DiMaggio 2010-05-11 13:40:19 UTC
Attachment: Added: Screenshot.png


Comment 11 David Le Sage 2010-05-12 04:41:20 UTC
Fixed - yes, thanks Len, I was trying to think of better names for those screenshots.

Cheers.

Comment 12 Len DiMaggio 2010-05-12 19:31:56 UTC
Those screenshots are fine - but the screenshot in 5.6 needs to be replaced - the one in the doc now is form an old versiun of JON. I will attach a up-to-date one to use...

Comment 13 Len DiMaggio 2010-05-12 19:43:45 UTC
Attachment: Added: updated_JON.jpg


Comment 14 Len DiMaggio 2010-05-12 19:52:50 UTC
Sorry - that's figure 6.5



Comment 15 David Le Sage 2010-05-13 04:41:59 UTC
Fixed.  Thanks for supplying that screenshot.  Greatly appreciated.