From 267c49e135525e68f1df438cc689a8c80b0d6697 Mon Sep 17 00:00:00 2001 From: Nate Potter Date: Wed, 2 Mar 2016 14:01:32 -0800 Subject: [PATCH] Clarify HAProxy configuration necessity This was a little roadblock that I ran into when deploying using openstack-ansible recently. The documentation doesn't indicate that configuration of a load balancer is explicitly required, and since the HAProxy installation playbook didn't run automatically on setup-everything.yml the errors that I got didn't lead me to figuring out that HAProxy was the missing piece. Change-Id: I8c15910f19e2be8ece3bac98bcbf82eb49045bf8 Partial-bug: #1552362 --- doc/source/install-guide/configure-haproxy.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/doc/source/install-guide/configure-haproxy.rst b/doc/source/install-guide/configure-haproxy.rst index 1944ca2f7b..9a4a8885e2 100644 --- a/doc/source/install-guide/configure-haproxy.rst +++ b/doc/source/install-guide/configure-haproxy.rst @@ -3,11 +3,17 @@ Configuring HAProxy (optional) ------------------------------ -For evaluation, testing, and development, HAProxy can temporarily -provide load balancing services in lieu of hardware load balancers. The -default HAProxy configuration does not provide highly-available load -balancing services. For production deployments, deploy a hardware load -balancer prior to deploying OSA. +HAProxy provides load balancing for high availability architectures deployed by +OpenStack-Ansible. The default HAProxy configuration provides highly-available +load balancing services via keepalived if there are more than one hosts in the +``haproxy_hosts`` group. + +.. note:: + + A load balancer is required for a successful installation. Deployers may + prefer to make use of hardware load balancers instead of haproxy. If hardware + load balancers are used then the load balancing configuration for services must + be implemented prior to executing the deployment. To deploy HAProxy within your OpenStack-Ansible environment, define target hosts which should run HAProxy: