8eff607f93
This has been around for a while and we might as well let people know about it. I need to find a more permanent location for it than my personal OpenShift account, but in the meantime we can link to the current one. Change-Id: I8e798f6859404e09ab598b01cb26b38433dd4bfc
131 lines
4.4 KiB
ReStructuredText
131 lines
4.4 KiB
ReStructuredText
Installing the Undercloud
|
|
--------------------------
|
|
|
|
#. Log in to your machine (baremetal or VM) where you want to install the
|
|
undercloud as a non-root user (such as the stack user)::
|
|
|
|
ssh <non-root-user>@<undercloud-machine>
|
|
|
|
.. note::
|
|
If you don't have a non-root user created yet, log in as root and create
|
|
one with following commands::
|
|
|
|
sudo useradd stack
|
|
sudo passwd stack # specify a password
|
|
|
|
echo "stack ALL=(root) NOPASSWD:ALL" | sudo tee -a /etc/sudoers.d/stack
|
|
sudo chmod 0440 /etc/sudoers.d/stack
|
|
|
|
su - stack
|
|
|
|
.. note::
|
|
The undercloud is intended to work correctly with SELinux enforcing, and
|
|
cannot be installed to a system with SELinux disabled. If SELinux
|
|
enforcement must be turned off for some reason, it should instead be set
|
|
to permissive.
|
|
|
|
.. note::
|
|
vlan tagged interfaces must follow the if_name.vlan_id convention, like for
|
|
example: eth0.vlan100 or bond0.vlan120.
|
|
|
|
.. admonition:: Baremetal
|
|
:class: baremetal
|
|
|
|
Ensure that there is a FQDN hostname set and that the $HOSTNAME environment
|
|
variable matches that value.
|
|
|
|
Use ``hostnamectl`` to set a hostname if needed::
|
|
|
|
sudo hostnamectl set-hostname myhost.mydomain
|
|
sudo hostnamectl set-hostname --transient myhost.mydomain
|
|
|
|
An entry for the system's FQDN hostname is also needed in /etc/hosts. For
|
|
example, if the system is named *myhost.mydomain*, /etc/hosts should have
|
|
an entry like::
|
|
|
|
127.0.0.1 myhost.mydomain myhost
|
|
|
|
|
|
#. Enable needed repositories:
|
|
|
|
.. admonition:: RHEL
|
|
:class: rhel
|
|
|
|
Enable optional repo::
|
|
|
|
sudo yum install -y yum-utils
|
|
sudo yum-config-manager --enable rhelosp-rhel-7-server-opt
|
|
|
|
.. include:: ../repositories.txt
|
|
|
|
.. We need to manually continue our list numbering here since the above
|
|
"include" directive breaks the numbering.
|
|
|
|
3. Install the yum-plugin-priorities package so that the Delorean repository takes precedence over the main RDO repositories::
|
|
|
|
sudo yum -y install yum-plugin-priorities
|
|
|
|
#. Install the TripleO CLI, which will pull in all other necessary packages as dependencies::
|
|
|
|
sudo yum install -y python-tripleoclient
|
|
|
|
#. Copy in the sample configuration file and edit it to reflect your environment::
|
|
|
|
cp /usr/share/instack-undercloud/undercloud.conf.sample ~/undercloud.conf
|
|
|
|
.. TODO(bnemec): Find a more permanent location for this tool.
|
|
.. note:: There is a tool available that can help with writing a basic
|
|
undercloud.conf:
|
|
`Undercloud Configuration Wizard <http://ucw-bnemec.rhcloud.com/>`_
|
|
It takes some basic information about the intended overcloud
|
|
environment and generates sane values for a number of the important
|
|
options.
|
|
|
|
#. Run the command to install the undercloud:
|
|
|
|
.. admonition:: Source
|
|
:class: source
|
|
|
|
Git checkouts of the puppet modules can be used instead of packages. Export the
|
|
following environment variable::
|
|
|
|
export DIB_INSTALLTYPE_puppet_modules=source
|
|
|
|
It is also possible to use this functionality to use an in-progress review
|
|
as part of the undercloud install. See
|
|
:doc:`../developer/in_progress_review` for details.
|
|
|
|
.. admonition:: SSL
|
|
:class: ssl
|
|
|
|
To deploy an undercloud with SSL, see :doc:`../advanced_deployment/ssl`.
|
|
|
|
.. admonition:: Validations
|
|
|
|
:doc:`../validations/validations` will be installed and
|
|
configured during undercloud installation. You can set
|
|
``enable_validations = false`` in ``undercloud.conf`` to prevent
|
|
that.
|
|
|
|
|
|
Install the undercloud::
|
|
|
|
openstack undercloud install
|
|
|
|
|
|
Once the install has completed, you should take note of the files ``stackrc`` and
|
|
``undercloud-passwords.conf``. You can source ``stackrc`` to interact with the
|
|
undercloud via the OpenStack command-line client. ``undercloud-passwords.conf``
|
|
contains the passwords used for each service in the undercloud. These passwords
|
|
will be automatically reused if the undercloud is reinstalled on the same system,
|
|
so it is not necessary to copy them to ``undercloud.conf``.
|
|
|
|
.. note::
|
|
Any passwords set in ``undercloud.conf`` will take precedence over the ones in
|
|
``undercloud-passwords.conf``.
|
|
|
|
.. note::
|
|
``openstack undercloud install`` can be rerun to reapply changes from
|
|
undercloud.conf to the undercloud. Note that this should **not** be done if an
|
|
overcloud has already been deployed or is in progress.
|