Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.
Bug 1383199 - [DOC] Overcloud domain names can be set per network
[DOC] Overcloud domain names can be set per network
Status: CLOSED CURRENTRELEASE
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation (Show other bugs)
10.0 (Newton)
Unspecified Unspecified
unspecified Severity high
: rc
: 11.0 (Ocata)
Assigned To: Dan Macpherson
RHOS Documentation Team
: Documentation, Triaged
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2016-10-10 03:36 EDT by Marius Cornea
Modified: 2017-05-31 06:33 EDT (History)
13 users (show)

See Also:
Fixed In Version:
Doc Type: Release Note
Doc Text:
With this update, different domain names can be used for the public and the internal networks. To set domain names per network, use the following heat template parameters: * CloudName: The DNS name of this cloud, for example: 'ci-overcloud.tripleo.org' * CloudNameInternal: The DNS name of this cloud's internal API endpoint, for example: 'ci-overcloud.internalapi.tripleo.org' * CloudNameStorage: The DNS name of this cloud's storage endpoint, for example: 'ci-overcloud.storage.tripleo.org' * CloudNameStorageManagement: The DNS name of this cloud's storage management endpoint, for example: 'ci-overcloud.storagemgmt.tripleo.org' * CloudNameCtlplane: The DNS name of this cloud's control plane endpoint, for example: 'ci-overcloud.management.tripleo.org'
Story Points: ---
Clone Of:
Environment:
Last Closed: 2017-05-31 06:33:59 EDT
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)


External Trackers
Tracker ID Priority Status Summary Last Updated
OpenStack gerrit 382886 None None None 2016-10-14 13:53 EDT

  None (edit)
Description Marius Cornea 2016-10-10 03:36:30 EDT
Description of problem:
Overcloud nodes VIP entries in /etc/hosts ignore the domain name set by CloudDomain parameter:

Version-Release number of selected component (if applicable):
openstack-tripleo-heat-templates-5.0.0-0.20160929150845.4cdc4fc.el7ost.noarch

How reproducible:
100%

Steps to Reproduce:
1. Deploy overcloud with CloudDomain: redhat.local paremeter
2. Check /etc/hosts entries on overcloud nodes

Actual results:
# HEAT_HOSTS_END
10.0.1.5	overcloud.storagemgmt.localdomain	# FQDN of the storage mgmt VIP
192.168.0.5	overcloud.ctlplane.localdomain	# FQDN of the ctlplane VIP
10.0.0.5	overcloud.internalapi.localdomain	# FQDN of the internal api VIP
10.0.0.129	overcloud.storage.localdomain	# FQDN of the storage VIP
172.16.18.25	overcloud.localdomain	# FQDN of the external VIP

Expected results:

# HEAT_HOSTS_END
10.0.1.5	overcloud.storagemgmt.redhat.local 	# FQDN of the storage mgmt VIP
192.168.0.5	overcloud.ctlplane.redhat.local 	# FQDN of the ctlplane VIP
10.0.0.5	overcloud.internalapi.redhat.local 	# FQDN of the internal api VIP
10.0.0.129	overcloud.storage.redhat.local 	# FQDN of the storage VIP
172.16.18.25	overcloud.redhat.local 	# FQDN of the external VIP

Additional info:
Also I believe they should be inside the HEAT_HOSTS_START - HEAT_HOSTS_END section.
Comment 2 Dan Sneddon 2016-10-14 13:53:16 EDT
This should be addressed by https://review.openstack.org/#/c/382886/
Comment 6 Raviv Bar-Tal 2016-11-02 10:35:14 EDT
Testing this bug produce the same problem as describe in bug description:
# HEAT_HOSTS_END
172.16.1.22	overcloud.storagemgmt.localdomain	# FQDN of the storage mgmt VIP
172.16.1.22	overcloud.ctlplane.localdomain	# FQDN of the ctlplane VIP
172.16.1.22	overcloud.internalapi.localdomain	# FQDN of the internal api VIP
172.16.1.22	overcloud.storage.localdomain	# FQDN of the storage VIP
172.16.1.22	overcloud.localdomain	# FQDN of the external VIP
Comment 7 Dmitry Tantsur 2016-11-02 12:34:59 EDT
Bob, could you please take a look?
Comment 8 Bob Fournier 2016-11-02 17:04:29 EDT
The VIPs actually don't use CloudDomain, they have specific parameters defined
in overcloud.j2.yaml

  CloudName:
    default: overcloud.localdomain
    description: The DNS name of this cloud. E.g. ci-overcloud.tripleo.org
    type: string
  CloudNameInternal:
    default: overcloud.internalapi.localdomain
    description: >
      The DNS name of this cloud's internal API endpoint. E.g.
      'ci-overcloud.internalapi.tripleo.org'.
    type: string
  CloudNameStorage:
    default: overcloud.storage.localdomain
    description: >
      The DNS name of this cloud's storage endpoint. E.g.
      'ci-overcloud.storage.tripleo.org'.
    type: string
  CloudNameStorageManagement:
    default: overcloud.storagemgmt.localdomain
    description: >
      The DNS name of this cloud's storage management endpoint. E.g.
      'ci-overcloud.storagemgmt.tripleo.org'.
    type: string
  CloudNameCtlplane:
    default: overcloud.ctlplane.localdomain
    description: >
      The DNS name of this cloud's storage management endpoint. E.g.
      'ci-overcloud.management.tripleo.org'.

As can be seen, these are the values in /etc/hosts
10.0.1.5	overcloud.storagemgmt.localdomain	# FQDN of the storage mgmt VIP
192.168.0.5	overcloud.ctlplane.localdomain	# FQDN of the ctlplane VIP
10.0.0.5	overcloud.internalapi.localdomain	# FQDN of the internal api VIP
10.0.0.129	overcloud.storage.localdomain	# FQDN of the storage VIP
172.16.18.25	overcloud.localdomain	# FQDN of the external VIP  

So in order the change the VIP entries in /etc/hosts, these parameters need to be overwritten in a template file. Changing CloudDomain will have no affect on the VIP entries.

I recommend closing this and creating an RFE if the desired behavior
is to use CloudDomain to replace the value of "localdomain" in all the VIP entries, I believe that may be a significant change.
Comment 9 Dmitry Tantsur 2016-11-03 05:50:50 EDT
Ok, converting on an RFE. Thanks for looking into it Bob!
Comment 10 Raviv Bar-Tal 2016-11-03 09:44:33 EDT
I order to he set the VIP's FQDN you need to add the following to your environment file (example):
CloudName: "overcloud.redhat.local"
CloudNameInternal: "overcloud.internalapi.redhat.local"
CloudNameStorage: "overcloud.storage.redhat.local"
CloudNameStorageManagement: "overcloud.storagemgmt.redhat.local"

This will configure /etc/hosts on the overcloud nodes like:
# HEAT_HOSTS_END
172.16.1.22	overcloud.storagemgmt.redhat.local	# FQDN of the storage mgmt VIP
172.16.1.22	overcloud.ctlpane.redhat.local	# FQDN of the ctlplane VIP
172.16.1.22	overcloud.internalapi.redhat.local	# FQDN of the internal api VIP
172.16.1.22	overcloud.storage.redhat.local	# FQDN of the storage VIP
172.16.1.22	overcloud.redhat.local	# FQDN of the external VIP

In stack update scenario the hosts entries will be added in addition to the existing ones.
Comment 11 Marius Cornea 2016-11-03 11:33:53 EDT
A quick update on this one: Juan proposed it this way initially but this approach was rejected - https://review.openstack.org/#/c/357765/1..32/overcloud.yaml 

Different domain names could be used for the public and the internal networks respectively so it makes sense to be able to pass different domain names per network. 

I think we can go with a docs bug and document these parameters.
Comment 13 Dan Macpherson 2017-05-31 01:17:11 EDT
These are now documented as a part of the Core Overcloud Parameters:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/11/html/overcloud_parameters/core_overcloud_parameters

Marius, does this suit what was required with this BZ?
Comment 14 Marius Cornea 2017-05-31 03:41:18 EDT
(In reply to Dan Macpherson from comment #13)
> These are now documented as a part of the Core Overcloud Parameters:
> 
> https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/11/
> html/overcloud_parameters/core_overcloud_parameters
> 
> Marius, does this suit what was required with this BZ?

It looks good. Thank you, Dan!
Comment 15 Dan Macpherson 2017-05-31 06:33:59 EDT
Thanks, marius!

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