TELCODOCS-1731 - Update low latency tuning docs

[aireilly]

Refactoring Low latency tuning assembly into more manageable sections.

Version(s):
openshift-4.14+

Issue:
https://issues.redhat.com/browse/TELCODOCS-1731

Link to docs preview:
https://71797--ocpdocs-pr.netlify.app/openshift-enterprise/latest/scalability_and_performance/low_latency_tuning/cnf-performing-platform-verification-latency-tests.html
https://71797--ocpdocs-pr.netlify.app/openshift-enterprise/latest/scalability_and_performance/low_latency_tuning/cnf-provisioning-low-latency-workloads.html
https://71797--ocpdocs-pr.netlify.app/openshift-enterprise/latest/scalability_and_performance/low_latency_tuning/cnf-tuning-low-latency-nodes-with-perf-profile.html
https://71797--ocpdocs-pr.netlify.app/openshift-enterprise/latest/scalability_and_performance/low_latency_tuning/cnf-understanding-low-latency.html

QE review:

• QE has approved this change.

Note for Peer reviewers:

• This PR might look ominous but it's really not. This is a high priority refactor PR that sets the ground for future content changes. What looks like new content here is in fact content that has been modularized out of parent assemblies with minimal rewrites.
• A lot of the files in the PR are just updated modules with "Module used in..." comments.
• SME comments on content will be actioned in https://issues.redhat.com/browse/TELCODOCS-1733

[ocpdocs-previewbot]

🤖 Fri May 10 08:54:56 - Prow CI generated the docs preview:
https://71797--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

[aireilly]

@MarSik Can you PTAL at this Low latency tuning docs rework. This is based on the suggested changes from you and Ashley some time back. Note though it might looks like there are lots of changes in the PR, the content has not be changed or reworded. Content changes are minimal - mainly just moving stuff around and fixing xrefs..

Start by looking at the preview linked in comment #1 ...

[MarSik]

@aireilly There are still some things to fix

1. Switch the order of Provisioning real-time and low latency workloads and Tuning nodes for low latency with the performance profile . The user should first set up the nodes and then deploy the workloads.

2. Reducing NIC queues using the Node Tuning Operator belongs to the Tuning nodes section

3. There is a whole page about Creating a Performance profile that should be moved to the low latency chapter. Probably to the Tuning nodes sub-chapter.

[MarSik]

4. Upgrading the performance profile to use device interrupt processing and Configuring a node for IRQ dynamic load balancing should be moved from the Workload sub-chapters to the Node tuning sub-chapter. Possibly under a common Interrupt handling topic (together with About support of IRQ affinity setting)

[aireilly]

/retest

[dfitzmau]

/remove-label peer-review-in-progress

/label peer-review-done

[mburke5678]

@aireilly Found a few things. Awesome work here. Much easier to scan and use.

[shajmakh]

LGTM from QE end considering this comment.

[openshift-ci]

@aireilly: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[aireilly]

/cherrypick enterprise-4.15

[aireilly]

/cherrypick enterprise-4.16

[openshift-cherrypick-robot]

@aireilly: #71797 failed to apply on top of branch "enterprise-4.15":

Applying: low latency tuning refactor
Using index info to reconstruct a base tree...
M	_topic_maps/_topic_map.yml
M	installing/installing-preparing.adoc
M	modules/cnf-configure_for_irq_dynamic_load_balancing.adoc
M	modules/cnf-provisioning-real-time-and-low-latency-workloads.adoc
M	modules/cnf-understanding-low-latency.adoc
A	virt/virtual_machines/advanced_vm_management/virt-configuring-cluster-realtime-workloads.adoc
Falling back to patching base and 3-way merge...
CONFLICT (modify/delete): virt/virtual_machines/advanced_vm_management/virt-configuring-cluster-realtime-workloads.adoc deleted in HEAD and modified in low latency tuning refactor. Version low latency tuning refactor of virt/virtual_machines/advanced_vm_management/virt-configuring-cluster-realtime-workloads.adoc left in tree.
Removing scalability_and_performance/cnf-low-latency-tuning.adoc
Removing scalability_and_performance/cnf-create-performance-profiles.adoc
Removing modules/cnf-understanding-workload-hints.adoc
Auto-merging modules/cnf-understanding-low-latency.adoc
Removing modules/cnf-reducing-netqueues-using-nto.adoc
CONFLICT (modify/delete): modules/cnf-provisioning-real-time-and-low-latency-workloads.adoc deleted in low latency tuning refactor and modified in HEAD. Version HEAD of modules/cnf-provisioning-real-time-and-low-latency-workloads.adoc left in tree.
Auto-merging modules/cnf-configure_for_irq_dynamic_load_balancing.adoc
CONFLICT (content): Merge conflict in modules/cnf-configure_for_irq_dynamic_load_balancing.adoc
Removing modules/cnf-about_hyperthreading_for_low_latency_and_real_time_applications.adoc
Auto-merging installing/installing-preparing.adoc
Auto-merging _topic_maps/_topic_map.yml
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
Patch failed at 0001 low latency tuning refactor
When you have resolved this problem, run "git am --continue".
If you prefer to skip this patch, run "git am --skip" instead.
To restore the original branch and stop patching, run "git am --abort".

In response to this:

/cherrypick enterprise-4.15

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[openshift-cherrypick-robot]

@aireilly: new pull request created: #75758

In response to this:

/cherrypick enterprise-4.16

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.