openstack/openstack-ansible
Code Issues Proposed changes
4ebf7974ef
openstack-ansible/doc/source/install-guide/deploymenthost.rst
Robb Romans a3ea60837b Flatten deployment host section 
Change-Id: I5246ff1504c35f1ff834f91e139df3e174ec7b33
2016-02-23 15:36:00 -06:00

2.4 KiB
Raw Blame History

Home OpenStack-Ansible Installation Guide

Chapter 2. Deployment host

Figure 2.1. Installation work flow

image

The OSA installation process recommends one deployment host. The 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.

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.

  1. Install additional software packages if not already installed during operating system installation:

    # apt-get install aptitude build-essential git ntp ntpdate \
  openssh-server python-dev sudo

  2. Configure NTP to synchronize with a suitable time source.

Installing source and dependencies

Install the source and dependencies for the deployment host.

  1. Clone the OSA repository into the /opt/openstack-ansible directory:

    # git clone -b TAG https://github.com/openstack/openstack-ansible.git /opt/openstack-ansible

    Replace ``TAG`` with the current stable release tag.

  2. Change to the /opt/openstack-ansible directory, and run the Ansible bootstrap script:

    # 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.