Bug 1296320

Summary:	[SME] Need Quick Guide for DNS "quick install"
Product:	OpenShift Container Platform	Reporter:	Peter Larsen <plarsen>
Component:	Documentation	Assignee:	Vikram Goyal <vigoyal>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Vikram Goyal <vigoyal>
Severity:	unspecified	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	unspecified
Version:	3.1.0	CC:	aos-bugs, baulakh, jokerman, mmccomas
Target Milestone:	---	Keywords:	Reopened
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-12-24 11:05:09 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 Peter Larsen 2016-01-06 21:36:14 UTC

Document URL: https://docs.openshift.com/enterprise/3.1/install_config/install/prerequisites.html

Section Number and Name: https://docs.openshift.com/enterprise/3.1/install_config/install/prerequisites.html#prereq-dns 

Describe the issue: 

The pre-req section referred from the quickstart doesn't explain to a customer how to do a "quick start" DNS.  For users who just want to try out OpenShift who may not be network experts, having a quick section on how to configure something like DNSMASQ or libvirt to support a DNS wild-card would help customers get started without needing CE/Pre-sales help.

Suggestions for improvement: 

Add basic architecture for a quick-start installation with a single master and two nodes, and place a DNS service on a resource used by the install. For libvirt users, adding a simple file to /etc/NetworkManager/dnsmasq.d and using the local host file will satisfy the pre-req. VirtualBox and other virtualization solutions have similar quick ways of creating basic DNS.

The section should also have an "advanced" install that would explain how to do a full bind configuration with complete SOA records and named.conf examples. 

Additional information:

Comment 5 Vikram Goyal 2017-12-24 11:05:09 UTC

The 3.6 guide provided a quick start that included some of this information. I am going to close this bug and if more information is required, please reopen.

https://docs.openshift.com/container-platform/3.7/getting_started/index.html