openstack-ansible/doc/source/install-guide/configure-hostlist.rst
Michael Gugino d3c02bbbe6 Modify docs to more strongly suggest deploying repo-infra_hosts
This change implements documentation changes discussed during the
weekly meeting on January 14, 2016 on freenode in #openstack-meeting-4

Currently, documentation suggests configuring the user variable
openstack_repo_url: "https://rpc-repo.rackspace.com/"

The repos maintained on https://rpc-repo.rackspace.com/ do not
currently support individual point releases (such as 12.0.3 at the
time of this writing).  Releases are supported by name in that repo,
such as 'liberty', 'master', or 'kilo'.

This change advocates more strongly for the use of deploying
repo-infra_hosts, and in the alternative, asks the user to specify
the user variable openstack_release to avoid problems with point
releases in the repository until a time they are implemented upstream.

Change-Id: I36f8893fcd7cb8d6ddbce06b7974e3b16be91b5f
2016-01-15 11:41:12 -05:00

5.2 KiB

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.

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

    shared-infra_hosts:
      603975-infra01:
        ip: INFRA01_IP_ADDRESS
      603989-infra02:
        ip: INFRA02_IP_ADDRESS
      627116-infra03:
        ip: INFRA03_IP_ADDRESS
      628771-infra04: ...

    Replace *_IP_ADDRESS with the IP address of the br-mgmt container management bridge on each infrastructure target host. Use the same net block as bond0 on the nodes, for example:

    shared-infra_hosts:
      603975-infra01:
        ip: 10.240.0.80
      603989-infra02:
        ip: 10.240.0.81
      627116-infra03:
        ip: 10.240.0.184
  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:
      603975-infra01:
        ip: INFRA01_IP_ADDRESS
      603989-infra02:
        ip: INFRA02_IP_ADDRESS
      627116-infra03:
        ip: INFRA03_IP_ADDRESS
      628771-infra04: ...

    Replace *_IP_ADDRESS with the IP address of the br-mgmt container management bridge on each infrastructure target host. Use the same net block as bond0 on the nodes, for example:

    os-infra_hosts:
      603975-infra01:
        ip: 10.240.0.80
      603989-infra02:
        ip: 10.240.0.81
      627116-infra03:
        ip: 10.240.0.184
  3. Configure a list containing at least one network target host in the network_hosts section:

    network_hosts:
      602117-network01:
        ip: NETWORK01_IP_ADDRESS
      602534-network02: ...

    Replace *_IP_ADDRESS with the IP address of the br-mgmt container management bridge on each network target host.

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

    compute_hosts:
      900089-compute001:
        ip: COMPUTE001_IP_ADDRESS
      900090-compute002: ...

    Replace *_IP_ADDRESS with the IP address of the br-mgmt container management bridge on each compute target host.

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

    log_hosts:
      900088-logging01:
        ip: LOGGER1_IP_ADDRESS
      903877-logging02: ...

    Replace *_IP_ADDRESS with the IP address of the br-mgmt container management bridge on each logging target host.

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

    repo-infra_hosts:
      603975-repo01:
        ip: REPO01_IP_ADDRESS
      603989-repo02:
        ip: REPO02_IP_ADDRESS
      627116-repo03:
        ip: REPO03_IP_ADDRESS
      628771-repo04: ...

    Replace *_IP_ADDRESS with the IP address of the br-mgmt container management bridge on each repository target host.

    The repository typically resides on one or more infrastructure hosts. Alternatively, specify a value for the variables openstack_repo_url and openstack_release in the /etc/openstack_deploy/user_group_vars.yml file. The values should contain a URL for a host with the appropriate repository layout and the desired OpenStack release, respectively. For example:

    openstack_repo_url: "https://rpc-repo.rackspace.com/"
    openstack_release: master

    Using repo-infra_hosts configures a local repository with the appropriate layout and sets openstack_repo_url and openstack_release for you. Using repo-infra_hosts is the preferred method of configuring the repository.

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

    storage_hosts:
      100338-storage01:
        ip: STORAGE01_IP_ADDRESS
      100392-storage02: ...

    Replace *_IP_ADDRESS with the IP address of the br-mgmt container management bridge on each storage target host. Each storage host also 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.