diff --git a/doc/source/advanced_deployment/advanced_deployment.rst b/doc/source/advanced_deployment/advanced_deployment.rst
index a455680d..e4864c26 100644
--- a/doc/source/advanced_deployment/advanced_deployment.rst
+++ b/doc/source/advanced_deployment/advanced_deployment.rst
@@ -19,6 +19,7 @@ In this chapter you will find advanced deployment of various |project| areas.
    template_deploy
    network_isolation
    network_isolation_virt
+   high_availability
    deploy_manila
    cinder_custom_backend
    cinder_netapp
@@ -31,4 +32,3 @@ In this chapter you will find advanced deployment of various |project| areas.
    # relevant to regular users.
    tripleo.sh
    in_progress_review
-
diff --git a/doc/source/advanced_deployment/high_availability.rst b/doc/source/advanced_deployment/high_availability.rst
new file mode 100644
index 00000000..3069995b
--- /dev/null
+++ b/doc/source/advanced_deployment/high_availability.rst
@@ -0,0 +1,12 @@
+Configuring High Availability
+=============================
+
+|project| supports high availability of the controller services using
+Pacemaker. To enable this feature, you need at least three controller
+nodes, enable Pacemaker as the resource manager and specify an NTP
+server.
+
+Adding the following arguments to your `openstack overcloud deploy`
+command will do the trick::
+
+  --control-scale 3 -e /usr/share/openstack-tripleo-heat-templates/environments/puppet-pacemaker.yaml --ntp-server pool.ntp.org
diff --git a/doc/source/basic_deployment/basic_deployment_cli.rst b/doc/source/basic_deployment/basic_deployment_cli.rst
index 0fc0436b..32c02e94 100644
--- a/doc/source/basic_deployment/basic_deployment_cli.rst
+++ b/doc/source/basic_deployment/basic_deployment_cli.rst
@@ -329,20 +329,15 @@ Run the deploy command, including any additional parameters as necessary::
 
   openstack overcloud deploy --templates [additional parameters]
 
+To deploy an overcloud with multiple controllers and achieve HA,
+follow :doc:`../advanced_deployment/high_availability`.
+
 .. admonition:: Virtual
    :class: virtual
 
    When deploying the Compute node in a virtual machine, add ``--libvirt-type
    qemu`` or launching instances on the deployed overcloud will fail.
 
-.. note::
-   To deploy an overcloud with multiple controllers and achieve HA
-   you must provision at least 3 controller nodes, specify an NTP
-   server and enable Pacemaker as cluster resource manager. To do
-   so add the following arguments to the deploy command::
-
-    --control-scale 3 -e /usr/share/openstack-tripleo-heat-templates/environments/puppet-pacemaker.yaml --ntp-server pool.ntp.org
-
 .. note::
 
    To deploy the overcloud with network isolation, bonds, and/or custom