diff --git a/doc/ha-guide/source/install-ha-vip.rst b/doc/ha-guide/source/controller-ha-vip.rst
similarity index 100%
rename from doc/ha-guide/source/install-ha-vip.rst
rename to doc/ha-guide/source/controller-ha-vip.rst
diff --git a/doc/ha-guide/source/controller-ha.rst b/doc/ha-guide/source/controller-ha.rst
index aff87a70..aac6dc73 100644
--- a/doc/ha-guide/source/controller-ha.rst
+++ b/doc/ha-guide/source/controller-ha.rst
@@ -11,6 +11,7 @@ and must talk to all other services.
 
    controller-ha-pacemaker.rst
    controller-ha-haproxy.rst
+   controller-ha-vip.rst
    controller-ha-galera.rst
    controller-ha-rabbitmq.rst
    controller-ha-keystone.rst
diff --git a/doc/ha-guide/source/install-ha.rst b/doc/ha-guide/source/install-ha.rst
index 472e5d8e..7fcfdb6d 100644
--- a/doc/ha-guide/source/install-ha.rst
+++ b/doc/ha-guide/source/install-ha.rst
@@ -8,6 +8,5 @@ Installing high availability packages
    :maxdepth: 2
 
    install-ha-os.rst
-   install-ha-vip.rst
    install-ha-memcached.rst
    install-ha-ntp.rst