Bug 498090

Summary:	Add to documentation on cluster setup
Product:	Red Hat Enterprise MRG	Reporter:	Mike Cressman <mcressma>
Component:	Messaging_Programming_Reference	Assignee:	Alison Young <alyoung>
Status:	CLOSED CURRENTRELEASE	QA Contact:	MRG Quality Engineering <mrgqe-bugs>
Severity:	medium	Docs Contact:
Priority:	high
Version:	1.1	CC:	alyoung
Target Milestone:	1.3	Keywords:	Documentation
Target Release:	---
Hardware:	All
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2011-03-17 05:03:53 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:

Description Mike Cressman 2009-04-28 20:14:35 UTC

Description of problem:

A couple clarifications on the documentation in section 7.1 (Messaging Clusters), "Starting the AIS service":

* at the end of number 3., the line reads "The subnet is the bitwise AND of the mask and the local address, 192.168.1.255".  The mask is 255.255.255.0 and the local address is 192.168.1.103, so the bitwise AND should be 192.168.1.0, not 192.168.1.255.

* from the example in number 2., the mcastport setting (in this case 5405) requires that your firewall is set up to allow port 5405/udp.  Otherwise the ais service won't start correctly.


Version-Release number of selected component (if applicable):
1.1 Messaging User Guide

Comment 1 Jonathan Robie 2009-09-09 15:07:16 UTC

This now says the following:

The bindnetaddr entry should be set to the subnet you will use for cluster multicast. Use the same subnet for for all hosts in the cluster. You can find the subnet with /sbin/ifconfig. For example:

# /sbin/ifconfig eth0
  eth0      Link encap:Ethernet  HWaddr 00:1E:37:88:72:8A  
            inet addr:192.168.1.103  Bcast:192.168.1.255  Mask:255.255.255.0

In this case the local address is 192.168.1.103 and the subnet mask is 255.255.255.0. The bindnetaddr should be set to the bitwise AND of the mask and the local address. For this example, it is 192.168.1.0.

Comment 4 Alison Young 2011-03-17 05:03:53 UTC

Closed as fix already implemented

Also closed due to bug being against unsupported book version and to clear off docs bug radar. If still applicable against current version (2.0), feel free reopen bug.