Bug 779634 (SOA-2004) - QE Review - Administration Guide
Summary: QE Review - Administration Guide
Keywords:
Status: CLOSED NEXTRELEASE
Alias: SOA-2004
Product: JBoss Enterprise SOA Platform 4
Classification: JBoss
Component: Documentation
Version: 4.3 CP04 ER1
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: 4.3 CP04 CR1
Assignee: David Le Sage
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-03-22 00:24 UTC by David Le Sage
Modified: 2010-05-13 12:14 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2010-05-13 12:14:34 UTC
Type: Task


Attachments (Terms of Use)
jon_metric_disable_2.png (281.64 KB, image/png)
2010-05-05 15:05 UTC, Len DiMaggio
no flags Details
jon_metric_disable_1.png (248.15 KB, image/png)
2010-05-05 15:05 UTC, Len DiMaggio
no flags Details
Screenshot.png (236.64 KB, image/png)
2010-05-11 13:40 UTC, Len DiMaggio
no flags Details
updated_JON.jpg (191.75 KB, image/jpeg)
2010-05-12 19:43 UTC, Len DiMaggio
no flags Details


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

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.



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