24. Robin Performance Features¶
24.1. Intel Cache Allocation Technology Support for vDU Pods¶
Robin CNP supports the Intel Cache Allocation Technology (CAT) to deploy 4G vDU (Virtual Distributed Unit) Pods for single non-uniform memory access (NUMA) node host for 4G Virtual Network Functions (VNFs) and Cloud-Native Network Functions (CNFs).
The Intel CAT support enables vDUs in a 4G environment to access the CPUs on the host using dedicated cache lines/ways. When you deploy a vDU Pod using Robin CNP, the vDUs get a dedicated number of cache ways configured on the host to access the CPUs.
You can use the following annotation in your Pod YAML file for requesting cache ways from the CPU for vDUs.
robin.runtime.num_cache_ways": "4"
Note
You must use the annotation at the Pod level only.
Whatever CPU set that kubelet allocates for the container, Robin applies the respective Class of Profile (CoS) profile for that CPU set.
Limitations
The annotation requesting for cache ways is supported only for Helm-based applications.
You can create only two vDUs per host.
A Pod must have one replica only.
24.1.1. Configuring CAT support for vDU Pods¶
Configuring your setup to use CAT support for vDU Pods involves:
Creating CAT profiles
Applying the profiles to CPUs.
24.1.2. Create CAT profile (classes) on NUMA node zero¶
To use CAT support on Robin CNP, you must create CAT profiles (classes) on NUMA node zero (0) of your host. After you create classes, you can assign these classes to the CPUs.
Prerequisites
Based on the hardware server type, you need to create 3 classes on NUMA node 0:
0x7 – last 3 caches ways
0x78 – middle 4 caches ways
0x780 -first 4 cache ways
Run the following command to create CAT profiles (classes):
robin-pqos setclass <numa_id> 0=<mask1> 1=<mask2> 2=<mask3>…
Example:
robin-pqos setclass 0 0=0x7 1=0x78 2=0x780
24.1.3. Apply CAT profiles to CPUs¶
You must have the CAT profiles created before applying the profiles to CPUs.
Run the following command to apply the CAT profiles to CPUs:
robin-pqos apply <numa_id> <mask1> <cpuset>
Example:
robin-pqos apply 0 0x7 0,40,1,41
24.1.4. Setting Cache ways in POD YAML file¶
You can use the robin.runtime.num_cache_ways": "4"
annotation to set cache ways in the Pod YAML file.
The following is the sample Pod YAML file with
apiVersion: v1
kind: Pod
metadata:
name: cat1
namespace: default
annotations:
"robin.runtime.num_cache_ways": "4"
spec:
tolerations:
- effect: NoSchedule
key: node-role.kubernetes.io/master
containers:
- name: test
image: robinsys/virtlauncher:centos8
command: ["sleep", "infinity"]
resources:
requests:
cpu: 8
memory: 100Mi
limits:
cpu: 8
memory: 100Mi
24.1.5. View CAT profiles¶
Run the following command to view the CAT profile details:
robin-pqos show