osdocs17086 Configuring Last Level Cache locality for MicroShift

Author: Daniel Chadwick

microshift_configuring/microshift_low_latency/microshift-low-latency.adoc

@@ -19,6 +19,8 @@ include::modules/microshift-install-rpms-low-latency.adoc[leveloffset=+1]
 
 include::modules/microshift-low-latency-config-yaml.adoc[leveloffset=+1]
 
+include::modules/microshift-low-latency-llc-config.adoc[leveloffset=+1]
+
 //additional resources for the config.yaml
 [role="_additional-resources"]
 .Additional resources

modules/microshift-low-latency-llc-config.adoc

@@ -0,0 +1,39 @@
+// Module included in the following assemblies:
+//
+// * microshift_configuring/microshift_low_latency/microshift-low-latency.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="microshift-low-latency-llc-config_{context}"]
+= Configuring Last Level Cache locality for MicroShift
+
+[role="_abstract"] 
+You can configure Last Level Cache (LLC) locality to optimize latency-sensitive workloads. This feature is particularly beneficial for applications running on AMD CPUs, as it enables the CPU manager to align CPUs by their uncore cache (LLC). 
+
+[IMPORTANT]
+====
+Configuring Last Level Cache locality is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production.
+====
+
+To use this feature, you must enable the `CPUManagerPolicyBetaOptions` feature gate and configure the `kubelet` settings in your MicroShift configuration file to prefer aligning CPUs by the uncore cache.
+
+.Procedure
+
+. Open the MicroShift configuration file (`/etc/microshift/config.yaml`) with root privileges.
+
+. Add the following configuration to the file:
++
+.Example `config.yaml` with LLC locality enabled
+[source,yaml]
+----
+api:
+  featureGates:
+    customNoUpgrade:
+      enabled: CPUManagerPolicyBetaOptions
+kubelet:
+  reservedSystemCPUs: "0" 
+  cpuManagerPolicy: static
+  cpuManagerPolicyOptions:
+    prefer-align-cpus-by-uncorecache: "true"
+----
+
+. Save the file and restart the MicroShift service to apply the changes.