<?xml version="1.0"?>

<!DOCTYPE flagsdescription SYSTEM "http://www.spec.org/dtd/cpuflags2.dtd">

<flagsdescription>

<filename>Fusionstor-Platform-Flags-Intel-ICX-rev5</filename>

<title>Platform Settings for Fusiontor ICX server systems</title>

<os_tuning>
<![CDATA[

<p><b>OS Tuning</b></p>

<p><b>setterm</b>:</p>
<p>Used to disable screen blanking on text console:</p>
<ul>
<li>"setterm -powersave off -blank 0"</li>
</ul>

<p><b>ulimit</b>:</p>
<p>Used to set user limits of system-wide resources. Provides control over resources available to the shell and processes started by it. Some common ulimit commands may include:</p>
<ul>
<li><b>ulimit -s [n | unlimited]</b>: Set the stack size to <b>n</b> kbytes, or <b>unlimited</b> to allow the stack size to grow without limit.</li>
<li><b>ulimit -l (number)</b>: Set the maximum size that can be locked into memory.</li>
</ul>

<p><b>Disabling Linux services</b>:</p>
<p>Certain Linux services may be disabled to minimize tasks that may consume CPU cycles.</p>

<p><b>irqbalance</b>:</p>
<p>Disabled through "service irqbalance stop". Depending on the workload involved, the irqbalance service reassigns various IRQ's to system CPUs. Though this service might help in some situations, disabling it can also help environments which need to minimize or eliminate latency to more quickly respond to events.</p>

<p><b>Performance Governors (Linux)</b>:</p>
<p>In-kernel CPU frequency governors are pre-configured power schemes for the CPU. The CPUfreq governors use P-states to change frequencies and lower power consumption. The dynamic governors can switch between CPU frequencies, based on CPU utilization to allow for power savings while not sacrificing performance.</p>
<p>Other options beside a generic performance governor can be set, such as the perf-bias:</p>
<p><b>--perf-bias, -b</b></p>
<p>On supported Intel processors, this option sets a register which allows the cpupower utility (or other software/firmware) to set a policy that controls the relative importance of performance versus energy savings to the processor. The range of valid numbers is 0-15, where 0 is maximum performance and 15 is maximum energy efficiency.</p>
<p>The processor uses this information in model-specific ways when it must select trade-offs between performance and energy efficiency. This policy hint does not supersede Processor Performance states (P-states) or CPU Idle power states (C-states), but allows software to have influence where it would otherwise be unable to express a preference.</p>
<p>On many Linux systems one can set the perf-bias for all CPUs through the cpupower utility with one of the following commands:</p>
<ul>
<li>"cpupower frequency-set -g performance"</li>
<li>"cpupower -c all set -b 0"</li>
<li>"cpupower -c all set --perf-bias 0"</li>
<li>"cpupower set -b 0"</li>
</ul>

<p><b>Tuning Kernel parameters</b>:</p>
<p>The following Linux Kernel parameters were tuned to better optimize performance of some areas of the system:</p>
<ul>
<li><b>dirty_background_ratio</b>: Set through "echo 40 > /proc/sys/vm/dirty_background_ratio". This setting can help Linux disk caching and performance by setting the percentage of system memory that can be filled with dirty pages.</li>
<li><b>dirty_ratio</b>: Set through "echo 40 > /proc/sys/vm/dirty_ratio". This setting is the absolute maximum amount of system memory that can be filled with dirty pages before everything must get committed to disk.</li>
<li><b>swappiness</b>: The swappiness value can range from 1 to 100. A value of 100 will cause the kernel to swap out inactive processes frequently in favor of file system performance, resulting in large disk cache sizes. A value of 1 tells the kernel to only swap processes to disk if absolutely necessary. This can be set through a command like "echo 1 > /proc/sys/vm/swappiness"</li>
<li><b>ksm/sleep_millisecs</b>: Set through "echo 200 > /sys/kernel/mm/ksm/sleep_millisecs". This setting controls how many milliseconds the ksmd (KSM daeomn) should sleep before the next scan.</li>
<li><b>khugepaged/scan_sleep_millisecs</b>: Set through "echo 50000 > /sys/kernel/mm/transparent_hugepage/khugepaged/scan_sleep_millisecs". This setting controls how many milliseconds to wait in khugepaged is there is a hugepage allocation failure to throttle the next allocation attempt.</li>
<li><b>numa_balancing</b>: Disabled through "echo 0 > /proc/sys/kernel/numa_balancing". This feature will automatically migrate data on demand so memory nodes are aligned to the local CPU that is accessing data. Depending on the workload involved, enabling this can boost the performance if the workload performs well on NUMA hardware. If the workload is statically set to balance between nodes, then this service may not provide a benefit.</li>
<li><b>Zone Reclaim Mode</b>: Zone reclaim allows the reclaiming of pages from a zone if the number of free pages falls below a watermark even if other zones still have enough pages available. Reclaiming a page can be more beneficial than taking the performance penalties that are associated with allocating a page on a remote zone, especially for NUMA machines. To tell the kernel to free local node memory rather than grabbing free memory from remote nodes, use a command like "echo 1 > /proc/sys/vm/zone_reclaim_mode"</li>
<li><b>max_map_count-n</b>: The maximum number of memory map areas a process may have. Memory map areas are used as a side-effect of calling malloc, directly by mmap and mprotect, and also when loading shared libraries.</li>
</ul>

<p><b>Transparent Huge Pages (THP)</b>:</p>
<p>THP is an abstraction layer that automates most aspects of creating, managing, and using huge pages. THP is designed to hide much of the complexity in using huge pages from system administrators and developers, as normal huge pages must be assigned at boot time, can be difficult to manage manually, and often require significant changes to code in order to be used effectively. Transparent Hugepages increase the memory page size from 4 kilobytes to 2 megabytes. Transparent Hugepages provide significant performance advantages on systems with highly contended resources and large memory workloads. If memory utilization is too high or memory is badly fragmented which prevents hugepages being allocated, the kernel will assign smaller 4k pages instead. Most recent Linux OS releases have THP enabled by default.</p>

<p><b>Linux Huge Page settings</b>:</p>
<p>If you need finer control and manually set the Huge Pages you can follow the below steps:</p>
<ul>
<li>Create a mount point for the huge pages: "mkdir /mnt/hugepages"</li>
<li>The huge page file system needs to be mounted when the systems reboots. Add the following to a system boot configuration file before any services are started: "mount -t hugetlbfs nodev /mnt/hugepages"</li>
<li>Set vm/nr_hugepages=N in your /etc/sysctl.conf file where N is the maximum number of pages the system may allocate.</li>
<li>Reboot to have the changes take effect.</li>
</ul>
<p>Note that further information about huge pages may be found in your Linux documentation file: /usr/src/linux/Documentation/vm/hugetlbpage.txt</p>

]]>
</os_tuning>

<firmware>
<![CDATA[

<p><b>Firmware Settings</b></p>

<p><b>Power Policy Quick Settings: (Default = Best Performance)</b></p>
<p>This BIOS option controls the performance or power save setting, user can use this item to change it. Best performance can maximize the performance of the server. Energy efficiency can maximize the power efficiency of the server.</p>
<p>Values for this BIOS setting can be:</p>
<ul>
<li><b>Standard</b>: BIOS default setting.</li>
<li><b>Best Performance</b>: Maximize the performance of the server.</li>
<li><b>Energy Efficient</b>: Maximize the power efficiency of the server.</li>
</ul>

<p><b>Link Frequency (Default = Auto):</b></p>
<p>Selects the UPI link frequency. Values for this BIOS option can be:</p>
<ul>
<li><b>9.6GT/s</b></li>
<li><b>10.4GT/s</b></li>
<li><b>11.2GT/s</b></li>
<li><b>Auto</b></li>
</ul>

<p><b>SNC (Sub NUMA) (Default = Disabled):</b></p>
<p>SNC breaks up the last-level-cache (LLC) into disjoint clusters based on address range, with each cluster bound to a subset of the memory controllers in the system. SNC improves average latency to the LLC and memory. SNC is a replacement for the cluster on die (COD) feature found in previous processor families. For a multi-socketed system, all SNC clusters are mapped to unique NUMA domains. Values for this BIOS option can be:</p>
<ul>
<li><b>Disabled</b>: The LLC is treated as one cluster when this option is disabled</li>
<li><b>Enabled SNC2 (2-Clusters): Each socket is divided into two groups.</li>
<li><b>Enabled SNC4 (4-Clusters): Each socket is divided into four groups.</li>
</ul>

<p><b>Stale Atos (Default = Auto):</b></p>
<p>The in-memory directory has three states: invalid (I), snoopAll (A), and shared (S). Invalid (I) state means the data is clean and does not exist in any other socket`s cache. The snoopAll (A) state means the data may exist in another socket in exclusive or modified state. Shared (S) state means the data is clean and may be shared across one or more socket`s caches. When doing a read to memory, if the directory line is in the A state we must snoop all the other sockets because another socket may have the line in modified state. If this is the case, the snoop will return the modified data. However, it may be the case that a line is read in A state and all the snoops come back a miss. This can happen if another socket read the line earlier and then silently dropped it from its cache without modifying it. Values for this BIOS option can be:</p>
<ul>
<li><b>Disabled</b>: Disabling this option allows the feature to process memory directories as described above.</li>
<li><b>Enabled</b>: In the situation where a line in A state returns only snoop misses, the line will transition to S state. That way, subsequent reads to the line will encounter it in S state and not have to snoop, saving latency and snoop bandwidth.</li>
<li><b>Auto</b>: Means if system detect AEP DIMM(Barlow PASS), this setting would be enabled, othrerwise, this setting would be disabled.</li>
</ul>
<p>Stale Atos may be beneficial in a workload where there are many cross-socket reads.</p>

<p><b>LLC dead line alloc (Default = Enabled):</b></p>
<p>In the Skylake cache scheme, mid-level cache (MLC) evictions are filled into the last level cache (LLC). If a line is evicted from the MLC to the LLC, the Skylake core can flag the evicted MLC lines as "dead". This means that the lines are not likely to be read again. This option allows dead lines to be dropped and never fill the LLC if the option is disabled. Values for this BIOS option can be:</p>
<ul>
<li><b>Disabled</b>: Disabling this option can save space in the LLC by never filling dead lines into the LLC. This can and prevent useful data from being evicted.</li>
<li><b>Enabled</b>: Opportunistically fill dead lines in LLC, if space is available.</li>
<li><b>Auto</b>: Means enabled by default.</li>
</ul>

<p><b>Memory Frequency (Default = Auto):</b></p>
<p>Configures the maximum memory frequency. If Enforce POR is disabled, user will be able to run at higher frequencies than the memory support (limited by processor support). Values for this BIOS option can be:</p>
<ul>
<li><b>Highest Speed</b></li>
<li><b>Auto</b></li>
</ul>

<p><b>Patrol Scrub (Default = Disable):</b></p>
<p>When enabled, Memory Patrol Scrubbing corrects memory soft errors so that, over the length of the system runtime, the risk of producing multi-bit and uncorrectable errors is reduced. Values for this BIOS option can be:</p>
<ul>
<li><b>Disable</b></li>
<li><b>Enable</b></li>
<li><b>Enable at End of POST</b></li>
</ul> 	

<p><b>Intel VT-d for Directed I/O  (Default = Enable):</b></p>
<p>Intel Virtualization Technology for Directed I/O (Intel VT-d) allows addresses in incoming I/O device memory transactions to be remapped to different host addresses. Values for this BIOS option can be:</p>
<ul>
<li><b>Disable</b></li>
<li><b>Enable</b></li>
<li><b>Enable at End of POST</b></li>
</ul> 

<p><b>CPU C6 Report  (Default = Disable):</b></p>
<p>This BIOS feature reporting C6 (ACPI C3)  to the operating system. Values for this BIOS option can be:</p>
<ul>
<li><b>Disable</b></li>
<li><b>Enable</b></li>
<li><b>Auto</b></li>
</ul> 


<p><b>First created Nov 3, 2022.</b></p>
<p><b>Last Updated Dec 2024.</b></p>
]]>
</firmware>

</flagsdescription>
