1807 report: added HW calibration sections to test_environment plus editing nits.
[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. Xeon Haswell - Ubuntu 16.04.1 LTS
11
12 ::
13
14     $ lsb_release -a
15     No LSB modules are available.
16     Distributor ID:     Ubuntu
17     Description:        Ubuntu 16.04.1 LTS
18     Release:    16.04
19     Codename:   xenial
20
21 2. Xeon Skylake - Ubuntu 18.04 LTS
22
23 ::
24
25     $ lsb_release -a
26     No LSB modules are available.
27     Distributor ID: Ubuntu
28     Description:    Ubuntu 18.04 LTS
29     Release:        18.04
30     Codename:       bionic
31
32 Linux Boot Parameters
33 ~~~~~~~~~~~~~~~~~~~~~
34
35 - **isolcpus=<cpu number>-<cpu number>** used for all cpu cores apart from
36   first core of each socket used for running VPP worker threads and Qemu/LXC
37   processes
38   https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt
39 - **intel_pstate=disable** - [X86] Do not enable intel_pstate as the default
40   scaling driver for the supported processors. Intel P-State driver decide what
41   P-state (CPU core power state) to use based on requesting policy from the
42   cpufreq core. [X86 - Either 32-bit or 64-bit x86]
43   https://www.kernel.org/doc/Documentation/cpu-freq/intel-pstate.txt
44 - **nohz_full=<cpu number>-<cpu number>** - [KNL,BOOT] In kernels built with
45   CONFIG_NO_HZ_FULL=y, set the specified list of CPUs whose tick will be stopped
46   whenever possible. The boot CPU will be forced outside the range to maintain
47   the timekeeping. The CPUs in this range must also be included in the
48   rcu_nocbs= set. Specifies the adaptive-ticks CPU cores, causing kernel to
49   avoid sending scheduling-clock interrupts to listed cores as long as they have
50   a single runnable task. [KNL - Is a kernel start-up parameter, SMP - The
51   kernel is an SMP kernel].
52   https://www.kernel.org/doc/Documentation/timers/NO_HZ.txt
53 - **rcu_nocbs** - [KNL] In kernels built with CONFIG_RCU_NOCB_CPU=y, set the
54   specified list of CPUs to be no-callback CPUs, that never queue RCU callbacks
55   (read-copy update).
56   https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt
57 - **numa_balancing=disable** - [KNL,X86] Disable automatic NUMA balancing.
58 - **intel_iommu=enable** - [DMAR] Enable Intel IOMMU driver (DMAR) option.
59 - **iommu=on, iommu=pt** - [x86, IA-64] Disable IOMMU bypass, using IOMMU for
60   PCI devices.
61 - **nmi_watchdog=0** - [KNL,BUGS=X86] Debugging features for SMP kernels. Turn
62   hardlockup detector in nmi_watchdog off.
63 - **nosoftlockup** - [KNL] Disable the soft-lockup detector.
64 - **tsc=reliable** - Disable clocksource stability checks for TSC.
65   [x86] reliable: mark tsc clocksource as reliable, this disables clocksource
66   verification at runtime, as well as the stability checks done at bootup.
67   Used to enable high-resolution timer mode on older hardware, and in
68   virtualized environment.
69 - **hpet=disable** - [X86-32,HPET] Disable HPET and use PIT instead.
70
71 Applied Boot Cmdline
72 ~~~~~~~~~~~~~~~~~~~~
73
74 1. Xeon Haswell - Ubuntu 16.04.1 LTS
75
76 ::
77
78     $ cat /proc/cmdline
79     BOOT_IMAGE=/vmlinuz-4.4.0-72-generic root=UUID=35ea11e4-e44f-4f67-8cbe-12f09c49ed90 ro isolcpus=1-17,19-35 nohz_full=1-17,19-35 rcu_nocbs=1-17,19-35 intel_pstate=disable console=tty0 console=ttyS0,115200n8
80
81 2. Xeon Skylake - Ubuntu 18.04 LTS
82
83 ::
84
85     $ cat /proc/cmdline
86     BOOT_IMAGE=/vmlinuz-4.15.0-23-generic root=UUID=3fa246fd-1b80-4361-bb90-f339a6bbed51 ro isolcpus=1-27,29-55,57-83,85-111 nohz_full=1-27,29-55,57-83,85-111 rcu_nocbs=1-27,29-55,57-83,85-111 numa_balancing=disable intel_pstate=disable intel_iommu=on iommu=pt nmi_watchdog=0 audit=0 nosoftlockup processor.max_cstate=1 intel_idle.max_cstate=1 hpet=disable tsc=reliable mce=off console=tty0 console=ttyS0,115200n8
87
88