From 7431aafa860d8f2b109cfb72d3b4bc02b85c0fc2 Mon Sep 17 00:00:00 2001 From: Nolan Brubaker Date: Wed, 15 Jul 2015 16:03:25 -0400 Subject: [PATCH] Document required repository hosts config info Installs must have either the repo-infra_hosts list, or the openstack_repo_url defined. Otherwise, greenfield installations following our installation docs will fail. Change-Id: I116040302e846530895836dd8aab9d4136b110af Closes-Bug: #1475000 --- .../install-guide/configure-hostlist.rst | 102 +++++++++++------- 1 file changed, 66 insertions(+), 36 deletions(-) diff --git a/doc/source/install-guide/configure-hostlist.rst b/doc/source/install-guide/configure-hostlist.rst index 7639a9dd88..7bc95fd48c 100644 --- a/doc/source/install-guide/configure-hostlist.rst +++ b/doc/source/install-guide/configure-hostlist.rst @@ -22,40 +22,40 @@ suitable short hostname for a compute host might be: .. code-block:: yaml - infra_hosts: - 603975-infra01: - ip: INFRA01_IP_ADDRESS - 603989-infra02: - ip: INFRA02_IP_ADDRESS - 627116-infra03: - ip: INFRA03_IP_ADDRESS - 628771-infra04: ... + 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`` + 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: .. code-block:: yaml - infra_hosts: - 603975-infra01: - ip: 10.240.0.80 - 603989-infra02: - ip: 10.240.0.81 - 627116-infra03: - ip: 10.240.0.184 + infra_hosts: + 603975-infra01: + ip: 10.240.0.80 + 603989-infra02: + ip: 10.240.0.81 + 627116-infra03: + ip: 10.240.0.184 #. Configure a list containing at least one network target host in the ``network_hosts`` section: .. code-block:: yaml - network_hosts: - 602117-network01: - ip: NETWORK01_IP_ADDRESS - 602534-network02: ... + network_hosts: + 602117-network01: + ip: NETWORK01_IP_ADDRESS + 602534-network02: ... - Replace *``*_IP_ADDRESS``* with the IP address of the ``br-mgmt`` + Replace ``*_IP_ADDRESS`` with the IP address of the ``br-mgmt`` container management bridge on each network target host. #. Configure a list containing at least one compute target host in the @@ -63,12 +63,12 @@ suitable short hostname for a compute host might be: .. code-block:: yaml - compute_hosts: - 900089-compute001: - ip: COMPUTE001_IP_ADDRESS - 900090-compute002: ... + compute_hosts: + 900089-compute001: + ip: COMPUTE001_IP_ADDRESS + 900090-compute002: ... - Replace *``*_IP_ADDRESS``* with the IP address of the ``br-mgmt`` + Replace ``*_IP_ADDRESS`` with the IP address of the ``br-mgmt`` container management bridge on each compute target host. #. Configure a list containing at least one logging target host in the @@ -76,25 +76,55 @@ suitable short hostname for a compute host might be: .. code-block:: yaml - log_hosts: - 900088-logging01: - ip: LOGGER1_IP_ADDRESS - 903877-logging02: ... + log_hosts: + 900088-logging01: + ip: LOGGER1_IP_ADDRESS + 903877-logging02: ... - Replace *``*_IP_ADDRESS``* with the IP address of the ``br-mgmt`` + Replace ``*_IP_ADDRESS`` with the IP address of the ``br-mgmt`` container management bridge on each logging target host. +#. Configure a list containing at least one repository target host in the + ``repo-infra_hosts`` section: + + .. code-block:: yaml + + 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 ``openstack_repo_url`` variable + in the ``/etc/openstack_deploy/user_group_vars.yml`` file. The value should + contain a URL for a host with the appropriate repository layout. For + example: + + .. code-block:: yaml + + openstack_repo_url: "https://rpc-repo.rackspace.com/" + + Using ``repo-infra_hosts`` configures a local repository with the + appropriate layout and sets ``openstack_repo_url`` for you. + #. Configure a list containing at least one optional storage host in the ``storage_hosts`` section: .. code-block:: yaml - storage_hosts: - 100338-storage01: - ip: STORAGE01_IP_ADDRESS - 100392-storage02: ... + storage_hosts: + 100338-storage01: + ip: STORAGE01_IP_ADDRESS + 100392-storage02: ... - Replace *``*_IP_ADDRESS``* with the IP address of the ``br-mgmt`` + 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.