46b662dacb
This patch removes the old install guide. It is still accessible in the Mitaka section. Change-Id: I47ce62523edd14a1bb20deba3f40e1e0b2df223c Implements: blueprint osa-install-guide-overhaul
84 lines
2.8 KiB
ReStructuredText
84 lines
2.8 KiB
ReStructuredText
===============
|
||
Deployment host
|
||
===============
|
||
|
||
.. figure:: figures/installation-workflow-deploymenthost.png
|
||
:width: 100%
|
||
|
||
When installing OpenStack in a production environment, we recommend using a
|
||
separate deployment host which contains Ansible and orchestrates the
|
||
OpenStack-Ansible installation on the target hosts. In a test environment, we
|
||
prescribe using one of the infrastructure target hosts as the deployment host.
|
||
|
||
To use a target host as a deployment host, follow the steps in `Chapter 3,
|
||
Target hosts <targethosts.html>`_ on the deployment host.
|
||
|
||
Installing the operating system
|
||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||
|
||
Install the `Ubuntu Server 14.04 (Trusty Tahr) LTS 64-bit
|
||
<http://releases.ubuntu.com/14.04/>`_ operating system on the
|
||
deployment host. Configure at least one network interface 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.
|
||
|
||
Configuring the network
|
||
~~~~~~~~~~~~~~~~~~~~~~~
|
||
|
||
Ansible deployments fail if the deployment server is unable to SSH to the
|
||
containers. Configure the deployment host to be on the same network designated
|
||
for container management. This configuration reduces the rate of failure due
|
||
to connectivity issues.
|
||
|
||
The following network information is used as an example:
|
||
|
||
Container management: 172.29.236.0/22 (VLAN 10)
|
||
|
||
Select an IP from this range to assign to the deployment host.
|
||
|
||
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 : |my_conf_val|
|
||
|
||
#. 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, do not include pass phrases with
|
||
key pairs. 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.
|
||
|