diff --git a/doc/source/install-guide/deploymenthost-add.rst b/doc/source/install-guide/deploymenthost-add.rst deleted file mode 100644 index 88c61a7c74..0000000000 --- a/doc/source/install-guide/deploymenthost-add.rst +++ /dev/null @@ -1,20 +0,0 @@ -`Home `_ OpenStack-Ansible Installation Guide - -Configuring the operating system --------------------------------- - -Install additional software packages and configure NTP. - -#. Install additional software packages if not already installed during - operating system installation: - - .. code-block:: shell-session - - # apt-get install aptitude build-essential git ntp ntpdate \ - openssh-server python-dev sudo - -#. Configure NTP to synchronize with a suitable time source. - --------------- - -.. include:: navigation.txt diff --git a/doc/source/install-guide/deploymenthost-os.rst b/doc/source/install-guide/deploymenthost-os.rst deleted file mode 100644 index 91fa58cdac..0000000000 --- a/doc/source/install-guide/deploymenthost-os.rst +++ /dev/null @@ -1,13 +0,0 @@ -`Home `_ OpenStack-Ansible Installation Guide - -Installing the operating system -------------------------------- - -Install the `Ubuntu Server 14.04 (Trusty Tahr) LTS -64-bit `_ operating system on the -deployment host with at least one network interface configured to access -the Internet or suitable local repositories. - --------------- - -.. include:: navigation.txt diff --git a/doc/source/install-guide/deploymenthost-osa.rst b/doc/source/install-guide/deploymenthost-osa.rst deleted file mode 100644 index e52256d183..0000000000 --- a/doc/source/install-guide/deploymenthost-osa.rst +++ /dev/null @@ -1,26 +0,0 @@ -`Home `_ OpenStack-Ansible Installation Guide - -Installing source and dependencies ----------------------------------- - -Install the source and dependencies for the deployment host. - -#. Clone the OSA repository into the ``/opt/openstack-ansible`` - directory: - - .. code-block:: shell-session - - # git clone -b TAG https://github.com/openstack/openstack-ansible.git /opt/openstack-ansible - - Replace *``TAG``* with the current stable release tag. - -#. Change to the ``/opt/openstack-ansible`` directory, and run the - Ansible bootstrap script: - - .. code-block:: shell-session - - # scripts/bootstrap-ansible.sh - --------------- - -.. include:: navigation.txt diff --git a/doc/source/install-guide/deploymenthost-sshkeys.rst b/doc/source/install-guide/deploymenthost-sshkeys.rst deleted file mode 100644 index 4e30ff9910..0000000000 --- a/doc/source/install-guide/deploymenthost-sshkeys.rst +++ /dev/null @@ -1,15 +0,0 @@ -`Home `_ OpenStack-Ansible Installation Guide - -Configuring Secure Shell (SSH) keys ------------------------------------ - -Ansible uses Secure Shell (SSH) with public key authentication for -connectivity between the deployment and target hosts. To reduce user -interaction during Ansible operations, key pairs should not include -passphrases. However, if a passphrase is required, consider using the -**ssh-agent** and **ssh-add** commands to temporarily store the -passphrase before performing Ansible operations. - --------------- - -.. include:: navigation.txt diff --git a/doc/source/install-guide/deploymenthost.rst b/doc/source/install-guide/deploymenthost.rst index b59e351f8b..961c26bbe9 100644 --- a/doc/source/install-guide/deploymenthost.rst +++ b/doc/source/install-guide/deploymenthost.rst @@ -3,14 +3,6 @@ Chapter 2. Deployment host -------------------------- -.. toctree:: - - deploymenthost-os.rst - deploymenthost-add.rst - deploymenthost-osa.rst - deploymenthost-sshkeys.rst - - **Figure 2.1. Installation work flow** .. image:: figures/workflow-deploymenthost.png @@ -20,8 +12,62 @@ deployment host contains Ansible and orchestrates the OSA installation on the target hosts. One of the target hosts, preferably one of the infrastructure variants, can be used as the deployment host. To use a deployment host as a target host, follow the steps in `Chapter 3, -*Target hosts* `_ on the deployment host. This -guide assumes separate deployment and target hosts. +*Target hosts* `_ on the deployment host. This guide +assumes separate deployment and target hosts. + +Installing the operating system +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Install the `Ubuntu Server 14.04 (Trusty Tahr) LTS 64-bit +`_ operating system on the +deployment host with at least one network interface configured to +access the Internet or suitable local repositories. + +Configuring the operating system +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Install additional software packages and configure NTP. + +#. Install additional software packages if not already installed + during operating system installation: + + .. code-block:: shell-session + + # apt-get install aptitude build-essential git ntp ntpdate \ + openssh-server python-dev sudo + +#. Configure NTP to synchronize with a suitable time source. + +Installing source and dependencies +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Install the source and dependencies for the deployment host. + +#. Clone the OSA repository into the ``/opt/openstack-ansible`` + directory: + + .. code-block:: shell-session + + # git clone -b TAG https://github.com/openstack/openstack-ansible.git /opt/openstack-ansible + + Replace *``TAG``* with the current stable release tag. + +#. Change to the ``/opt/openstack-ansible`` directory, and run the + Ansible bootstrap script: + + .. code-block:: shell-session + + # scripts/bootstrap-ansible.sh + +Configuring Secure Shell (SSH) keys +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Ansible uses Secure Shell (SSH) with public key authentication for +connectivity between the deployment and target hosts. To reduce user +interaction during Ansible operations, key pairs should not include +pass phrases. However, if a pass phrase is required, consider using the +**ssh-agent** and **ssh-add** commands to temporarily store the +pass phrase before performing Ansible operations. --------------