instack-undercloud/doc/source/installation/installing.rst

Installing the Undercloud

1. 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>@<rdo-manager-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

   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
   export HOSTNAME=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

2. Download and execute the instack-undercloud setup script which will enable the needed repositories for you:

   internal

   RHEL

   Enable rhos-release:

   export RUN_RHOS_RELEASE=1

   curl https://raw.githubusercontent.com/rdo-management/instack-undercloud/master/scripts/instack-setup-host | bash -x

3. Install the unified CLI (also installs instack-undercloud as a dependency):

   sudo yum install -y python-rdomanager-oscplugin

4. Run the script to install the undercloud:

Baremetal

Copy in the sample answers file and edit it to reflect your environment:

cp /usr/share/instack-undercloud/instack.answers.sample ~/instack.answers

Install the undercloud:

openstack undercloud install

Once the install script has run to completion, you should take note of the files /root/stackrc and /root/tripleo-undercloud-passwords. Both of these files will be needed to interact with the installed undercloud. Copy them to the home directory for easier use later:

sudo cp /root/tripleo-undercloud-passwords .
sudo chown $USER: tripleo-undercloud-passwords
sudo cp /root/stackrc .
sudo chown $USER: stackrc