Bug 1658267

Summary:	[DOC] Need to highlight the importance of setting hostname on the node before installing.
Product:	OpenShift Container Platform	Reporter:	Ryan Howe <rhowe>
Component:	Documentation	Assignee:	Latha S <lmurthy>
Status:	CLOSED WONTFIX	QA Contact:	Xiaoli Tian <xtian>
Severity:	high	Docs Contact:	Latha S <lmurthy>
Priority:	unspecified
Version:	3.11.0	CC:	aos-bugs, mburke, mmccomas
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2022-08-08 09:55:34 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Ryan Howe 2018-12-11 16:24:47 UTC

Document URL: 
https://docs.openshift.com/container-platform/3.11/install/host_preparation.html

Section Number and Name: 
https://docs.openshift.com/container-platform/3.11/install/host_preparation.html

Describe the issue: 

In 3.10 and + we do not allow the overwriting of openshift_hostname via the installer any longer, there are many many issues with hostnames not being correct when installing the cluster. 

We need information on how to confirm what hostname and nodename will be used before an install when installing with cloud-provider or with out cloud-provider. 

Basically we should outline that `hostname -f` will be used as the nodename and name on the server certs for the nodes and masters. We should state that this should be set to the FQDN. 

# hostnamectl set-hostname <NODE_FQDN> 

Then for cloud-provider enabled cluster we should state more clearly what hostname and nodenames will be used, and state that best practice is to make sure `hostname -f` also gets set to this to avoid confusion. 


Additional information: 
KCS with some details: 
https://access.redhat.com/solutions/3738701

Comment 4 Michael Burke 2022-03-23 19:29:36 UTC

If we address this issue, should we also address "Document that hosts with uppercase letters are not supported" in https://bugzilla.redhat.com/show_bug.cgi?id=1632223