Bug 760229

Summary: Update default max file size for store and improve some wording
Product: Red Hat Enterprise MRG Reporter: Kim van der Riet <kim.vdriet>
Component: Messaging_Programming_ReferenceAssignee: Joshua Wulf <jwulf>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: medium Docs Contact:
Priority: unspecified    
Version: DevelopmentCC: jskeoch, lcarlon
Target Milestone: 2.2   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-09-20 03:13:34 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Kim van der Riet 2011-12-05 16:51:28 UTC 
Store checkin r.4485 (which will be in the Qpid 0.16 release) changes the maximum file size for the --jfile-size-pgs and --tpl-jfile-size-pgs parameters from 32768 to 32767 to avoid a problem with 32-bit RHEL (see BZ 759575 for details on this).

In addition, the description for the size of the store needs to be clarified in the Messaging Users Guide, table 6.2. Persistence Options.

The current text for --num-jfiles and --jfile-size-pgs reads:

"The total size of each journal is num-jfiles * jfile-size-pgs."

This is true, but misleading as this will give the size not in bytes but in 64k pages. I suggest it is changed to the following in both cases:

"The total size of each journal is num-jfiles * jfile-size-pgs * 64 * 1024 bytes."
Comment 1 Kim van der Riet 2011-12-05 16:54:49 UTC 
It may be a good idea to also give the min and max allowable values for --num-jfiles, --tpl-num-jfiles, --jfile-size-pgs and --tpl-jfile-size-pgs in the Installation Guide, Table 4.1. Persistence Options.
Comment 2 Kim van der Riet 2011-12-05 16:56:14 UTC 
(In reply to comment #1)
> It may be a good idea to also give the min and max allowable values for
> --num-jfiles, --tpl-num-jfiles, --jfile-size-pgs and --tpl-jfile-size-pgs in
> the Installation Guide, Table 4.1. Persistence Options.

Correction, the tp-* options are not listed in this table, so only the regular options.
Comment 3 Joshua Wulf 2012-05-01 10:54:40 UTC 
http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Installation_and_Configuration_Guide/index.html#Persistence_Options
Comment 5 Cheryn Tan 2012-09-20 02:54:26 UTC 
Released for MRG 2.2