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

   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.

   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

2. Enable needed repositories:

   internal

   RHEL

   Enable rhos-release:

   sudo rpm -ivh http://rhos-release.virt.bos.redhat.com/repos/rhos-release/rhos-release-latest.noarch.rpm
   
   # Enable either poodles or puddles:
   # To enable poodles:
   sudo rhos-release 7-director -d
   # To enable puddles:
   sudo rhos-release 7-director

   external

   RHEL

   Enable optional repo:

   sudo yum install -y yum-utils
   sudo yum-config-manager --enable rhelosp-rhel-7-server-opt

   Note

   If testing RDO as opposed to RHOS, you need to enable some extra repositories:

   # Enable RDO Kilo
   sudo yum install -y https://rdoproject.org/repos/openstack-kilo/rdo-release-kilo.rpm
   
   # Enable RDO-Manager Trunk
   sudo curl -o /etc/yum.repos.d/rdo-management-trunk.repo http://trunk-mgt.rdoproject.org/centos-kilo/current-passed-ci/delorean-rdo-management.repo

   The above RDO-Manager Trunk repo is updated after a successful CI run. The following repo can be used instead if the newest packages are needed before a CI run has passed.

   sudo curl -o /etc/yum.repos.d/rdo-management-trunk.repo http://trunk-mgt.rdoproject.org/centos-kilo/current/delorean-rdo-management.repo

3. Install the RDO Manager CLI, which will pull in all other necessary packages as dependencies:

   sudo yum install -y python-rdomanager-oscplugin

4. Run the script to install the undercloud:

Baremetal

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

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

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.