Bug 1296320 - [SME] Need Quick Guide for DNS "quick install"
[SME] Need Quick Guide for DNS "quick install"
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation (Show other bugs)
Unspecified Unspecified
unspecified Severity unspecified
: ---
: ---
Assigned To: Vikram Goyal
Vikram Goyal
Vikram Goyal
: Reopened
Depends On:
  Show dependency treegraph
Reported: 2016-01-06 16:36 EST by Peter Larsen
Modified: 2017-12-24 06:05 EST (History)
4 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2017-12-24 06:05:09 EST
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Description Peter Larsen 2016-01-06 16:36:14 EST
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 06:05:09 EST
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.


Note You need to log in before you can comment on or make changes to this bug.