Procedure

1. Log into your undercloud as the root user.

2. Create the stack user:

   [root@director ~]# useradd stack

3. Set a password for the user:

   [root@director ~]# passwd stack

4. Disable password requirements when using sudo:

   [root@director ~]# echo "stack ALL=(root) NOPASSWD:ALL" | tee -a /etc/sudoers.d/stack
   [root@director ~]# chmod 0440 /etc/sudoers.d/stack

5. Switch to the new stack user:

   [root@director ~]# su - stack
   [stack@director ~]$

Procedure

1. Check the base and full hostname of the undercloud:

   [stack@director ~]$ hostname
   [stack@director ~]$ hostname -f

2. If either of the previous commands do not report the correct hostname or report an error, use hostnamectl to set a hostname:

   [stack@director ~]$ sudo hostnamectl set-hostname manager.example.com
   [stack@director ~]$ sudo hostnamectl set-hostname --transient manager.example.com

3. The director also requires an entry for the system’s hostname and base name in /etc/hosts. The IP address in /etc/hosts must match the address that you plan to use for your undercloud public API. For example, if the system is named manager.example.com and uses 10.0.0.1 for its IP address, then /etc/hosts requires an entry like:

   10.0.0.1  manager.example.com manager

Procedure

1. Register your system with the Content Delivery Network, entering your Customer Portal user name and password when prompted:

   [stack@director ~]$ sudo subscription-manager register

2. Find the entitlement pool ID for Red Hat OpenStack Platform director. For example:

   [stack@director ~]$ sudo subscription-manager list --available --all --matches="Red Hat OpenStack"
   Subscription Name:   Name of SKU
   Provides:            Red Hat Single Sign-On
                        Red Hat Enterprise Linux Workstation
                        Red Hat CloudForms
                        Red Hat OpenStack
                        Red Hat Software Collections (for RHEL Workstation)
                        Red Hat Virtualization
   SKU:                 SKU-Number
   Contract:            Contract-Number
   Pool ID:             Valid-Pool-Number-123456
   Provides Management: Yes
   Available:           1
   Suggested:           1
   Service Level:       Support-level
   Service Type:        Service-Type
   Subscription Type:   Sub-type
   Ends:                End-date
   System Type:         Physical

3. Locate the Pool ID value and attach the Red Hat OpenStack Platform 13 entitlement:

   [stack@director ~]$ sudo subscription-manager attach --pool=Valid-Pool-Number-123456

4. Disable all default repositories, and then enable the required Red Hat Enterprise Linux repositories:

   [stack@director ~]$ sudo subscription-manager repos --disable=*
   [stack@director ~]$ sudo subscription-manager repos --enable=rhel-7-server-rpms --enable=rhel-7-server-extras-rpms --enable=rhel-7-server-rh-common-rpms --enable=rhel-ha-for-rhel-7-server-rpms --enable=rhel-7-server-openstack-13-rpms

   These repositories contain packages the director installation requires.

   Important

   Only enable the repositories listed in Section 2.5, “Repository Requirements”. Additional repositories can cause package and software conflicts. Do not enable any additional repositories.

5. Perform an update on your system to make sure you have the latest base system packages:

   [stack@director ~]$ sudo yum update -y
   [stack@director ~]$ sudo reboot

   The system is now ready for the director installation.

Procedure

1. Install the command line tools for director installation and configuration:

   [stack@director ~]$ sudo yum install -y python-tripleoclient

2. If you aim to create an overcloud with Ceph Storage nodes, install the additional ceph-ansible package:

   [stack@director ~]$ sudo yum install -y ceph-ansible

Procedure

1. Red Hat provides a basic template to help determine the required settings for your installation. Copy this template to the stack user’s home directory:

   [stack@director ~]$ cp \
     /usr/share/instack-undercloud/undercloud.conf.sample \
     ~/undercloud.conf

2. Edit the undercloud.conf file. This file contains settings to configure your undercloud. If you omit or comment out a parameter, the undercloud installation uses the default value.

Procedure

1. Run the following command to install the director on the undercloud:

   [stack@director ~]$ openstack undercloud install

   This launches the director’s configuration script. The director installs additional packages and configures its services to suit the settings in the undercloud.conf. This script takes several minutes to complete.

   The script generates two files when complete:

   • undercloud-passwords.conf - A list of all passwords for the director’s services.
   • stackrc - A set of initialization variables to help you access the director’s command line tools.

2. The script also starts all OpenStack Platform services automatically. Check the enabled services using the following command:

   [stack@director ~]$ sudo systemctl list-units openstack-*

3. The script adds the stack user to the docker group to give the stack user has access to container management commands. Refresh the stack user’s permissions with the following command:

   [stack@director ~]$ exec su -l stack

   The command prompts you to log in again. Enter the stack user’s password.

4. To initialize the stack user to use the command line tools, run the following command:

   [stack@director ~]$ source ~/stackrc

   The prompt now indicates OpenStack commands authenticate and execute against the undercloud;

   (undercloud) [stack@director ~]$

Procedure

1. Source the stackrc file to enable the director’s command line tools:

   [stack@director ~]$ source ~/stackrc

2. Set the nameservers for the ctlplane-subnet subnet:

   (undercloud) [stack@director images]$ openstack subnet set --dns-nameserver [nameserver1-ip] --dns-nameserver [nameserver2-ip] ctlplane-subnet

   Use the --dns-nameserver option for each nameserver.

3. View the subnet to verify the nameserver:

   (undercloud) [stack@director images]$ openstack subnet show ctlplane-subnet
   +-------------------+-----------------------------------------------+
   | Field             | Value                                         |
   +-------------------+-----------------------------------------------+
   | ...               |                                               |
   | dns_nameservers   | 8.8.8.8                                       |
   | ...               |                                               |
   +-------------------+-----------------------------------------------+