Add procedure to disable services on OSP side

doc-Service-Telemetry-Framework/assemblies/assembly_completing-the-stf-configuration.adoc

@@ -37,6 +37,7 @@ include::../modules/proc_creating-the-base-configuration-for-stf.adoc[leveloffse
 include::../modules/proc_configuring-the-stf-connection-for-the-overcloud.adoc[leveloffset=+2]
 include::../modules/proc_deploying-the-overcloud.adoc[leveloffset=+2]
 include::../modules/proc_validating-clientside-installation.adoc[leveloffset=+2]
+include::../modules/proc_disabling-openstack-services-used-with-stf.adoc[leveloffset=+1]
 
 //Sending metrics to Gnocchi and to STF
 ifdef::include_when_16[]

doc-Service-Telemetry-Framework/modules/proc_disabling-openstack-services-used-with-stf.adoc

@@ -0,0 +1,57 @@
+[id="disabling-openstack-services-used-with-stf_{context}"]
+= Disabling {OpenStack} services used with {Project}
+
+[role="_abstract"]
+Disable the services used when deploying {OpenStack} ({OpenStackShort}) and connecting it to {Project} ({ProjectShort}).  There is no removal of logs or generated configuration files as part of the disablement of the services.
+
+[WARNING]
+Do not use this procedure when also using the xref:sending-metrics-to-gnocchi-and-to-stf_assembly-completing-the-stf-configuration[] procedure because the `gnocchi-connectors.yaml` does not contain all dependencies required. If you want to remove {ProjectShort}-related services on {OpenStackShort}, ensure that you update your environment to enable data collection and data storage dependencies.
+
+.Procedure
+
+. Log in to the {OpenStackShort} undercloud as the `stack` user.
+
+. Source the authentication file:
++
+[source,bash]
+----
+[stack@undercloud-0 ~]$ source stackrc
+
+(undercloud) [stack@undercloud-0 ~]$
+----
+
+. Create the `disable-stf.yaml` environment file:
++
+[source,yaml,options="nowrap"]
+----
+(undercloud) [stack@undercloud-0]$ cat > $HOME/disable-stf.yaml <<EOF
+---
+resource_registry:
+  OS::TripleO::Services::CeilometerAgentCentral: OS::Heat::None
+  OS::TripleO::Services::CeilometerAgentNotification: OS::Heat::None
+  OS::TripleO::Services::CeilometerAgentIpmi: OS::Heat::None
+  OS::TripleO::Services::ComputeCeilometerAgent: OS::Heat::None
+  OS::TripleO::Services::Redis: OS::Heat::None
+  OS::TripleO::Services::Collectd: OS::Heat::None
+  OS::TripleO::Services::MetricsQdr: OS::Heat::None
+EOF
+----
+
+. Remove the following files from your {OpenStackShort} {OpenStackInstaller} deployment:
++
+* `ceilometer-write-qdr.yaml`
+* `qdr-edge-only.yaml`
+* `enable-stf.yaml`
+* `stf-connectors.yaml`
+
+. Update the {OpenStackShort} overcloud. Ensure that you use the `disable-stf.yaml` file early in the list of environment files. By adding `disable-stf.yaml` early in the list, other environment files can override the configuration that would disable the service:
++
+// this one is actually a valid use of subs +quotes. We want the underbars to result in emphasis when generated.
++
+[source,bash,options="nowrap",subs="+quotes"]
+----
+(undercloud) [stack@undercloud-0 ~]$ openstack overcloud deploy _<other_arguments>_
+--templates /usr/share/openstack-tripleo-heat-templates \
+  --environment-file /home/stack/disable-stf.yaml
+  --environment-file _<other_environment_files>_ \
+----