openstack/openstack-ansible
Code Issues Proposed changes
54555431af
openstack-ansible/doc/source/install-guide/configure-hostlist.rst
Alexandra 55155f301e DOCS: Configuration section - cleanup 
As per discussion in the OSA docs summit session, clean up
of installation guide. This fixes typos, minor RST mark up
changes, and passive voice.

This patch also merges a some of the sections into the larger
chapter. This is in an effort to remove multiple smaller
files.

This patch is the first of many to avoid major conflicts.

Change-Id: I2b1582812e638e2b3b455b7c34b93d13e08a168a
2016-05-06 15:19:46 +10:00

3.6 KiB
Raw Blame History

Home OpenStack-Ansible Installation Guide

Configuring target hosts

Modify the /etc/openstack_deploy/openstack_user_config.yml file to configure the target hosts.

Do not assign the same IP address to different target hostnames. Unexpected results may occur. Each IP address and hostname must be a matching pair. To use the same host in multiple roles, for example infrastructure and networking, specify the same hostname and IP in each section.

Use short hostnames rather than fully-qualified domain names (FQDN) to prevent length limitation issues with LXC and SSH. For example, a suitable short hostname for a compute host might be: 123456-Compute001.

Unless otherwise stated, replace *_IP_ADDRESS with the IP address of the br-mgmt container management bridge on each target host.

  1. Configure a list containing at least three infrastructure target hosts in the shared-infra_hosts section:

    shared-infra_hosts:
  infra01:
    ip: INFRA01_IP_ADDRESS
  infra02:
    ip: INFRA02_IP_ADDRESS
  infra03:
    ip: INFRA03_IP_ADDRESS
  infra04: ...

  2. Configure a list containing at least two infrastructure target hosts in the os-infra_hosts section (you can reuse previous hosts as long as their name and ip is consistent):

    os-infra_hosts:
  infra01:
    ip: INFRA01_IP_ADDRESS
  infra02:
    ip: INFRA02_IP_ADDRESS
  infra03:
    ip: INFRA03_IP_ADDRESS
  infra04: ...

  3. Configure a list of at least one keystone target host in the identity_hosts section:

    identity_hosts:
  infra1:
    ip: IDENTITY01_IP_ADDRESS
  infra2: ...

  4. Configure a list containing at least one network target host in the network_hosts section:

    network_hosts:
  network01:
    ip: NETWORK01_IP_ADDRESS
  network02: ...

    Providing more than one network host in the network_hosts block will enable L3HA support using VRRP in the neutron-agent containers.

  5. Configure a list containing at least one compute target host in the compute_hosts section:

    compute_hosts:
  compute001:
    ip: COMPUTE001_IP_ADDRESS
  compute002: ...

  6. Configure a list containing at least one logging target host in the log_hosts section:

    log_hosts:
  logging01:
    ip: LOGGER1_IP_ADDRESS
  logging02: ...

  7. Configure a list containing at least one repository target host in the repo-infra_hosts section:

    repo-infra_hosts:
  repo01:
    ip: REPO01_IP_ADDRESS
  repo02:
    ip: REPO02_IP_ADDRESS
  repo03:
    ip: REPO03_IP_ADDRESS
  repo04: ...

    The repository typically resides on one or more infrastructure hosts.

  8. Configure a list containing at least one optional storage host in the storage_hosts section:

    storage_hosts:
  storage01:
    ip: STORAGE01_IP_ADDRESS
  storage02: ...

    Each storage host requires additional configuration to define the back end driver.

    The default configuration includes an optional storage host. To install without storage hosts, comment out the stanza beginning with the storage_hosts: line.