openstack
/
tripleo-docs
Code Issues Proposed changes

Document use of undercloud_hostname 

undercloud_hostname is a less error-prone method of configuring all
the undercloud hostname settings correctly.  We probably want to
make it a mandatory option and avoid hostname-related bugs, but for
the moment let's at least document it as the preferred way to handle
hostname configuration.

Note that this option has existed since Mitaka, so it applies to
all of our currently supported branches.

Change-Id: I2506a44abac999d4b0450c402fe40cab89410cea
This commit is contained in:
Ben Nemec 2017-09-28 21:57:18 +00:00
parent 38f960c805
commit a5e1228425
1 changed files with 6 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/source/install/installation/installing.rst
View File

@ -32,9 +32,13 @@ Installing the Undercloud
:class: baremetal
Ensure that there is a FQDN hostname set and that the $HOSTNAME environment
variable matches that value.
variable matches that value. The easiest way to do this is to set the
``undercloud_hostname`` option in undercloud.conf before running the
install. This will allow the installer to configure all of the hostname-
related settings appropriately.
Use ``hostnamectl`` to set a hostname if needed::
Alternatively the hostname settings can be configured manually, but
this is strongly discouraged. The manual steps are as follows::
sudo hostnamectl set-hostname myhost.mydomain
sudo hostnamectl set-hostname --transient myhost.mydomain