Bug 778573 (SOA-1045)

Summary: Clean up ESB Monitoring Guide
Product: [JBoss] JBoss Enterprise SOA Platform 4 Reporter: Dana Mison <dmison>
Component: DocumentationAssignee: Ondrej Skutka <oskutka>
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-1045
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-01-12 09:00:39 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
snapshot1.png none

Description Dana Mison 2008-11-21 03:54:00 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2008-12-16 11:39:55
project_key: SOA

* replace "About this guide" section with standard Red Hat JBoss front-matter
* update 3 screenshots to remove borders & "personal bookmark bar items"
* remove trailblazer reference

Comment 1 Dana Mison 2008-12-05 07:45:23 UTC
book updated

Comment 2 Len DiMaggio 2008-12-16 16:39:55 UTC
Assigning to QE for review



Comment 3 Ondrej Skutka 2008-12-17 12:19:16 UTC
The new screenshots are even uglier than the previous ones. Could you include higher quality screenshots?

Comment 4 Dana Mison 2008-12-18 01:39:08 UTC
What pdf viewer are you using, what version and on what operating system?

Please supply a screenshot of images in question at 100% image size

Comment 5 Ondrej Skutka 2008-12-18 07:22:45 UTC
in Adobe Reader 8.1.3, GNU/Linux

Comment 6 Ondrej Skutka 2008-12-18 07:22:45 UTC
Attachment: Added: snapshot1.png


Comment 7 Ondrej Skutka 2008-12-18 07:50:51 UTC
It looks the same in xpdf 3.02. And people don't read pdfs using 100 % zoom settings. They often use "fit width", which is even worse. 

PDF supports FlateDecode algorithm for storing images, so top-quality screenshots of text should not increase file size dramatically.

Comment 8 Dana Mison 2008-12-18 08:09:40 UTC
thanks for screenshot, gives me another reference for comparison.  I'm logging a bug regards image quality for our pdf generation toolchain.

Comment 9 Len DiMaggio 2009-01-08 15:08:10 UTC
Darrin - is this book done?



Comment 10 Dana Mison 2009-01-09 01:44:59 UTC
I closed this because I didn't think I would be able to resolve the image problems this release.

Turned out that I could.  I've updated the images in this book.  I think they are as good as they are going to get.

Comment 11 Ondrej Skutka 2009-01-09 07:20:13 UTC
- The images look much better now. Thanks.
Besides that:
- 1.1 Overview: 
stand-alone ESB server -> standalone ESB server
What are the percentage signs supposed to mean?
% cd tools/console/management-esb%
- Fig. 2.3 MessageCounter: Could you scale it down?

Comment 12 Dana Mison 2009-01-09 09:39:37 UTC
FIXED: stand-alone -> standalone
FIXED: the % are shell prompts, missed a linefeed in copy-paste, changed them to $ & fixed position
FIXED: hmmm, scaling it down made it look worse when viewed at greater than 100%, I made it wider so at 100% it scales down automatically & when viewer at greater it is closer to actual 100%.  Does that make any sense? ;-)

Also cleaned up the language in the overview a little

Comment 13 Ondrej Skutka 2009-01-09 14:18:09 UTC
1.1 Overview:
You're right that the whole paragraph needed to be rewritten, however this sentence looks awkward to me:
"The monitoring console is installed by default, but is simple to install manually if needed."
Maybe you should mention that it's installed in "all" configuration by default, but can be also simply installed into other configurations if needed.

By the way this deployment doesn't work now, I have created issue for it (SOA-1113).

Comment 14 Dana Mison 2009-01-12 02:56:47 UTC
updated overview & alternative database usage

Comment 15 Ondrej Skutka 2009-01-12 08:15:15 UTC
1.1.2. Collection Periods
Mbean -> MBean

Comment 16 Dana Mison 2009-01-12 08:45:19 UTC
FIXED 

(so need a custom jboss dictionary ;-) )