Bug 2214441

Summary:	[DDF] How about appending "DO NOT SET THE MAC ADDRESS OF IPMI INTERFACE" ?
Product:	Red Hat OpenStack	Reporter:	Direct Docs Feedback <ddf-bot>
Component:	documentation	Assignee:	RHOS Documentation Team <rhos-docs>
Status:	NEW ---	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	urgent	Docs Contact:
Priority:	urgent
Version:	17.0 (Wallaby)	CC:	joflynn, knoha
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:		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 Direct Docs Feedback 2023-06-13 01:51:44 UTC

How about appending "DO NOT SET THE MAC ADDRESS OF IPMI INTERFACE" ?

I've seen some support cases where some customer misconfigured the MAC address of IPMI interfaces to "host_mac" address.
This misconfiguration causes lack of STONITH configuration in overcloud.
Additionally, its troubleshooting is a bit difficult because no errors appear even if we misconfigure "host_mac".

I believe it's good to state "do not configure the MAC address of IPMI interface" here to prevent this issue.

Reported by: rhn-support-yatanaka

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/17.0/html/high_availability_deployment_and_usage/assembly_fencing-controller-nodes_rhosp#annotations:c5f9f366-39f5-4567-8819-a8f9232c4eaf

Comment 1 Keigo Noha 2023-06-13 01:57:05 UTC

I completely agree the suggestion from Tanka-san who is a reporter of this bug.

The troubleshooting of this issue require the tremendous time to review of templates/sosreport and hieradata.
We need to emphasize that point strongly.

Also, this will happen once OSP17.1 GA without the warning.

Please fix add the statement to prevent the future issue quickly.