aboutsummaryrefslogtreecommitdiffstats
path: root/docs/report/introduction/environment/sut_conf_1.rst
diff options
context:
space:
mode:
authorpmikus <peter.mikus@protonmail.ch>2022-10-03 14:42:34 +0200
committerPeter Mikus <peter.mikus@protonmail.ch>2022-10-03 14:09:00 +0000
commit14fe52e81c59a5a3558f4f587e56b75e388191dc (patch)
treefda33cb74b18dc0f6dcdde168b1113badeaf5a5b /docs/report/introduction/environment/sut_conf_1.rst
parentc6bfe865e4a62dda2c5e635df53083e909a6558b (diff)
fix(docs): Static content
Signed-off-by: pmikus <peter.mikus@protonmail.ch> Change-Id: I29c2c108cec7badbe302095d5797d39c0d34ad58
Diffstat (limited to 'docs/report/introduction/environment/sut_conf_1.rst')
-rw-r--r--docs/report/introduction/environment/sut_conf_1.rst53
1 files changed, 53 insertions, 0 deletions
diff --git a/docs/report/introduction/environment/sut_conf_1.rst b/docs/report/introduction/environment/sut_conf_1.rst
new file mode 100644
index 0000000000..7f724dd6ea
--- /dev/null
+++ b/docs/report/introduction/environment/sut_conf_1.rst
@@ -0,0 +1,53 @@
+SUT Settings - Linux
+--------------------
+
+System provisioning is done by combination of PXE boot unattented
+install and
+`Ansible <https://www.ansible.com>`_ described in `CSIT Testbed Setup`_.
+
+Linux Boot Parameters
+~~~~~~~~~~~~~~~~~~~~~
+
+- **isolcpus=<cpu number>-<cpu number>** used for all cpu cores apart from
+ first core of each socket used for running VPP worker threads and Qemu/LXC
+ processes
+ https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt
+- **intel_pstate=disable** - [X86] Do not enable intel_pstate as the default
+ scaling driver for the supported processors. Intel P-State driver decide what
+ P-state (CPU core power state) to use based on requesting policy from the
+ cpufreq core. [X86 - Either 32-bit or 64-bit x86]
+ https://www.kernel.org/doc/Documentation/cpu-freq/intel-pstate.txt
+- **nohz_full=<cpu number>-<cpu number>** - [KNL,BOOT] In kernels built with
+ CONFIG_NO_HZ_FULL=y, set the specified list of CPUs whose tick will be stopped
+ whenever possible. The boot CPU will be forced outside the range to maintain
+ the timekeeping. The CPUs in this range must also be included in the
+ rcu_nocbs= set. Specifies the adaptive-ticks CPU cores, causing kernel to
+ avoid sending scheduling-clock interrupts to listed cores as long as they have
+ a single runnable task. [KNL - Is a kernel start-up parameter, SMP - The
+ kernel is an SMP kernel].
+ https://www.kernel.org/doc/Documentation/timers/NO_HZ.txt
+- **rcu_nocbs** - [KNL] In kernels built with CONFIG_RCU_NOCB_CPU=y, set the
+ specified list of CPUs to be no-callback CPUs, that never queue RCU callbacks
+ (read-copy update).
+ https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt
+- **numa_balancing=disable** - [KNL,X86] Disable automatic NUMA balancing.
+- **intel_iommu=enable** - [DMAR] Enable Intel IOMMU driver (DMAR) option.
+- **iommu=on, iommu=pt** - [x86, IA-64] Disable IOMMU bypass, using IOMMU for
+ PCI devices.
+- **nmi_watchdog=0** - [KNL,BUGS=X86] Debugging features for SMP kernels. Turn
+ hardlockup detector in nmi_watchdog off.
+- **nosoftlockup** - [KNL] Disable the soft-lockup detector.
+- **tsc=reliable** - Disable clocksource stability checks for TSC.
+ [x86] reliable: mark tsc clocksource as reliable, this disables clocksource
+ verification at runtime, as well as the stability checks done at bootup.
+ Used to enable high-resolution timer mode on older hardware, and in
+ virtualized environment.
+- **hpet=disable** - [X86-32,HPET] Disable HPET and use PIT instead.
+
+Hugepages Configuration
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Huge pages are managed via sysctl configuration located in
+`/etc/sysctl.d/90-csit.conf` on each testbed. Default huge page size is 2M.
+The exact amount of huge pages depends on testbed. All the values are defined
+in `Ansible inventory - hosts` files.