director 的安装过程需要一个非 root 的用户来执行命令。使用以下命令创建一个名为 stack 的用户并设置密码：

[root@director ~]# useradd stack
[root@director ~]# passwd stack  # specify a password

进行以下操作以使这个用户使用 sudo 时不需要输入密码：

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

切换到新的 stack 用户：

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

使用 stack 用户继续安装的过程。

director 使用系统镜像和 Heat 模板来创建 overcloud 环境。为保持文件的有序性，我们推荐创建以下目录来组织镜像和模板文件：

[stack@director ~]$ mkdir ~/images
[stack@director ~]$ mkdir ~/templates

本指南中的其它部分会使用这两个目录来保存特定的文件。

director 的安装和配置过程需要一个完全限定域名（FQDN），这意味着您需要为 director 的主机设置主机名（hostname）。使用以下命令检查主机的主机名：

[stack@director ~]$ hostname    # Checks the base hostname
[stack@director ~]$ hostname -f # Checks the long hostname (FQDN)

如果需要，使用 hostnamectl 设置主机名：

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

另外，director 还需要在/etc/hosts 文件中包括一个带有系统主机名的项。例如，系统名是 manager.example.com，/etc/hosts 则需要包括一个和以下类似的项：

127.0.0.1   manager.example.com manager localhost localhost.localdomain localhost4 localhost4.localdomain4

若要安装 Red Hat OpenStack Platform director，首先需要使用 Red Hat Subscription Manager 注册主机系统，并且订阅所需的频道。

这些仓库包括了安装 director 所需的软件包。

对系统上的软件进行一个更新来确保使用了最新的基本系统软件包：

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

现在，这个系统已经准备好可以进行 director 安装了。

使用以下命令安装 director 所需的命令行工具：

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

这个命令会安装 director 所需的所有软件包。

如果要创建包含 Ceph Storage 节点的 overcloud，需要额外安装 ceph-ansible 软件包：

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

director 的安装过程需要特定的设置来决定您的网络配置。这些设置保存在 stack 用户的家目录中的一个模板中（undercloud.conf）。

红帽会提供一个基本的模板来帮助您设置安装所需的配置。把这个模板复制到 stack 用户的家目录中：

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

undercloud.conf 文件包含用于配置 undercloud 的设置。如果忽略或注释掉某个参数，undercloud 安装将使用默认值。

模板包括两部分：[DEFAULT] 和 [auth]。[DEFAULT] 部分包括以下参数：

[auth] 部分包含以下参数：

根据网络的具体情况修改这些参数的值。完成后，保存这个文件并运行以下命令：

[stack@director ~]$ openstack undercloud install

这会启动 director 的配置脚本。director 会安装额外的软件包，并把它的服务配置为和 undercloud.conf 中的设置相符合的情况。这个脚本会需要一些时间来完成。

完成后，配置脚本会产生两个文件：

此配置也会自动启用所有 OpenStack Platform 服务。使用以下命令检查已启用的服务：

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

运行以下命令初始化 stack 用户来使用命令行工具：

[stack@director ~]$ source ~/stackrc

提示信息现在指示，OpenStack 命令在对 undercloud 验证身份并执行命令；

(undercloud) [stack@director ~]$

您现在可以使用 director 的命令行工具了。

director 需要以下几个磁盘镜像来部署 overcloud 节点：

从 rhosp-director-images 和 rhosp-director-images-ipa 软件包中获得这些镜像：

(undercloud) [stack@director ~]$ sudo yum install rhosp-director-images rhosp-director-images-ipa

把压缩文件展开到 stack 用户的家目录下的 images 目录中（/home/stack/images）：

(undercloud) [stack@director ~]$ cd ~/images
(undercloud) [stack@director images]$ for i in /usr/share/rhosp-director-images/overcloud-full-latest-12.0.tar /usr/share/rhosp-director-images/ironic-python-agent-latest-12.0.tar; do tar -xvf $i; done

把这些镜像导入到 director：

(undercloud) [stack@director images]$ openstack overcloud image upload --image-path /home/stack/images/

这会把 bm-deploy-kernel、bm-deploy-ramdisk、overcloud-full、overcloud-full-initrd 和 overcloud-full-vmlinuz 镜像上传到 director。部署操作和 overcloud 需要这些镜像。另外，此脚本还会在 director 的 PXE 服务器上安装内省镜像。

在 CLI 中查看镜像列表：

(undercloud) [stack@director images]$ openstack image list
+--------------------------------------+------------------------+
| ID                                   | Name                   |
+--------------------------------------+------------------------+
| 765a46af-4417-4592-91e5-a300ead3faf6 | bm-deploy-ramdisk      |
| 09b40e3d-0382-4925-a356-3a4b4f36b514 | bm-deploy-kernel       |
| ef793cd0-e65c-456a-a675-63cd57610bd5 | overcloud-full         |
| 9a51a6cb-4670-40de-b64b-b70f4dd44152 | overcloud-full-initrd  |
| 4f7e33f4-d617-47c1-b36f-cbe90f132e5d | overcloud-full-vmlinuz |
+--------------------------------------+------------------------+

这个列表没有显示内省 PXE 镜像。director 会把这些文件复制到 /httpboot。

(undercloud) [stack@director images]$ ls -l /httpboot
total 341460
-rwxr-xr-x. 1 root              root                5153184 Mar 31 06:58 agent.kernel
-rw-r--r--. 1 root              root              344491465 Mar 31 06:59 agent.ramdisk
-rw-r--r--. 1 ironic-inspector  ironic-inspector        337 Mar 31 06:23 inspector.ipxe

overcloud 节点需要名称服务器来提供 DNS 主机名解析。对于没有网络隔离的标准 overcloud，此名称服务器在 undercloud 的 neutron 子网中定义。使用以下命令定义环境的名称服务器：

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

查看子网来验证名称解析服务器：

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

红帽提供了一个对 undercloud 主机以及 Red Hat OpenStack Platform director 的重要数据进行备份的方法。如需了解更多与 undercloud 备份相关的信息，请参阅 "Back Up and Restore the Director Undercloud" 指南。

undercloud 的配置到此结束。下一章将介绍基本的 overcloud 配置，包括注册节点和检查节点，并把它们标记为不同的节点角色。