Docs: Update report sections
[csit.git] / docs / report / introduction / test_environment_sut_conf_1.rst
1 SUT Settings - Linux
2 --------------------
3
4 System provisioning is done by combination of PXE boot unattented
5 install and
6 `Ansible <https://www.ansible.com>`_ described in `CSIT Testbed Setup`_.
7
8 Below a subset of the running configuration:
9
10 1. Ubuntu 18.04.x LTS
11
12 ::
13
14     $ lsb_release -a
15     No LSB modules are available.
16     Distributor ID: Ubuntu
17     Description:    Ubuntu 18.04.3 LTS
18     Release:        18.04
19     Codename:       bionic
20
21 Linux Boot Parameters
22 ~~~~~~~~~~~~~~~~~~~~~
23
24 - **isolcpus=<cpu number>-<cpu number>** used for all cpu cores apart from
25   first core of each socket used for running VPP worker threads and Qemu/LXC
26   processes
27   https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt
28 - **intel_pstate=disable** - [X86] Do not enable intel_pstate as the default
29   scaling driver for the supported processors. Intel P-State driver decide what
30   P-state (CPU core power state) to use based on requesting policy from the
31   cpufreq core. [X86 - Either 32-bit or 64-bit x86]
32   https://www.kernel.org/doc/Documentation/cpu-freq/intel-pstate.txt
33 - **nohz_full=<cpu number>-<cpu number>** - [KNL,BOOT] In kernels built with
34   CONFIG_NO_HZ_FULL=y, set the specified list of CPUs whose tick will be stopped
35   whenever possible. The boot CPU will be forced outside the range to maintain
36   the timekeeping. The CPUs in this range must also be included in the
37   rcu_nocbs= set. Specifies the adaptive-ticks CPU cores, causing kernel to
38   avoid sending scheduling-clock interrupts to listed cores as long as they have
39   a single runnable task. [KNL - Is a kernel start-up parameter, SMP - The
40   kernel is an SMP kernel].
41   https://www.kernel.org/doc/Documentation/timers/NO_HZ.txt
42 - **rcu_nocbs** - [KNL] In kernels built with CONFIG_RCU_NOCB_CPU=y, set the
43   specified list of CPUs to be no-callback CPUs, that never queue RCU callbacks
44   (read-copy update).
45   https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt
46 - **numa_balancing=disable** - [KNL,X86] Disable automatic NUMA balancing.
47 - **intel_iommu=enable** - [DMAR] Enable Intel IOMMU driver (DMAR) option.
48 - **iommu=on, iommu=pt** - [x86, IA-64] Disable IOMMU bypass, using IOMMU for
49   PCI devices.
50 - **nmi_watchdog=0** - [KNL,BUGS=X86] Debugging features for SMP kernels. Turn
51   hardlockup detector in nmi_watchdog off.
52 - **nosoftlockup** - [KNL] Disable the soft-lockup detector.
53 - **tsc=reliable** - Disable clocksource stability checks for TSC.
54   [x86] reliable: mark tsc clocksource as reliable, this disables clocksource
55   verification at runtime, as well as the stability checks done at bootup.
56   Used to enable high-resolution timer mode on older hardware, and in
57   virtualized environment.
58 - **hpet=disable** - [X86-32,HPET] Disable HPET and use PIT instead.
59
60 Hugepages Configuration
61 ~~~~~~~~~~~~~~~~~~~~~~~
62
63 Huge pages are namaged via sysctl configuration located in
64 `/etc/sysctl.d/90-csit.conf` on each testbed. Default huge page size is 2M.
65 The exact amount of huge pages depends on testbed. All the values are defined
66 in `Ansible inventory - hosts` files.