Chapter 4. Installing the undercloud

Procedure

1. Log into your undercloud as the root user.

2. Create the stack user:

   [root@director ~]# useradd stack

   Copy to Clipboard Toggle word wrap

3. Set a password for the user:

   [root@director ~]# passwd stack

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

5. Switch to the new stack user:

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

   Copy to Clipboard Toggle word wrap

Procedure

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

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

   Copy to Clipboard Toggle word wrap

2. If either of the previous commands do not report the correct fully-qualified 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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

Procedure

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

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

4. Disable all default repositories, and then enable the required Red Hat Enterprise Linux repositories that contain packages that the director installation requires:

   [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 --enable=rhel-7-server-rhceph-3-tools-rpms

   Copy to Clipboard Toggle word wrap
   Important

   Enable only the repositories listed in Section 2.5, “Repository Requirements”. Do not enable any additional repositories because they can cause package and software conflicts.

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

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

   Copy to Clipboard Toggle word wrap

6. Reboot your system:

   [stack@director ~]$ sudo reboot

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

Procedure

1. Enable the Ceph Tools repository:

   [stack@director ~]$ sudo subscription-manager repos --enable=rhel-7-server-rhceph-3-tools-rpms

   Copy to Clipboard Toggle word wrap

2. Install the ceph-ansible package:

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap
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. Create a hieradata override file, for example, /home/stack/hieradata.yaml.

2. Add the customized hieradata to the file. For example, add the following to modify the Compute (nova) service parameter force_raw_images from the default value of "True" to "False":

   nova::compute::force_raw_images: False

   Copy to Clipboard Toggle word wrap

   If there is no Puppet implementation for the parameter you want to set, then use the following method to configure the parameter:

   nova::config::nova_config:
     DEFAULT/<parameter_name>:
       value: <parameter_value>

   Copy to Clipboard Toggle word wrap

   For example:

   nova::config::nova_config:
     DEFAULT/network_allocate_retries:
       value: 20
     ironic/serial_console_state_timeout:
       value: 15

   Copy to Clipboard Toggle word wrap

3. Set the hieradata_override parameter to the path of the hieradata file in your undercloud.conf:

   hieradata_override = /home/stack/hieradata.yaml

   Copy to Clipboard Toggle word wrap

Procedure

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

   [stack@director ~]$ openstack undercloud install

   Copy to Clipboard Toggle word wrap

   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-*

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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

   (undercloud) [stack@director ~]$

   Copy to Clipboard Toggle word wrap

Procedure

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

   [stack@director ~]$ source ~/stackrc

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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                                       |
   | ...               |                                               |
   +-------------------+-----------------------------------------------+

   Copy to Clipboard Toggle word wrap