Octavia data plane adoption

Documentation for adopting the data plane, ie. amphorae,
specifically.

docs_user/assemblies/assembly_adopting-the-data-plane.adoc

@@ -24,5 +24,7 @@ include::../modules/proc_performing-a-fast-forward-upgrade-on-compute-services.a
 
 include::../modules/proc_adopting-networker-services-to-the-data-plane.adoc[leveloffset=+1]
 
+include::../modules/proc_adopting-octavia-amphorae.adoc[leveloffset=+1]
+
 ifdef::parent-context[:context: {parent-context}]
 ifndef::parent-context[:!context:]

docs_user/modules/proc_adopting-octavia-amphorae.adoc

@@ -0,0 +1,25 @@
+[id="adopting-octavia-amphorae_{context}"]
+
+= Octavia data plane adoption
+
+== Clean up old neutron ports
+This deletes the old management port.
+
+----
+HM_PORTID="$(openstack port list --device-owner Octavia:health-mgr -f value -c ID)"
+openstack port delete "$HM_PORTID"
+----
+
+== Enabling the {loadbalancer_service} in OpenShift
+Run the following command in order to enable the {loadbalancer_service} CR
+and to finish the adoption process for {loadbalancer_service}.
+
+[source,bash]
+----
+oc patch openstackcontrolplane openstack --type=merge --patch '
+spec:
+  octavia:
+    enabled: true
+    template: {}
+'
+----

docs_user/modules/proc_adopting-the-loadbalancer-service.adoc

@@ -29,15 +29,7 @@ These commands convert the existing single CA configuration into a dual CA confi
 // == TODO: Other things
 // TODO
 
-== Enabling the {loadbalancer_service} in OpenShift
-Run the following command in order to enable the {loadbalancer_service} CR.
-
-[source,bash]
-----
-$ oc patch openstackcontrolplane openstack --type=merge --patch '
-spec:
-  octavia:
-    enabled: true
-    template: {}
-'
-----
+== Final steps
+Octavia services must remain disabled until data plane adoption is finished in
+order to avoid amphora failovers before the data plane adoption steps were
+finished.