Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 651618

Summary:	The example of running multiple brokers needs to be clarified.
Product:	Red Hat Enterprise MRG	Reporter:	Ken Giusti <kgiusti>
Component:	Messaging_Installation_and_Configuration_Guide	Assignee:	Alison Young <alyoung>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Frantisek Reznicek <freznice>
Severity:	medium	Docs Contact:
Priority:	low
Version:	beta	CC:	esammons, freznice, iboverma, lbrindle
Target Milestone:	1.3.2
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2011-02-14 01:20:48 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	652506
Bug Blocks:

Description Ken Giusti 2010-11-09 22:11:29 UTC

Description of problem:


In Chapter 2. Starting the Broker, section Running multiple brokers on a single machine:  

The example shows use of the "-p 0" parameter to identify unused ports.  This is correct, however, the broker must be stopped and restarted between the successive invocations given in the example.

Specifically, instead of:

$ qpidd -p 0
40882

$ qpidd -p 0
45672

the example should indicate that a CNTRL+C is pressed between the two commands:

$ qpidd -p 0
40882
CNTRL+C
$ qpidd -p 0
45672
CNTRL+C

Attempting to run two "qpidd -p 0" on a single system will fail on the second instance.

Comment 1 Lana Brindley 2011-02-02 23:52:15 UTC

This will be handled as part of the 1.3.2 tech review.

LKB

Comment 2 Alison Young 2011-02-04 02:35:03 UTC

Changes in revision 4-6, build: Red_Hat_Enterprise_MRG-Messaging_Installation_Guide-1.3-web-en-US-4-6.el5

<para>
  To run more than one broker on a single machine, they must run on different ports and use different directories for the journals. The broker must be stopped and restarted between the invocations shown below.
</para>
<listitem>
  <para>
    Identify an available port by using the <command>-p</command> with a value of <parameter>0</parameter> (zero): 
<screen>
$ qpidd -p 0
40882
CTRL+C
</screen>
<screen>
$ qpidd -p 0
45672
CTRL+C
</screen>
  </para>

Comment 4 Frantisek Reznicek 2011-02-10 09:56:12 UTC

The change was added to MRG/M IG Revision 4-6 (on docs stage atm).

-> VERIFIED